Vcl.Controls.TWinControl.Handle

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

Delphi

property Handle: HWND read GetHandle;

C++

__property HWND Handle = {read=GetHandle, nodefault};

プロパティ

種類 可視性 ソース ユニット
property public
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TWinControl


説明

基盤とする Windows 画面オブジェクトへのアクセスを、コントロールに提供します。

Handle プロパティは、基盤とする Microsoft Windows 画面オブジェクトへのウインドウ ハンドルを返します。Handle プロパティを使用すると、VCL API を介さずに直接基盤とするウィンドウへアクセスすることができます。

コンポーネントの生成時やストリーミング時には、Handle プロパティを参照しないでください。基盤となるウィンドウは、最初に Handle プロパティが参照されるまで存在しません。これが発生すると、HandleNeeded メソッドが自動的に呼び出されます。

Handle は、読み取り専用プロパティです。

メモ: Win64 上では、HANDLE 型のサイズが 64 ビットに変更されました。ただし OLE_HANDLE は例外で、Win64 上でも 32 ビット Long となっています。これにより、OLE_HANDLE と他の HANDLE 型を変換可能であることを前提としたコードを記述している場合、それらを変更しなければなりません。http://stackoverflow.com/questions/401812/what-is-the-proper-way-to-cast-from-an-ole-handle-to-an-hicon も参照してください。

関連項目


コード サンプル