====== TTreeNode — Knoten im Baum ======

Ein Eintrag in [[lyx_-_programmiersprache:vega:controls:ttreeview|TTreeView]]: Text, Kinder, Klappzustand und ein freier Wert für den Bezug zu eigenen Daten.

Unit: ''Vega.Trees'' · Basis: [[lyx_-_programmiersprache:vega:controls:tcontrol|TControl]]

→ [[lyx_-_programmiersprache:vega:controls|Alle Steuerelemente]] · [[lyx_-_programmiersprache:vega:guides:komponenten|Guide: Komponenten]]

----

===== Verwendung =====

<code lyx>
var wurzel: TTreeNode := tv.Add("Projekt");
var kind: TTreeNode := wurzel.Add("Quellen");
kind.Tag := 42;
kind.ImageIndex := 1;

wurzel.Expand();
if (kind.HasChildren()) { kind.Toggle(); }

var t: pchar := kind.GetText();
kind.SetText("Quelltexte");
kind.EnsureVisible();
</code>

----

===== Besonderheiten =====

  * **Kein Steuerelement** — ein Objekt im Baum. Angelegt wird über ''Add'' am Baum oder am Elternknoten.
  * ''Level()'' liefert die Tiefe (Wurzel = 0) — praktisch für Einrückung in eigenen Darstellungen.
  * ''ImageIndex'' und ''SelectedIndex'' erlauben zwei Symbole: eines im Normalzustand, eines für den gewählten Knoten.
  * ''EnsureVisible()'' klappt alle Eltern auf; das eigentliche Scrollen macht ''TTreeView.ScrollToNode''.
  * ''Tag'' ist der Weg vom Knoten zurück zu den eigenen Daten.

----

===== Eigenschaften =====

Alle Eigenschaften, auch die geerbten.

^ Name ^ Typ ^ Bedeutung ^ Herkunft ^
| ''Text'' | [[lyx_-_programmiersprache:vega:controls:ttextbuffer|TTextBuffer]] | Der Inhalt | eigen |
| ''Parent'' | [[lyx_-_programmiersprache:vega:controls:ttreenode|TTreeNode]] | Zeichnerisches Elternteil | eigen |
| ''Children'' | [[lyx_-_programmiersprache:vega:controls:tobjectlist|TObjectList]] | Kinder | eigen |
| ''ChildCount'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Anzahl der Kinder | eigen |
| ''Expanded'' | [[lyx_-_programmiersprache:sprache:datentypen#5_wahrheitswerte_bool|bool]] | Knoten ist aufgeklappt | eigen |
| ''Tag'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Freier Wert für die Anwendung | eigen |
| ''ImageIndex'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Symbol aus der ''TImageList'' | eigen |
| ''SelectedIndex'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Symbol im ausgewählten Zustand | eigen |

----

===== Methoden =====

Alle Methoden, auch die geerbten.

^ Signatur ^ Zweck ^ Herkunft ^
| ''Create(text: pchar): void'' | Wird von ''Add'' aufgerufen | eigen |
| ''Destroy(): void'' | Gibt eigene Ressourcen frei | eigen |
| ''GetText(): pchar'' | Inhalt lesen | eigen |
| ''SetText(s: pchar): void'' | Inhalt setzen | eigen |
| ''Add(text: pchar): TTreeNode'' | Kind anlegen | eigen |
| ''Child(i: int64): TTreeNode'' | Kind holen | eigen |
| ''HasChildren(): bool'' | Hat Kinder | eigen |
| ''Level(): int64'' | Tiefe im Baum | eigen |
| ''Expand(): void'' | Aufklappen | eigen |
| ''Collapse(): void'' | Zuklappen | eigen |
| ''Toggle(): void'' | Umschalten | eigen |
| ''EnsureVisible(): void'' | Eltern aufklappen | eigen |

----

===== Ereignisse =====

Keine.

Letzte Aktualisierung: 2026-08-19 — API maschinell aus ''Vega/Trees.lyx'' erhoben, Beispiel mit ''lyxc 1.1.3I'' übersetzt.