Vcl.Forms.TCustomForm.DestroyHandle
Delphi
procedure DestroyHandle; override;
C++
virtual void __fastcall DestroyHandle(void);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
procedure function |
protected | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TCustomForm |
Beschreibung
Gibt das Fenster des Steuerelements frei, nicht jedoch das Steuerelement.
Vcl.Forms.TCustomForm.DestroyHandle erbt von Vcl.Controls.TWinControl.DestroyHandle. Der folgende Inhalt bezieht sich auf Vcl.Controls.TWinControl.DestroyHandle.
Gibt das Fenster des Steuerelements frei, nicht jedoch das Steuerelement.
Rufen Sie DestroyHandle auf, um das Fenster aus dem Speicher zu entfernen, ohne das Steuerelement zu löschen. Das Steuerelement kann das Fenster später neu erstellen, wenn dies erforderlich ist. DestroyHandle ist das Gegenstück zu CreateHandle. Anwendungen sollten die High-Level-Methoden CreateHandle und DestroyHandle anstelle der Methoden CreateWnd und DestroyWnd verwenden, sofern dies möglich ist.
Hat das Steuerelement TWinControl-Objekte als untergeordnete Steuerelemente, ruft DestroyHandle die DestroyHandle-Methode jedes dieser Objekte auf, bevor durch einen Aufruf von DestroyWnd das eigene Handle freigegeben wird.