Vcl.ListActns.TCustomVirtualListAction.GetItem

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function GetItem(const Index: Integer; var Value: String;  var ImageIndex: Integer; var Data: TCustomData): Boolean;

C++

bool __fastcall GetItem(const int Index, System::UnicodeString &Value, int &ImageIndex, void * &Data);

Propriétés

Type Visibilité  Source Unité  Parent
function protected
Vcl.ListActns.pas
Vcl.ListActns.hpp
Vcl.ListActns TCustomVirtualListAction

Description

Fournit les informations sur un élément spécifié.

Lorsque vous affectez la valeur True à la propriété Active, l'action liste virtuelle fournit des éléments aux contrôles client par le biais d'une série d'appels à la méthode GetItem, un pour chaque élément. GetItem collecte les informations sur chaque élément en générant un événement OnGetItem. Elle renvoie True si un gestionnaire d'événements OnGetItem fournit les informations sur l'élément, qui sont renvoyées par le biais des paramètres GetItem. GetItem renvoie False s'il n'existe aucun gestionnaire d'événements OnGetItem et que, par conséquent, il ne peut fournir aucune information sur l'élément. Index indique l'élément requis : 0 représente le premier élément, 1 le second, etc. jusqu'au nombre d'éléments spécifié dans la propriété Count. Value renvoie la valeur chaîne de l'élément. Il s'agit du texte qui apparaît dans la boîte liste ou la boîte à options du client. ImageIndex renvoie l'indice d'une image associée à l'élément. Si l'élément n'est associé à aucune image, ImageIndex renvoie –1. Sinon, elle renvoie l'indice d'une image de la propriété Images. Data renvoie un pointeur sur des données définies par l'application et associées à l'élément. Pour les contrôles client qui stockent des éléments dans un objet TStrings, Data fournit la valeur de la propriété Objects de l'élément.

Voir aussi