Condizioni di notifica
Evento notificato dall'albero quando un nodo viene espanso per la prima volta dall'apertura della videata o dall'ultima chiamata alla procedura RefreshNodes dell'albero. Questo può avvenire nei seguenti casi:
- Il nodo è stato espanso dall'utente che ha premuto l'icona + accanto al nodo
- Il programma ha effettuato una chiamata alla procedura ExpandNode dell'albero
Utilizzo consigliato
L'evento di OnExpandNode può essere utilizzato per aggiornare le parti dell'interfaccia utente che dipendono dallo stato di espansione dei nodi.
Argomenti
HashKey | E' una stringa che identifica il nodo che è stato espanso per la prima volta. Per sapere cosa è un HashKey puoi leggere il paragrafo "Identificazione dei nodi: la proprietà HashKey" dell'articolo Nodi dell'albero. |
Cancel | E' un parametro di uscita booleano. Se lo si imposta a True si impedisce l'espansione del nodo. |
Esempio di codice
// *****************************
// Fired when a node is expanded
// *****************************
event AlberoCategorie.Categorie.OnExpandNode(
string SourceHash // Hash Code of the node that has been expanded
inout boolean Cancel // Set to True to cancel further processing (if FAL...
)
{
string NomeNodoEspanso = "" //
//
// Recupero il nome del nodo espanso
NomeNodoEspanso := GetNodeName(SourceHash)
//
// Inserisco un nuovo evento
insert values into Eventi
set Descrizione := FormatMessage(MSG Espanso Prima Volta,
NomeNodoEspanso, ??, ??, ??, ??)
set AppTick := ClickCounter()
}
// Fired when a node is expanded
// *****************************
event AlberoCategorie.Categorie.OnExpandNode(
string SourceHash // Hash Code of the node that has been expanded
inout boolean Cancel // Set to True to cancel further processing (if FAL...
)
{
string NomeNodoEspanso = "" //
//
// Recupero il nome del nodo espanso
NomeNodoEspanso := GetNodeName(SourceHash)
//
// Inserisco un nuovo evento
insert values into Eventi
set Descrizione := FormatMessage(MSG Espanso Prima Volta,
NomeNodoEspanso, ??, ??, ??, ??)
set AppTick := ClickCounter()
}
- Attenzione: L'evento viene notificato solo se il contenuto dell'albero non è document-oriented ma proviene direttamente da query su database.
- Se il parametro ActivateOnExpand dell'albero è True il sistema, dopo aver notificato l'evento di OnExpandNode, attiva il nodo.
Ultima modifica: 25/10/2016 / Validità: da 6.5.2680