Vcl.Controls.TWinControl.ControlAtPos

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TWinControl


Beschreibung

Gibt das untergeordnete Steuerelement zurück, das sich in diesem Steuerelement an der angegebenen Position befindet.

Mit ControlAtPos können Sie ermitteln, welches Steuerelement sich in diesem Steuerelement an der angegebenen Position befindet.

Wenn AllLevels False ist, dann gibt ControlAtPos ein direkt untergeordnetes Steuerelement zurück, d. h. einen der Einträge der Eigenschaft Controls, der dieses Steuerelement als Parent-Eigenschaft hat. Wenn AllLevels True ist, dann wird ein untergeordnetes Steuerelement aus einer beliebigen verschachtelten Ebene zurückgegeben.

Geben Sie die Position in Client-Koordinaten im Parameter Pos an. Pos kann sich irgendwo in den Grenzen des untergeordneten Steuerelements befinden. Es muss sich nicht um die linke obere Ecke handeln.

Der Parameter AllowDisabled bestimmt, ob bei der Suche nach Steuerelementen auch deaktivierte Steuerelemente berücksichtigt werden.

Der Parameter AllowWinControls bestimmt, ob Nachkommen von TWinControl bei der Suche nach dem untergeordneten Steuerelement berücksichtigt werden.

Wenn an der angegebenen Position kein Steuerelement gefunden wird, das den Parametern AllowDisabled und AllowWinControls entspricht, gibt ControlAtPos nil (Delphi) bzw. NULL (C++) zurück.

Siehe auch