Vcl.Controls.TWinControl.DestroyHandle

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

Delphi

procedure DestroyHandle; virtual;

C++

virtual void __fastcall DestroyHandle();

プロパティ

種類 可視性 ソース ユニット
procedure
function
protected
Vcl.Controls.pas
Vcl.Controls.hpp
Vcl.Controls TWinControl

説明

コントロールを破棄せずにそのウィンドウを破棄します。

DestroyHandle メソッドを呼び出すと,コントロールをそのまま残してウィンドウを破棄できます。コントロールは,必要であればウィンドウを後で再作成できます。DestroyHandle メソッドは CreateHandle メソッドの正反対の処理です。アプリケーションはできるだけ CreateWndDestroyWnd などの低レベルメソッドを呼び出さずに,高レベルの CreateHandleDestroyHandle を呼び出すようにしてください。

コントロールが TWinControl オブジェクトを子コントロールとして保持する場合,DestroyHandle メソッドは子コントロールの各 DestroyHandle メソッドを呼び出してから,DestroyWnd メソッドを呼び出してそれ自体のハンドルを破棄します。

関連項目