System.Classes.DeallocateHWnd

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

Delphi

procedure DeallocateHWnd(Wnd: HWND);

C++

extern DELPHI_PACKAGE void __fastcall DeallocateHWnd(HWND Wnd);

プロパティ

種類 可視性 ソース ユニット
procedure
function
public
System.Classes.pas
System.Classes.hpp
System.Classes System.Classes

説明

AllocateHWnd を使って作成されたウィンドウを解放します。

DeallocateHWnd を呼び出すと、AllocateHWnd 関数を使って作成されたウィンドウを解放することができます。 ウィンドウを解放することで、そこで消費されているシステム リソースを解放する必要があります。 対応する AllocateHWnd 呼び出しが行われたのと同じスレッドから DallocateHWnd を呼び出す必要があります。

Wnd パラメータは、解放するウィンドウのウィンドウ ハンドルです。 この値は、AllocateHWnd の呼び出し時に返されたハンドルと同じです。

警告:  ウィンドウ付きコントロールのハンドルに対して DeallocateHWnd を使用しないでください。 ウィンドウ付きコントロールでは、DestroyHandle という protected メソッドを使って自分自身のハンドルを解放することで、コントロールの整合性が常に保たれるようになっています。

関連項目

コード サンプル