System.Contnrs.TComponentList.Items

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

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

Propriétés

Type Visibilité  Source Unité  Parent
property public
System.Contnrs.pas
System.Contnrs.hpp
System.Contnrs TComponentList

Description

Enumère les composants référencés.

Utilisez la propriété Items pour accéder aux composants de la liste. Items est un tableau d'indice de base zéro : Le premier composant a l'indice 0, le second l'indice 1, etc. Vous pouvez lire ou modifier la valeur pour un indice spécifique ou utiliser Items avec la propriété Count pour parcourir la liste.

Si OwnsObjects a la valeur true, la réaffectation d'une valeur Items libère le composant qui occupait préalablement cette position dans la liste.

Items peut contenir des références nil (Delphi) ou NULL (C++). Pour retirer les références nil (Delphi) ou NULL (C++) et réduire la taille du tableau, appelez la méthode Pack.

Remarque :  Dans Delphi, Items est la propriété par défaut de TComponentList. Cela signifie que le nom de la propriété peut être omis dans le code faisant référence à cette propriété. Par conséquent, les lignes suivantes sont toutes deux correctes et ont le même effet :

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

Remarque :  Dans C++, vous pouvez accéder à Items à l'aide de l'opérateur [] ; vous obtiendrez le même résultat qu'avec la propriété par défaut dans Delphi.

Voir aussi