API:Vcl.Forms.TCustomForm.DestroyHandle

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi