Eine Zeile in TListView: erste Spalte als Caption, weitere Spalten als SubItems, dazu Auswahl, Haken, Symbol und ein freier Datenzeiger.
Unit: Vega.ListView · Basis: keine — eigene Wurzel
→ Alle Steuerelemente · Guide: Komponenten
Kette: TListItem — eigene Wurzel, kein Vorfahr. Was diese Klasse kann, steht vollständig auf dieser Seite.
Direkte Nachfahren: keine — diese Klasse wird nicht weiter abgeleitet.
Quelle: vega/listview.lyx
var it: TListItem := lv.AddItem("paula.lyx");
it.AddSubItem("48 kB");
it.AddSubItem("2026-08-19");
it.ImageIndex := 0;
it.Data := satzNummer; // Weg zurueck zum Datensatz
// Spalten einheitlich lesen: 0 = Caption, 1..n = SubItems
var t: pchar := it.TextOf(1);
it.Checked := true;
it.Selected := true;
TextOf(col) ist der einheitliche Zugriff: Spalte 0 liefert die Caption, alles darüber das passende SubItem.SetSubItem(index, s) füllt Lücken selbst auf — man kann Spalte 3 setzen, ohne 1 und 2 zu belegen.Data ist der wichtigste Punkt in der Praxis: Dort steht der Schlüssel oder Zeiger auf den eigentlichen Datensatz, damit aus einer angeklickten Zeile wieder ein Objekt wird.Selected und Checked sind zwei verschiedene Dinge — markiert ist nicht angehakt.Alle Eigenschaften, auch die geerbten.
| Name | Typ | Bedeutung | Herkunft |
|---|---|---|---|
Caption | TTextBuffer | Beschriftung — hält nur den Zeiger, keine Kopie | eigen |
SubItems | TStringList | Texte der weiteren Spalten, beginnend bei Spalte 1 | eigen |
Selected | bool | Ausgewählt | eigen |
Checked | bool | Angehakt bzw. ausgewählt | eigen |
Data | int64 | Adresse der Bilddaten, 32 Bit je Pixel (nur lesen) | eigen |
ImageIndex | int64 | Nummer des Symbols in der Sammlung der Leiste | eigen |
Cut | bool | Ausschneidemarkierung und Ablageziel — beide werden gezeichnet | eigen |
DropTarget | bool | Ziel eines laufenden Ziehvorgangs | eigen |
Owner | TListView | Die Ansicht, in der diese Zeile hängt. Wird beim Einhaengen gesetzt; ohne sie könnte eine Zeile weder ihren Index noch ihr Rechteck nennen und sich nicht selbst löschen | eigen |
StateIndex | int64 | Symbol aus der Zustandsliste, wie in Delphi. -1 = keins | eigen |
Alle Methoden, auch die geerbten.
| Signatur | Zweck | Herkunft |
|---|---|---|
Create(caption: pchar): void | Wird von AddItem aufgerufen | eigen |
Destroy(): void | Gibt eigene Ressourcen frei | eigen |
SetCaption(s: pchar): void | Erste Spalte ändern | eigen |
TextOf(col: int64): pchar | Text einer Spalte (0 = Caption) | eigen |
SetSubItem(index: int64, s: pchar): void | Spalte setzen (füllt Lücken) | eigen |
AddSubItem(s: pchar): void | Spalte anhängen | eigen |
Delete(): void | Sich selbst aus der Ansicht nehmen und freigeben | eigen |
DisplayRect(): TRect | Das Rechteck dieser Zeile in der Ansicht. Ausserhalb des sichtbaren Bereichs kommt ein leeres zurück — wie bei TListBox.ItemRect | eigen |
Index(): int64 | Stelle in der Ansicht. -1, wenn die Zeile nirgends hängt | eigen |
MakeVisible(): void | In den sichtbaren Bereich rollen | eigen |
Keine.
Letzte Aktualisierung: 2026-09-05 — gegen lyx-vcl/vega/*.lyx abgeglichen: Abschnitt „Vererbung„ (Vorfahr-Kette, direkte Nachfahren, Quelldatei) ergänzt und die fehlenden Eigenschaften, Methoden und Ereignisse nachgetragen.
Vorherige letzte Aktualisierung: 2026-08-19 — API maschinell aus Vega/ListView.lyx erhoben, Beispiel mit lyxc 1.1.3I übersetzt.