Vcl.Graphics.TBitmap.Handle

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

Delphi

property Handle: HBITMAP read GetHandle write SetHandle;

C++

__property HBITMAP Handle = {read=GetHandle, write=SetHandle, nodefault};

プロパティ

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

説明

GDI ビットマップオブジェクトにアクセスするための Windows GDI ビットマップハンドルへのアクセスを提供します。

Handle プロパティを使用すると,ビットマップオブジェクトのハンドルが必要な Windows API 関数を呼び出すことができます。それぞれの関数にはビットマップハンドルの引数として Handle を渡します。

Handle は,ビットマップオブジェクトによってカプセル化された HBITMAP です。複数の TBitmap がこのハンドルを共有している場合は,HBITMAP がコピーされるのを避けるため,このハンドルを直接操作しないでください。

警告:  オブジェクトまたはルーチンにハンドルを与える際には,注意が必要です。受け取り側がビットマップハンドルの所有権を取得する(そしてビットマップハンドルを破棄する)場合は,TBitmap.::ReleaseHandle を呼び出します。

関連項目