Scopo
Restituisce l'HashKey dell'i-esimo nodo figlio del nodo identificato tramite HashKey. Questa funzione potrebbe restituire il valore EmptyString qualora il nodo non sia mai stato espanso (e quindi il sistema non abbia mai avuto necessità di eseguire la query necessaria a caricare i figli del nodo stesso).
Sintassi
String h = "" // Hashkey del nodo
//
// HashKey del secondo figlio del nodo
h := Albero.GetChildrenNode(hashkey, index)
//
// HashKey del secondo figlio del nodo
h := Albero.GetChildrenNode(hashkey, index)
Argomenti
Hash Key | E' una stringa che identifica il nodo di cui è richiesto il numero di figli. Per sapere cosa è un HashKey puoi leggere il paragrafo "Identificazione dei nodi: la proprietà HashKey" dell'articolo Nodi dell'albero. |
Index | E' un numero intero che identifica quale figlio è richiesto. Deve essere un valore compreso tra 0 (primo figlio) ed il risultato della funzione GetChildrenNodeCount - 1 (ultimo figlio). |
Valore di ritorno
Restituisce l'HashKey dell'i-esimo nodo figlio del nodo identificato dall'HashKey fornito. Per sapere cosa è un HashKey puoi leggere il paragrafo "Identificazione dei nodi: la proprietà HashKey" dell'articolo Nodi dell'albero.
Esempio di codice
// ******************************************
// Seleziona i figli della categoria corrente
// ******************************************
public void AlberoCategorie.SelezionaFigli()
{
int i = 0 //
//
// Inizio espandendo il nodo richiesto (così vedo selezionare i figli)
Categorie.ExpandNode(CAT +c ToString(Categorie.ID), ??, ??)
//
// Deseleziono tutto
Categorie.SelectAll(ZERO)
//
// Giro su tutti i nodi figli del nodo identificato dall'hashcode indicato
i := ZERO
while i < Categorie.GetChildrenNodeCount(CAT +c ToString(Categorie.ID))
{
string h = "" // Hash Code del nodo
//
// Recupero l'hashcode dell'i-esimo figlio
h := Categorie.GetChildrenNode(CAT +c ToString(Categorie.ID), i)
//
// Seleziono il nodo
Categorie.SelectNode(h, True)
//
i := i + ONE
}
}
// Seleziona i figli della categoria corrente
// ******************************************
public void AlberoCategorie.SelezionaFigli()
{
int i = 0 //
//
// Inizio espandendo il nodo richiesto (così vedo selezionare i figli)
Categorie.ExpandNode(CAT +c ToString(Categorie.ID), ??, ??)
//
// Deseleziono tutto
Categorie.SelectAll(ZERO)
//
// Giro su tutti i nodi figli del nodo identificato dall'hashcode indicato
i := ZERO
while i < Categorie.GetChildrenNodeCount(CAT +c ToString(Categorie.ID))
{
string h = "" // Hash Code del nodo
//
// Recupero l'hashcode dell'i-esimo figlio
h := Categorie.GetChildrenNode(CAT +c ToString(Categorie.ID), i)
//
// Seleziono il nodo
Categorie.SelectNode(h, True)
//
i := i + ONE
}
}
- Se il nodo non è mai stato espanso dall'apertura della videata (o dall'ultimo refresh del contenuto dell'albero) la funzione restituisce il valore EmptyString.
- Se il parametro Index è superiore alla funzione GetChildrenNodeCount la funzione potrebbe generare un'eccezione.
Ultima modifica: 28/11/2022 / Validità: da 6.5.2680