Vcl.Forms.TCustomForm.OnClose

De RAD Studio API Documentation
Aller à : navigation, rechercher

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.

Voir aussi