Vcl.Forms.TCustomForm.OnClose
Delphi
property OnClose: TCloseEvent read FOnClose write FOnClose stored IsForm;
C++
__property TCloseEvent OnClose = {read=FOnClose, write=FOnClose, stored=IsForm};
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
event | protected | Vcl.Forms.pas Vcl.Forms.hpp |
Vcl.Forms | TCustomForm |
Description
Se produit quand la fiche se ferme.
Utilisez l'événement OnClose pour effectuer des actions particulières quand la fiche se ferme. L'événement OnClose spécifie le gestionnaire d'événement à appeler quand une fiche va être fermée. Le gestionnaire spécifié par OnClose peut, par exemple, s'assurer que tous les champs d'une fiche de saisie ont un contenu correct avant d'autoriser la fermeture de la fiche.
Une fiche est fermée par la méthode Close ou si l'utilisateur choisit la commande Fermeture dans le menu système de la fiche.
Le type TCloseEvent pointe sur une méthode qui gère la fermeture d'une fiche. La valeur du paramètre Action détermine si la fiche se ferme effectivement. Les valeurs possibles de Action sont :
Valeur | Signification |
---|---|
caNone |
La fiche n'est pas autorisée à se fermer et rien ne se passe. |
caHide |
La fiche n'est pas fermée, juste cachée. L'application peut toujours accéder à la fiche. |
caFree |
La fiche est fermée et toute la mémoire allouée à la fiche est libérée. |
caMinimize |
La fiche est réduite, pas fermée. C'est l'action par défaut pour les fiches enfant MDI. |
Si une fiche est un enfant MDI alors que sa propriété BorderIcons a la valeur biMinimize, l'action par défaut est caMinimize. Si une fiche enfant MDI n'a pas ce paramètre, l'action par défaut est caNone, c'est-à-dire que rien ne se produit quand l'utilisateur tente de fermer la fiche.
Si une fiche est une fiche enfant SDI, l'action par défaut est caHide.
Pour fermer la fiche et la libérer dans un événement OnClose, affectez la valeur caFree à Action.
Remarque : Lorsque l'application se ferme, la fiche principale reçoit un événement OnClose, mais aucune fiche enfant ne reçoit l'événement OnClose.