Vcl.StdCtrls.TListBoxStyle

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
enum public
Vcl.StdCtrls.pas
Vcl.StdCtrls.hpp
Vcl.StdCtrls Vcl.StdCtrls

Description

TListBoxStyle indique la façon dont un contrôle boîte liste obtient ses données et comment il est dessiné.

Le tableau suivant énumère les valeurs du type TListBoxStyle :



Valeur Signification

lbStandard

Tous les éléments sont des chaînes de même hauteur.

lbOwnerDrawFixed

La boîte liste est dessinée par le propriétaire mais la hauteur de chaque élément de la boîte liste est spécifiée par la propriété ItemHeight. A chaque fois qu'un élément est affiché dans une boîte liste de style lbOwnerDrawFixed, l'événement OnDrawItem se produit. Le gestionnaire d'événement OnDrawItem dessine l'élément spécifié. La propriété ItemHeight détermine la hauteur de tous les éléments.

lbOwnerDrawVariable

La boîte liste est dessinée par le propriétaire et ses éléments peuvent avoir une hauteur variable. A chaque fois qu'un élément est affiché dans une boîte liste de style lbOwnerDrawVariable, deux événements se produisent. Le premier est l'événement OnMeasureItem. Le code du gestionnaire d'événement OnMeasureItem peut spécifier la hauteur de chaque élément. L'événement OnDrawItem se produit ensuite. Le code du gestionnaire d'événement OnDrawItem dessine chaque élément de la boîte liste en utilisant la taille spécifiée par le gestionnaire OnMeasureItem.

lbVirtual

La boîte liste est virtuelle, mais tous les éléments sont des chaînes de même hauteur. Vous devez indiquer le nombre d'éléments de la boîte liste en affectant une valeur à la propriété Count. Vous devez fournir les éléments de la boîte liste en utilisant un gestionnaire d'événement OnData. Si les éléments disposent d'objets associés, vous devez les fournir en utilisant un gestionnaire d'événement OnDataObject. De plus, vous devez fournir un gestionnaire d'événement OnDataFind pour indiquer la correspondance entre les chaînes de la boîte liste et leurs indices.

lbVirtualOwnerDraw

La boîte liste est virtuelle et dessinée par le propriétaire. Tous les éléments ont la même hauteur. Comme avec lbOwnerDrawFixed, la hauteur des éléments est spécifiée par la propriété ItemHeight et vous devez dessiner les éléments en utilisant un gestionnaire d'événement OnDrawItem. Comme avec IbVirtual, vous devez affecter une valeur à la propriété Count et fournir des gestionnaires d'événements OnData et OnDataFind pour indiquer la correspondance entre les éléments et leurs indices. Si les éléments disposent d'objets associés, vous devez également fournir un gestionnaire d'événement OnDataObject.