ListActns.TCustomVirtualListAction.GetItem

Informations Delphi

De ListActns.pas

	function GetItem(const Index: Integer;
		var Value: string;
		var ImageIndex: Integer;
		var Data: Pointer): Boolean;

Unité : ListActns

Type : méthode

Visibilité : protected

Membre de : TCustomVirtualListAction

Informations C++

De ListActns.hpp

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

Unité : ListActns

Type : méthode

Visibilité : protected

Membre de : 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

• Count

• OnGetItemCount