Vcl.Forms.TCustomForm.DestroyHandle

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

Delphi

procedure DestroyHandle; override;

C++

virtual void __fastcall DestroyHandle();

プロパティ

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

説明

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

Vcl.Forms.TCustomForm.DestroyHandle は Vcl.Controls.TWinControl.DestroyHandle を継承しています。以下の内容はすべて Vcl.Controls.TWinControl.DestroyHandle を参照しています。

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

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

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

関連項目