Vcl.Controls.TWinControl.ControlAtPos

提供: RAD Studio API Documentation
移動先: 案内検索

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++)を返します。

関連項目