Vcl.Controls.TWinControl.DestroyHandle
Delphi
procedure DestroyHandle; virtual;
C++
virtual void __fastcall DestroyHandle();
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
protected | Vcl.Controls.pas Vcl.Controls.hpp |
Vcl.Controls | TWinControl |
Description
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.