Vcl.ListActns.TCustomVirtualListAction.OnGetItem

Übergeordnet: TCustomVirtualListAction

Delphi

property OnGetItem: TGetVirtualItemEvent read FOnGetItem write FOnGetItem;

C++

__property TGetVirtualItemEvent OnGetItem = {read=FOnGetItem, write=FOnGetItem};

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
event	public	Vcl.ListActns.pas Vcl.ListActns.hpp	Vcl.ListActns	TCustomVirtualListAction

Beschreibung

Wird ausgelöst, wenn die Listenaktion einen Eintrag für ihre Client-Steuerelemente bereitstellen muss.

Mit einer Ereignisbehandlungsroutine für OnGetItem stellen Sie die Einträge bereit, die die virtuelle Listenaktion an Clients übergibt. Wenn Sie der Eigenschaft Active den Wert True zuweisen, erzeugt die virtuelle Listenaktion ein OnGetItem-Ereignis für jeden Index von 0 bis Count - 1. Stellen Sie in der Ereignisbehandlungsroutine den String-Wert, das Bild und die Daten für den mit Index angegebenen Eintrag bereit.

Sender ist die Listenaktion, die Daten für Client-Steuerelemente bereitstellt.

Index gibt an, welcher Eintrag angefordert wird. Null bezeichnet den ersten Eintrag, 1 den zweiten usw., bis der Wert der Eigenschaft Count minus 1 erreicht ist.

Value gibt den String-Wert des Eintrags zurück. Dies ist der Text, der im Client-Kombinationsfeld oder -Listenfeld angezeigt wird.

ImageIndex ist der Index des Bildes, das dem Eintrag zugeordnet ist. Ist dem Eintrag kein Bild zugeordnet, sollte ImageIndex -1 zurückgeben. Andernfalls sollte der Index des gewünschten Bildes in der Eigenschaft Images zurückgegeben werden.

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.