Vcl.StdCtrls.TListBoxStyle

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

TListBoxStyle = (lbStandard, lbOwnerDrawFixed, lbOwnerDrawVariable,
lbVirtual, lbVirtualOwnerDraw);

C++

enum DECLSPEC_DENUM TListBoxStyle : unsigned char { lbStandard, lbOwnerDrawFixed, lbOwnerDrawVariable, lbVirtual, lbVirtualOwnerDraw };

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
enum public
Vcl.StdCtrls.pas
Vcl.StdCtrls.hpp
Vcl.StdCtrls Vcl.StdCtrls

Beschreibung

TListBoxStyle gibt an, wie ein Listenfeld seine Daten erhält und angezeigt wird.

Die folgende Tabelle enthält die Werte, die TListBoxStyle annehmen kann:



Wert Bedeutung

lbStandard

Alle Einträge sind Strings mit derselben Höhe.

lbOwnerDrawFixed

Das Listenfeld ist ein Owner-Draw-Listenfeld. Jeder Eintrag im Listenfeld hat die in der Eigenschaft ItemHeight angegebene Höhe. Wenn ein Eintrag in einem Listenfeld mit dem Stil lbOwnerDrawFixed angezeigt wird, tritt das Ereignis OnDrawItem auf. Die Ereignisbehandlungsroutine für OnDrawItem zeichnet den angegebenen Eintrag. Die Eigenschaft ItemHeight bestimmt die Höhe der Einträge.

lbOwnerDrawVariable

Das Listenfeld ist ein Owner-Draw-Listenfeld. Die Einträge im Listenfeld können unterschiedliche Höhen aufweisen. Sobald ein Eintrag in einem Listenfeld mit dem Stil lbOwnerDrawVariable angezeigt wird, treten zwei Ereignisse auf. Zuerst wird das Ereignis OnMeasureItem ausgelöst. In der Ereignisbehandlungsroutine für OnMeasureItem kann die Höhe der Einträge definiert werden. Anschließend tritt das Ereignis OnDrawItem auf. Mit dem Quelltext der Ereignisbehandlungsroutine für OnDrawItem wird jeder Eintrag im Listenfeld unter Verwendung der mit der Ereignisbehandlungsroutine für OnMeasureItem angegebenen Größe gezeichnet.

lbVirtual

Das Listenfeld ist virtuell. Alle Einträge sind Strings mit derselben Höhe. Sie müssen die Anzahl der Einträge im Listenfeld durch Einstellen der Eigenschaft Count festlegen. Die Einträge für das Listenfeld werden über eine Ereignisbehandlungsroutine für OnData bereitgestellt. Existieren Objekte zu den Einträgen, müssen Sie diese über eine Ereignisbehandlungsroutine für OnDataObject bereitstellen. Außerdem wird eine Ereignisbehandlungsroutine für OnDataFind benötigt, um die Zuordnung der Strings im Listenfeld zu den entsprechenden Indexwerten vorzunehmen.

lbVirtualOwnerDraw

Das Listenfeld ist virtuell und ein Owner-Draw-Listenfeld. Alle Einträge weisen dieselbe Höhe auf. Wie beim Stil lbOwnerDrawFixed wird die Höhe in der Eigenschaft ItemHeight angegeben. Das Zeichnen der Einträge erfolgt über eine Ereignisbehandlungsroutine für OnDrawItem. Wie beim Stil lbVirtual muss die Eigenschaft Count eingestellt werden. Außerdem müssen Ereignisbehandlungsroutinen für OnData und OnDataFind bereitgestellt werden, welche die Zuordnung von Einträgen und Indizes vornehmen. Sind den Einträgen Objekte zugeordnet, wird außerdem eine Ereignisbehandlungsroutine für OnDataObject benötigt.