Bezeichnung
Treeview.InsertLeaf -- fügt ein neues Blatt in den Baum ein
Übersicht
moai.DoMethod(id, "InsertLeaf", id$, node$, pred$, [icon1,] entry1$, ...)
Beschreibung
Fügt ein neues Blatt an der durch node$ und pred$ definierten Stelle in die Baumansicht ein. Ein Blatt ist ein Baumelement, das keine Elemente hat. id$ muss ein eindeutiger Zeichenketten-Identifikator sein, den Sie verwenden werden, um auf das neu eingefügte Baum-Blatt zu verweisen.

Die Eingabedaten für das neue Blatt müssen in den letzten Parametern übergeben werden. Wenn die Baumansicht mehrere Spalten hat, müssen Sie für alle Spalten der Baumansicht individuelle Eingabedaten übergeben. Die Eingabedaten bestehen aus einer Zeichenkette und, wenn für die Spalte das Attribut Treeviewcolumn.Icon gesetzt ist, einem Symbol für jede Spalte. Das Symbol muss vor der Zeichenkette übergeben werden und es muss ein Identifikator eines Hollywood-Pinsels/-Icons sein, der dann als Symbol für den Eintrag verwendet werden soll. Wenn Treeviewcolumn.Icon nicht gesetzt ist, müssen Sie das Attribut icon weglassen und nur Textdaten für den Baum-Eintrag übergeben. Wenn Sie Treeviewcolumn.Icon auf True gesetzt haben und kein Symbol in dieser bestimmten Zeile und Spalte anzeigen möchten, können Sie auch den speziellen Wert -1 übergeben. In diesem Fall zeigt RapaGUI kein Symbol an, obwohl Treeviewcolumn.Icon auf True gesetzt wurde. Beachten Sie, dass automatisch generierte IDs nicht verwendet werden können. Bitte lesen Sie auch das Kapitel über den Bilder-Cache von RapaGUI, um mehr über die Unterstützung von Icons in RapaGUI zu erfahren. Siehe Bilder-Cache für Details.

Wenn eine Spalte ein Auswahlkästchen (Checkbox) enthält, müssen Sie "On", "True" oder "1" übergeben, um das Auswahlkästchen zu aktivieren und irgend einen anderen Text, um das Auswahlkästchen zu deaktivieren.

In node$ müssen Sie den Knoten übergeben, in dessen Liste das neue Blatt eingefügt wird. Dies kann der Zeichenketten-Identifikator eines Knotens oder einer der folgenden Sonderwerte sein:

Root
Der Wurzelknoten.

In pred$ müssen Sie den Knoten oder das Blatt angeben, der zum Vorgänger des einzufügenden Blattes wird, d.h. das neue Blatt wird nach dem in pred$ angegebenen Element eingefügt. Dies kann der Zeichenketten-Identifikator eines Knotens oder eines Blattes oder einer der folgenden speziellen Werte sein:

Head
Als erstes Element des Knotens einfügen.

Tail
Als letztes Element des Knotens einfügen.

Active
Fügt das neue Blatt nach dem aktiven Element ein. Wenn es keinen aktiven Eintrag gibt, wird das Objekt als letztes untergeordnetes Element eingefügt.

Beachten Sie, dass unter AmigaOS und kompatiblen Betriebssystemen diese Fähigkeit mindestens MUI 4.0 erfordert.

Eingaben
id
ID des Treeview-Objekts
id$
eindeutiger Zeichenketten-Identifikator für das neue Baum-Blatt
node$
Zeichenketten-ID des einzufügenden Knotens oder spezieller Wert (siehe oben)
pred$
Zeichenketten-ID des Vorgängerknotens/-Blattes oder speziellen Wertes (siehe oben)
icon1
optional: Symbol für den Eintrag in der ersten Spalte; dieses muss nur übergeben werden, wenn die Spalte das Icon-Attribut gesetzt hat; beachten Sie, dass dies ein numerischer Identifikator sein muss und automatisch generierte IDs in diesem Fall nicht gültig sind
entry1$
Eintrag zum Einfügen in die erste Spalte
...
mehr Einträge, wenn der Baum mehrere Spalten hat
Navigation zeigen