TListItem — Eintrag einer ListView

Eine Zeile in TListView: erste Spalte als Caption, weitere Spalten als SubItems, dazu Auswahl, Haken, Symbol und ein freier Datenzeiger.

Unit: Vega.ListView · Basis: TControl

→ Alle Steuerelemente · Guide: Komponenten

Verwendung

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;

Besonderheiten

  • 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.

Eigenschaften

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 Symbol aus der TImageList eigen

Methoden

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

Ereignisse

Keine.

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