Bezeichnung
Listtree.GetEntry -- gibt den Baumeintrag zurück
Übersicht
found, table = mui.DoMethod(id, "GetEntry", node, position, flags$)
Beschreibung
Ruft einen anderen Knoten in Bezug auf die angegebene Liste oder den angegebenen Knoten ab. Mit dieser Methode können Sie die gesamte Baumliste durchlaufen. Siehe unten für ein Beispiel.

node gibt den Knoten an, mit dem ein anderer Knoten gefunden wird. Dies kann auch ein Listenknoten sein, wenn sich die Position a auf eine Liste bezieht. Im Gegensatz zu allen anderen Methoden oder Attributen der Listtree-Klasse (Baumlisten) darf node NICHT ein Zeichenketten-Indikator sein, sondern ein spezieller Wert, der von dieser Methode oder von Listtree.FindName im Feld MuiID der Rückgabetabelle zurückgegeben wird (siehe unten). Alternativ kann es einer der folgenden speziellen Werte sein:

Root
Die Stamm-Liste wird verwendet.

Active
Die Liste mit dem aktiven Eintrag wird verwendet.

position gibt die Anzahl der Knoten der unter node angegebenen Liste oder einen der folgenden Sonderwerte an:

Head
Der Kopf der Liste in node wird zurückgegeben.

Tail
Das Ende der Liste wird zurückgegeben.

Active
Der aktive Knoten wird zurückgegeben.

Next
Der nächste Knoten nach dem Baumknoten node wird zurückgegeben.

Previous
Der Knoten vor dem Baumknoten node wird zurückgegeben.

Parent
Der Listenknoten des node ist der übergeordnete Knoten.

flags$ können eine Kombination der folgenden Optionen sein:

SameLevel
Nur Knoten auf derselben Ebene sind betroffen.

Visible
Die Position wird nur für sichtbare Einträge gezählt.

Wenn Sie mehrere der obigen Flags angeben, müssen Sie sie mit einem Semikolon trennen, z.B. "SameLevel; Visible".

Diese Methode gibt zwei Werte zurück: Der erste Rückgabewert found ist ein boolesches Flag, das anzeigt, ob ein Knoten gefunden wurde oder nicht. Wenn der erste Rückgabewert True ist, ist der zweite Rückgabewert table eine Tabelle mit folgenden initialisierten Feldern:

Name
Name des Baumknotens.

Node
True, wenn der gefundene Eintrag ein Knoten ist, False, wenn es ein Blatt ist.

ID
Zeichenketten-Objekt-ID dieses Baumknotens.

MuiID
Interne MUI-ID dieses Baumknotens. Dies ist die einzige ID, die Sie im Argument node dieser Methode übergeben dürfen. Das Übergeben von Standard-Zeichenketten-Objekt-IDs ist bei dieser Methode nicht zulässig. Sie können diesen Wert für nachfolgende Aufrufe von Listtree.GetEntry im Argument node verwenden. Siehe oben für weitere Informationen und unten für ein Beispiel.

Eingaben
id
ID des Baumlisten-Objekts
node
Spezieller Knotenindikator, der von dieser Methode zurückgegeben wird
position
Index des Eintrags
flags$
Kombination der zu verwendenden Flags (siehe oben)
Rückgabewerte
found
Boolesches Flag, das anzeigt, ob ein Eintrag gefunden wurde oder nicht
table
Tabelle mit Informationen zum gefundenen Eintrag
Beispiel
Function p_DumpListTree(id$, node, indent)
   Local found, t = mui.DoMethod(id$, "GetEntry", node, "Head", "")
   While found = True
      If indent > 0
         DebugPrint(RepeatStr(" ", indent) ..
             IIf(t.Node = True, "+", "") .. t.name)
      Else
         DebugPrint(IIf(t.Node = True, "+", "") .. t.name)
      EndIf
      If t.Node = True Then p_DumpListTree(id$, t.muiid, indent + 4)
      found, t = mui.DoMethod(id$, "GetEntry", t.muiid, "Next", "")
    Wend
EndFunction

p_DumpListTree("mylisttree", "root", 0)
Der obige Code zeigt, wie der komplette Inhalt einer Baumliste unter Beibehaltung seiner Struktur ausgegeben wird.

Navigation zeigen