Vcl.Controls.TWinControl.Controls

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

property Controls[Index: Integer]: TControl read GetControl;

C++

__property TControl* Controls[int Index] = {read=GetControl};

Propriétés

Type Visibilité  Source Unité  Parent
property public
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TWinControl

Description

Liste tous les contrôles enfant.

Controls est un tableau de tous les contrôles enfant. Tous ces contrôles présentent ce contrôle comme leur propriété Parent. La propriété Controls est utile pour référencer les enfants d'un contrôle par numéro plutôt que par nom. Par exemple, Controls peut être utilisée pour parcourir tous les contrôles enfant.

Il ne faut pas confondre la propriété Controls et la propriété Components. La propriété Controls liste tous les contrôles qui sont des fenêtres enfant du contrôle, alors que la propriété Components liste tous les composants qu'il contient. La fiche possède tous les composants qui y sont placés, et les composants apparaissent donc dans la liste de sa propriété Components même si ce sont des fenêtres enfant d'un contrôle de la fiche.

Controls est une propriété en lecture seule. Pour ajouter ou retirer un contrôle enfant, il faut utiliser la méthode InsertControl ou RemoveControl. Pour faire passer un contrôle enfant d'un parent à un autre, il suffit d'affecter la propriété Parent du contrôle, ce qui entraîne l'appel de RemoveControl pour le parent d'origine et de InsertControl pour le nouveau parent.

Voir aussi