Bezeichnung
Treeview.GetEntry -- ermittelt Informationen über den Baumeintrag
Übersicht
found, table = moai.DoMethod(id, "GetEntry", item, position)
Beschreibung
Ermittelt Informationen über einen Baumeintrag. Der Baumeintrag kann entweder als absoluter Index oder auch relativ zu einem bestimmten Knoten oder Blatt angegeben werden. So können Sie den gesamten Baum durchqueren. Siehe unten für ein Beispiel.

item gibt das Baumelement an, das als Referenzpunkt verwendet werden soll. Dies kann ein Knoten oder ein Blatt sein. Beachten Sie, dass item im Gegensatz zu allen anderen Methoden oder Attributen der Treeview-Klasse kein Zeichenketten-Identifikator, sondern ein spezieller Wert sein muss, der von dieser Methode im Feld UID (siehe unten) zurückgegeben oder durch Abfragen von Treeviewleaf.UID oder Treeviewnode.UID für ein Objekt abgerufen wird. Alternativ kann es einer der folgenden speziellen Werte sein:

Root
Verwendet den Wurzelknoten.

Active
Verwendet das aktive Element.

position kann entweder eine Zahl oder ein spezieller Wert sein. Die Übergabe einer Nummer wird nur unterstützt, wenn das angegebene item ein Knoten ist. In diesem Fall gibt die Zahl den Index des Elementes an, über das Sie Informationen erhalten möchten, beginnend bei 0, d.h. die Übergabe von 5 würde hier Informationen über das sechste Element des in item übergebenen Knotens zurückgeben. Alternativ können Sie die folgenden Sonderwerte in position übergeben:

Head
Gibt Informationen über das erste Element des Knotens zurück.

Tail
Gibt Informationen über das letzte Element des Knotens zurück.

Active
Gibt Informationen über das aktive Element zurück.

Next
Gibt den nächsten Eintrag im Baum nach item zurück.

Previous
Gibt den vorherigen Eintrag im Baum vor item zurück.

Parent
Gibt Informationen über den übergeordneten Objektteil von item zurück.

Diese Methode gibt zwei Werte zurück: Der erste Rückgabewert found ist ein boolesches Flag, das angibt, ob ein Element gefunden wurde oder nicht. Wenn der erste Rückgabewert True ist, ist der zweite Rückgabewert table eine Tabelle, bei dem folgende Felder initialisiert sind:

Items
Dies ist eine Tabelle, die die Einträge für alle Spalten dieses Baum-Eintrags enthält. Beachten Sie, dass wenn der Eintrag ein Knoten ist, diese Tabelle nur einen Eintrag enthält, da sich Knoten nicht über mehrere Spalten erstrecken können.

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

ID
Zeichenkette-Objekt-Identifikator dieses Baumeintrags.

UID
Interne ID dieses Baumeintrags. Dies ist die einzige ID, die Sie im Argument node dieser Methode übergeben dürfen. Die Übergabe von Standard-Zeichenketten-Objekt-Identifikatoren ist bei dieser Methode nicht erlaubt. Sie können diesen Wert für nachfolgende Aufrufe von Treeview.GetEntry im Argument node verwenden. Siehe oben für weitere Informationen und unten für ein Beispiel. Sie können UIDs auch erhalten, indem Sie das Attribut Treeviewleaf.UID oder Treeviewnode.UID ermitteln.

Eingaben
id
ID des Treeview-Objekts
item
spezieller Identifikator, der von dieser Methode zurückgegeben wird oder ein spezieller Wert (siehe oben)
position
Index des Eintrags, der ermittelt wird oder ein spezieller Wert (siehe oben)
Rückgabewerte
found
boolesches Flag, das angibt, ob ein Eintrag gefunden wurde oder nicht
table
Tabelle mit Informationen zum gefundenen Eintrag
Beispiel
Function p_DumpListTree(id$, node, indent)
   Local found, t = moai.DoMethod(id$, "GetEntry", node, "Head")
   While found = True
      If indent > 0
         DebugPrint(RepeatStr(" ", indent) ..
             IIf(t.Node = True, "+", ""), Unpack(t.items))
      Else
         DebugPrint(IIf(t.Node = True, "+", ""), Unpack(t.items))
      EndIf
      If t.Node = True Then p_DumpListTree(id$, t.uid, indent + 4)
      found, t = moai.DoMethod(id$, "GetEntry", t.uid, "Next")
    Wend
EndFunction

p_DumpListTree("mytreeview", "root", 0)
Der obige Code zeigt, wie man den kompletten Inhalt einer Baumansicht unter Beibehaltung seiner Struktur ausgibt.

Navigation zeigen