Vcl.Controls.TWinControl.DestroyHandle
Delphi
procedure DestroyHandle; virtual;
C++
virtual void __fastcall DestroyHandle();
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
protected | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TWinControl |
説明
コントロールを破棄せずにそのウィンドウを破棄します。
DestroyHandle メソッドを呼び出すと,コントロールをそのまま残してウィンドウを破棄できます。コントロールは,必要であればウィンドウを後で再作成できます。DestroyHandle メソッドは CreateHandle メソッドの正反対の処理です。アプリケーションはできるだけ CreateWnd や DestroyWnd などの低レベルメソッドを呼び出さずに,高レベルの CreateHandle と DestroyHandle を呼び出すようにしてください。
コントロールが TWinControl オブジェクトを子コントロールとして保持する場合,DestroyHandle メソッドは子コントロールの各 DestroyHandle メソッドを呼び出してから,DestroyWnd メソッドを呼び出してそれ自体のハンドルを破棄します。