Vcl.Controls.TWinControl.ControlAtPos

De RAD Studio API Documentation
Aller à : navigation, rechercher

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++).

Voir aussi