Vcl.Controls.TMouse.Capture
Delphi
property Capture: HWND read GetCapture write SetCapture;
C++
__property HWND Capture = {read=GetCapture, write=SetCapture, nodefault};
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| property | public | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TMouse |
説明
マウスイベントを取り込むウィンドウのハンドルを指定します。
Capture プロパティを読み出すと，すべてのマウスメッセージを受け取るウィンドウのハンドルを取得できます。これは，ユーザーのマウスアクションに応答しているウィンドウです。
Capture プロパティをコントロールの Handle プロパティに設定すると，そのコントロールはマウスメッセージを「取り込む」ことができます。マウスを取り込んだウィンドウは，マウスを解放するまで，すべてのマウスメッセージを受け取ります。
通常，アプリケーションで Capture プロパティを明示的に設定する必要はありません。各コントロールがマウスクリックに応答して自動的にマウスを取り込みます。そして，入力されたマウスメッセージを OnMouseDown や OnMouseMove などのイベントに変換します。Capture プロパティを設定する必要があるのは，このデフォルト動作をオーバーライドする場合だけです。たとえば，マウスクリックに応答して子コントロールを作成するオブジェクトを記述する場合には，Capture プロパティを子コントロールの Handle プロパティに設定すると，マウスボタンが離されるまで，子コントロールが以降のマウスメッセージを受け取るようにすることができます。