eventoCondizioni di notifica
Evento notificato dall'albero quando cambia lo stato di selezione di un nodo in un albero che abbia la Multi-selezione attivata. Tale evento viene notificato unicamente se l'utente ha effettivamente cliccato sul check-box della multi-selezione e non se il programma ha selezionato il documento collegato al nodo mediante la proprietà Selected.
Utilizzo consigliato
L'evento di OnChangeSelectionDoc può essere utilizzato per aggiornare le parti dell'interfaccia utente che dipendono dallo stato di selezione dei nodi. Può anche essere utilizzato per selezionare altri nodi in conseguenza della selezione effettuata dall'utente.
Argomenti
| Documento | E' il documento che è stato selezionato o deselezionato. Il valore del parametro è derivato dalla libreria IDDocument. |
| Selezionato | E' un valore booleano che indica se il nodo è stato selezionato o deselezionato. |
| Cancel | E' un parametro di uscita booleano. Se lo si imposta a True si impedisce la selezione del nodo. |
| Final | E' un valore booleano introdotto a partire dalla versione 7.1.3300. L'evento OnChangeSelection viene chiamato per ogni nodo per cui cambia lo stato di selezionato più una volta al termine dell'operazione. Durante quest'ultima chiamata il parametro Final vale True. |
Esempio di codice
// *************************************************************************
// Fired when a user selects a document using the Multiple Selection feature
// *************************************************************************
event AlberoDO.Documenti.OnChangeSelectionDoc(
IDDocument Document // Source document that has been expanded
boolean Selected // True if the node has been selected
inout boolean Cancel // Set to TRUE to cancel the selection
)
{
OggettoAlbero oa = null //
//
oa := OggettoAlbero.Cast(Document)
//
// Inserisco l'evento
insert values into EventiDO
set Descrizione := FormatMessage(MSG Oggetto Stato, oa.Nome, If(Selected, selezionato, deselezionato), ??, ??, ??)
set AppTick := ClickCounter()
}
// Fired when a user selects a document using the Multiple Selection feature
// *************************************************************************
event AlberoDO.Documenti.OnChangeSelectionDoc(
IDDocument Document // Source document that has been expanded
boolean Selected // True if the node has been selected
inout boolean Cancel // Set to TRUE to cancel the selection
)
{
OggettoAlbero oa = null //
//
oa := OggettoAlbero.Cast(Document)
//
// Inserisco l'evento
insert values into EventiDO
set Descrizione := FormatMessage(MSG Oggetto Stato, oa.Nome, If(Selected, selezionato, deselezionato), ??, ??, ??)
set AppTick := ClickCounter()
}
- Questo evento viene notificato unicamente se è stata attivata la multi-selezione dei nodi mediante il parametro MultipleSelection.
- Attenzione: L'evento viene notificato solo se il contenuto dell'albero è document-oriented.
- Questo evento non viene notificato se lo stato di selezione viene modificato mediante la modifica della proprietà Selected del documento.
- Se il parametro Active dell'albero è True subito dopo aver cliccato sul check-box il browser informa il server dell'avvenuta selezione o deselezione.
- Se il parametro Cancel non viene impostato a True il sistema prosegue valorizzando la proprietà Selected del documento. Se invece il parametro Cancel viene impostato a True il documento non viene selezionato.
- A partire dalla versione 7.1.3300 l'evento viene notificato una volta per ogni nodo che è stata selezionato o deselezionato, più una volta al termine della modifica della selezione. Quest'ultima fase può essere usata per aggiornare l'albero o agire sull'intera selezione.
Ultima modifica: 28/11/2022 / Validità: da 6.5.2680