Vcl.Forms.TCustomForm.DestroyHandle
Delphi
procedure DestroyHandle; override;
C++
virtual void __fastcall DestroyHandle(void);
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
protected | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TCustomForm |
説明
コントロールを破棄せずにそのウィンドウを破棄します。 {{#multireplace:Vcl.Forms.TCustomForm.DestroyHandle|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:Vcl.Controls.TWinControl.DestroyHandle|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:Vcl.Controls.TWinControl.DestroyHandle|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。
コントロールを破棄せずにそのウィンドウを破棄します。
DestroyHandle メソッドを呼び出すと，コントロールをそのまま残してウィンドウを破棄できます。コントロールは，必要であればウィンドウを後で再作成できます。DestroyHandle メソッドは CreateHandle メソッドの正反対の処理です。アプリケーションはできるだけ CreateWnd や DestroyWnd などの低レベルメソッドを呼び出さずに，高レベルの CreateHandle と DestroyHandle を呼び出すようにしてください。
コントロールが TWinControl オブジェクトを子コントロールとして保持する場合，DestroyHandle メソッドは子コントロールの各 DestroyHandle メソッドを呼び出してから，DestroyWnd メソッドを呼び出してそれ自体のハンドルを破棄します。