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. 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.
La position, exprimée en coordonnées du client, est indiquée par la valeur du paramètre Pos. Pos peut être situé n'importe où dans les limites du contrôle enfant, pas uniquement son 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 considérés lorsqu'ils cherchent le 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++).