Vcl.Controls.TWinControl.ControlAtPos
Delphi
function ControlAtPos(const Pos: TPoint; AllowDisabled: Boolean;
AllowWinControls: Boolean = False; AllLevels: Boolean = False): TControl;
C++
TControl* __fastcall ControlAtPos(const System::Types::TPoint &Pos, bool AllowDisabled, bool AllowWinControls = false, bool AllLevels = false);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TWinControl |
Description
Renvoie le contrôle enfant occupant la position spécifiée à l'intérieur du contrôle.
La méthode ControlAtPos permet de connaître le contrôle enfant situé à l'emplacement spécifié à l'intérieur du contrôle.
Lorsque AllLevels vaut False, ControlAtPos renvoie un enfant immédiat de ce contrôle ; c'est-à-dire une entrée de la propriété Controls dont la propriété Parent désigne ce contrôle. Lorsque AllLevels vaut True, il s'agit d'un enfant de n'importe quel niveau imbriqué.
Spécifiez la position (en coordonnées du client) en tant que valeur du paramètre Pos. Pos peut se trouver n'importe où à l'intérieur des limites du contrôle enfant, pas seulement dans le coin supérieur gauche.
Le paramètre AllowDisabled détermine si la recherche des contrôles inclut les contrôles désactivés.
Le paramètre AllowWinControls détermine si les descendants de TWinControl sont pris en compte lors de la recherche du contrôle enfant.
S'il n'existe aucun contrôle correspondant aux paramètres AllowDisabled et AllowWinControls à l'emplacement spécifié, ControlAtPos renvoie nil (Delphi) ou NULL (C++).