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);
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TWinControl |
説明
コントロール内の指定された位置に配置された子コントロールを返します。
ControlAtPos を使用すると、コントロール内の指定された位置に、どの子コントロールがあるかどうかを判断します。
AllLevels が False
の場合、ControlAtPos は、コントロールの直属の子を返します。つまり、このコントロールを Parent プロパティに持つ、Controls プロパティの要素群の 1 つを返します。AllLevels が True
の場合、任意の入れ子レベルの子が返されます。
クライアント座標の位置を、Pos パラメータの値として指定します。位置は、左上隅だけでなく、子コントロールの境界内のどこでも構いません。
AllowDisabled パラメータは、コントロールの検索に無効なコントロールが含まれるかどうかを決定します。
AlwaysWinControls パラメータは、子コントロールを検索するときに TWinControl の子孫を考慮するかどうかを決定します。
指定された位置に AllowDisabled および AllowWinControls パラメータに一致するコントロールがない場合、ControlAtPos は nil (Delphi)または NULL (C++)を返します。