System.Contnrs.TComponentList.Items

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

property Items[Index: Integer]: TComponent read GetItems write SetItems; default;

C++

__property System::Classes::TComponent* Items[int Index] = {read=GetItems, write=SetItems/*, default*/};

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
property public
System.Contnrs.pas
System.Contnrs.hpp
System.Contnrs TComponentList

Beschreibung

Enthält die Komponenten des Listenobjekts.

Mit Items können Sie auf die Komponenten in der Liste zugreifen. Die Eigenschaft ist ein nullbasiertes Array. Die erste Komponente hat den Index 0, die zweite den Index 1 usw. Zur Navigation in der Liste verwenden Sie Items zusammen mit der Eigenschaft Count.

Wenn die Eigenschaft Extract den Wert true hat, wird durch erneutes Zuweisen eines bestimmten Wertes die Komponente automatisch freigegeben, die vorher an dieser Position war.

Items kann nil- (Delphi) oder NULL- (C++) Referenzen enthalten. Mit der Methode Pack können diese Referenzen entfernt und die Größe des Arrays reduziert werden.

Anmerkung:  In Delphi ist Items die Standardeigenschaft von TComponentList. Der Name der Eigenschaft muss also im Quelltext nicht angegeben werden. Die beiden folgenden Zeilen sind damit gleichwertig:

ComponentList1->Items[i] := Screen.CustomForms[i]; ComponentList1[i] := Screen.CustomForms[i];

Anmerkung:  In C++ kann auf Items mit dem Operator [] zugegriffen werden, um einen ähnlichen Effekt wie mit der Standardeigenschaft in Delphi zu erreichen.

Siehe auch