====== Vega.ListCtrls — Bildlaufleiste, Liste, Auswahlfeld ======

Die drei hängen zusammen: die Liste braucht eine Bildlaufleiste, das Auswahlfeld klappt eine Liste auf. Deshalb eine Unit statt drei. Wer Spalten braucht, nimmt [[lyx_-_programmiersprache:vega:units:listview|Vega.ListView]]; wer Zellen braucht, [[lyx_-_programmiersprache:vega:units:grids|Vega.Grids]].

Quelldatei: ''Vega/ListCtrls.lyx''

→ [[lyx_-_programmiersprache:vega:units|Alle Units]] · [[lyx_-_programmiersprache:vega:controls|Alle Steuerelemente]] · [[lyx_-_programmiersprache:vega|Vega VCL]]

----

===== Klassen =====

^ Klasse ^ Basis ^ Zweck ^
| [[lyx_-_programmiersprache:vega:controls:tcombobox|TComboBox]] | [[lyx_-_programmiersprache:vega:controls:tcontrol|TControl]] | Eingeklappte Auswahlliste |
| [[lyx_-_programmiersprache:vega:controls:tlistbox|TListBox]] | [[lyx_-_programmiersprache:vega:controls:tcontrol|TControl]] | Liste mit Auswahl und eigenem Bildlauf |
| [[lyx_-_programmiersprache:vega:controls:tscrollbar|TScrollBar]] | [[lyx_-_programmiersprache:vega:controls:tcontrol|TControl]] | Bildlaufleiste, waagerecht oder senkrecht |

===== Typaliase =====

^ Name ^ Ist ^ Zweck ^
| ''TDrawItemEvent'' | ''fn(sender: TControl, canvas: TCanvas,
                             index: int64, r: TRect, state: int64): void'' | Handler zum Selberzeichnen eines Eintrags |

===== Aufzählungen =====

^ Enum ^ Werte ^ Zweck ^
| ''TScrollKind'' | ''SB_VERTICAL'' (0), ''SB_HORIZONTAL'' (1) | Ausrichtung einer Bildlaufleiste |

===== Konstanten =====

^ Name ^ Typ ^ Wert ^ Bedeutung ^
| ''VEGA_NO_ITEM'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | ''0 - 1'' | Kein Eintrag ausgewählt |
| ''ODS_SELECTED'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | ''1'' | Zeichenzustand: ausgewählt |
| ''ODS_FOCUSED'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | ''2'' | Zeichenzustand: hat den Fokus |
| ''ODS_DISABLED'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | ''4'' | Zeichenzustand: gesperrt |
| ''ODS_COMBOBOXEDIT'' | [[lyx_-_programmiersprache:sprache:datentypen#1_ganzzahl-typen_signiert|int64]] | ''8'' | Zeichenzustand: Anzeigefeld des Auswahlfelds |

===== Freie Funktionen =====

^ Signatur ^ Zweck ^
| ''NewScrollBar(kind: int64): TScrollBar'' | Erzeugt eine Bildlaufleiste dieser Ausrichtung |
| ''NewListBox(): TListBox'' | Erzeugt eine leere Liste |
| ''NewComboBox(): TComboBox'' | Erzeugt ein leeres Auswahlfeld |

----

===== Zu beachten =====

  * Die Reihenfolge ist ''SB_VERTICAL'' (0), ''SB_HORIZONTAL'' (1) — umgekehrt zur Erwartung vieler Umsteiger.
  * ''VEGA_NO_ITEM'' statt ''-1'' abfragen: der Wert steht für „nichts ausgewählt“ und ist an einer Stelle festgelegt.
  * Eigene Darstellung eines Eintrags läuft über ''OnDrawItem'' mit den ''ODS_*''-Bits, nicht über eine Ableitung.
  * Einträge liegen in einer [[lyx_-_programmiersprache:vega:controls:tstringlist|TStringList]]; die Liste besitzt ihre Texte.

----

===== Abhängigkeiten =====

**Importiert:** [[lyx_-_programmiersprache:vega:units:types|Vega.Types]], [[lyx_-_programmiersprache:vega:units:events|Vega.Events]], [[lyx_-_programmiersprache:vega:units:canvas|Vega.Canvas]], [[lyx_-_programmiersprache:vega:units:theme|Vega.Theme]], [[lyx_-_programmiersprache:vega:units:control|Vega.Control]], [[lyx_-_programmiersprache:vega:units:font|Vega.Font]], [[lyx_-_programmiersprache:vega:units:strings|Vega.Strings]], [[lyx_-_programmiersprache:vega:units:lists|Vega.Lists]], [[lyx_-_programmiersprache:vega:units:style|Vega.Style]]

**Wird importiert von:** [[lyx_-_programmiersprache:vega:units:colorctrls|Vega.ColorCtrls]], [[lyx_-_programmiersprache:vega:units:editbtn|Vega.EditBtn]], [[lyx_-_programmiersprache:vega:units:extras|Vega.Extras]], [[lyx_-_programmiersprache:vega:units:filedlg|Vega.FileDlg]], [[lyx_-_programmiersprache:vega:units:fontdlg|Vega.FontDlg]], [[lyx_-_programmiersprache:vega:units:layout|Vega.Layout]], [[lyx_-_programmiersprache:vega:units:lfmclasses|Vega.LfmClasses]], [[lyx_-_programmiersprache:vega:units:lfmload|Vega.LfmLoad]], [[lyx_-_programmiersprache:vega:units:lfmsave|Vega.LfmSave]], [[lyx_-_programmiersprache:vega:units:listview|Vega.ListView]], [[lyx_-_programmiersprache:vega:units:trees|Vega.Trees]]

Letzte Aktualisierung: 2026-08-20 — Klassen, Aufzählungen, Konstanten und freie Funktionen maschinell aus ''Vega/ListCtrls.lyx'' erhoben.