====== TListItem — Eintrag einer ListView ======

Eine Zeile in [[lyx_-_programmiersprache:vega:controls:tlistview|TListView]]: erste Spalte als Caption, weitere Spalten als SubItems, dazu Auswahl, Haken, Symbol und ein freier Datenzeiger.

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

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

----

===== Verwendung =====

<code 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;
</code>

----

===== 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'' | [[lyx_-_programmiersprache:vega:controls:ttextbuffer|TTextBuffer]] | Beschriftung — hält **nur den Zeiger**, keine Kopie | eigen |
| ''SubItems'' | [[lyx_-_programmiersprache:vega:controls:tstringlist|TStringList]] | Texte der weiteren Spalten, beginnend bei Spalte 1 | eigen |
| ''Selected'' | [[lyx_-_programmiersprache:sprache:datentypen#5_wahrheitswerte_bool|bool]] | Ausgewählt | eigen |
| ''Checked'' | [[lyx_-_programmiersprache:sprache:datentypen#5_wahrheitswerte_bool|bool]] | Angehakt bzw. ausgewählt | eigen |
| ''Data'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Adresse der Bilddaten, 32 Bit je Pixel (nur lesen) | eigen |
| ''ImageIndex'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|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.