====== TListColumn — Spalte einer ListView ======

Beschreibt eine Spalte in [[lyx_-_programmiersprache:vega:controls:tlistview|TListView]] oder [[lyx_-_programmiersprache:vega:controls:theadercontrol|THeaderControl]]: Überschrift, Breite, Ausrichtung, Sortierpfeil.

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 c: TListColumn := lv.AddColumn("Groesse", 100);
c.Alignment := TA_RIGHT;
c.SortDirection := SD_ASCENDING;
c.Tag := 2;                   // eigener Schluessel, z. B. Feldnummer

c.SetCaption("Größe in kB");
var t: pchar := c.Text();
</code>

----

===== Besonderheiten =====

  * **Kein Steuerelement** — ein einfaches Objekt, das ''AddColumn'' anlegt und zurückgibt.
  * ''SortDirection'' zeichnet den Pfeil in der Kopfzeile; das eigentliche Sortieren macht die ListView (''AutoSort'') oder die Anwendung.
  * ''Tag'' ist der bequeme Weg, eine Spalte einem Datenfeld zuzuordnen, ohne über den Index zu gehen.
  * Die Überschrift liegt als ''TTextBuffer'' vor; ''Text()'' liefert den ''pchar'' dazu.

----

===== 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 |
| ''Width'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Breite | eigen |
| ''Alignment'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Textausrichtung: ''TA_LEFT'' (0), ''TA_CENTER'' (1), ''TA_RIGHT'' (2) | eigen |
| ''SortDirection'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | ''SD_NONE'' (0), ''SD_ASCENDING'' (1), ''SD_DESCENDING'' (2) | eigen |
| ''Tag'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | Freier Wert für die Anwendung | eigen |

----

===== Methoden =====

Alle Methoden, auch die geerbten.

^ Signatur ^ Zweck ^ Herkunft ^
| ''Create(caption: pchar, width: int64): void'' | Wird von ''AddColumn'' aufgerufen | eigen |
| ''Destroy(): void'' | Gibt eigene Ressourcen frei | eigen |
| ''SetCaption(s: pchar): void'' | Überschrift ändern | eigen |
| ''Text(): pchar'' | Überschrift lesen | eigen |

----

===== Ereignisse =====

Keine.

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