Vcl.ListActns.TCustomVirtualListAction.GetItem
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);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | protected | Vcl.ListActns.pas Vcl.ListActns.hpp |
Vcl.ListActns | TCustomVirtualListAction |
Beschreibung
Stellt Informationen zu einem angegebenen Eintrag bereit.
Wenn Sie die Eigenschaft Active auf True setzen, stellt die virtuelle Listenaktion Einträge für Client-Steuerelemente bereit, indem für jeden Eintrag GetItem aufgerufen wird. GetItem ruft die Informationen zu jedem Eintrag ab, indem ein OnGetItem-Ereignis generiert wird. Die Methode gibt True zurück, wenn eine OnGetItem-Ereignisbehandlungsroutine existiert, die Informationen zum Eintrag in den Parametern von GetItem zurückgibt. GetItem gibt False zurück, wenn keine Informationen zu dem Eintrag bereitgestellt werden können, weil keine Ereignisbehandlungsroutine für OnGetItem vorhanden ist. Index gibt den gewünschten Eintrag an. 0 bezeichnet den ersten Eintrag, 1 den zweiten usw. bis zum Wert der Eigenschaft Count minus 1. Value gibt den String-Wert des Eintrags zurück. Dies ist der Text, der im Client-Kombinationsfeld oder -Listenfeld angezeigt wird. ImageIndex gibt den Index des Bildes zurück, das dem Eintrag zugeordnet ist. Ist dem Eintrag kein Bild zugeordnet, gibt ImageIndex -1 zurück. Andernfalls wird der Index des gewünschten Bildes in der Eigenschaft Images zurückgegeben. Data gibt einen Zeiger auf anwendungsdefinierte Daten zurück, die dem Eintrag zugeordnet sind. Für Client-Steuerelemente, die Einträge in einem TStrings-Objekt speichern, enthält Data den Wert der Eigenschaft Objects des betreffenden Eintrags.