API:Vcl.Forms.TCustomForm.DestroyHandle
Delphi
procedure DestroyHandle; override;
C++
virtual void __fastcall DestroyHandle();
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
protected | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TCustomForm |
Description
Supprime la fenêtre du contrôle sans supprimer le contrôle.
Vcl.Forms.TCustomForm.DestroyHandle hérite de Vcl.Controls.TWinControl.DestroyHandle. Tout le contenu en-dessous de cette ligne se réfère à Vcl.Controls.TWinControl.DestroyHandle.
Supprime la fenêtre du contrôle sans supprimer le contrôle.
Appelez DestroyHandle pour libérer la fenêtre en laissant le contrôle intact. Le contrôle peut ultérieurement recréer, si c'est nécessaire, la fenêtre. DestroyHandle est l'opération inverse de CreateHandle. Les applications doivent toujours, dans la mesure du possible, appeler les méthodes de haut niveau CreateHandle et DestroyHandle plutôt que d'utiliser les méthodes de bas niveau CreateWnd et DestroyWnd.
Si le contrôle a des objets TWinControl comme contrôles enfant, DestroyHandle appelle la méthode DestroyHandle de chacun d'entre eux avant d'appeler DestroyWnd pour supprimer son propre handle.