TTreeNode — Knoten im Baum

Ein Eintrag in TTreeView: Text, Kinder, Klappzustand und ein freier Wert für den Bezug zu eigenen Daten.

Unit: Vega.Trees · Basis: TControl

→ Alle Steuerelemente · Guide: Komponenten

Verwendung

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();

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 TTextBuffer Der Inhalt eigen
Parent TTreeNode Zeichnerisches Elternteil eigen
Children TObjectList Kinder eigen
ChildCount int64 Anzahl der Kinder eigen
Expanded bool Knoten ist aufgeklappt eigen
Tag int64 Freier Wert für die Anwendung eigen
ImageIndex int64 Symbol aus der TImageList eigen
SelectedIndex 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.