QCloseEvent

La classe QCloseEvent contient des param�tres qui d�crivent un �v�nement de fermeture. Plus d'informations...

#include <QCloseEvent>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QEvent.

Description d�taill�e

La classe QCloseEvent contient des param�tres qui d�crivent un �v�nement de fermeture.

Les �v�nements de fermeture sont envoy�s aux widgets que l'utilisateur veut fermer, habituellement en cliquant sur « Fermer » de la barre des menus ou en cliquant sur le bouton X de la barre de titre. Ils sont aussi envoy�s quand vous appelez QWidget::close() pour fermer un widget directement par le programme.

Les �v�nements de fermeture contiennent un drapeau (flag) qui signale si le r�cepteur veut que le widget soit ferm� ou pas. Quand un widget accepte l'�v�nement de fermeture, il est cach� (et d�truit s'il a �t� cr�� avec le drapeau Qt::WA_DeleteOnClose). Si le widget refuse d'accepter l'�v�nement de fermeture, rien ne se passe. (Sous X11 il est possible que le gestionnaire de fen�tres force la fermeture de la fen�tre ; mais, au moment de la r�daction de cette page, nous ne connaissons pas de gestionnaire de fen�tres qui fait cela).

Le gestionnaire d'�v�nement QWidget::closeEvent() re�oit les �v�nements de fermeture. Son impl�mentation par d�faut accepte l'�v�nement de fermeture. Si vous ne voulez pas que votre widget soit cach� ou si vous voulez une gestion sp�ciale, vous devez r�impl�menter le gestionnaire d'�v�nement et utiliser la fonction ignore() sur cet �v�nement.

La m�thode closeEvent() dans l'exemple d'application montre un gestionnaire d'�v�nements de fermeture qui demande de sauvegarder un document avant de fermer.

Si vous voulez que le widget soit supprim� pendant sa fermeture, cr�ez-le avec le drapeau Qt:WA_DeleteOnClose. C'est tr�s utile pour les fen�tres ind�pendantes de premier niveau dans une application multi-fen�tres.

Les QObject �mettent le signal destroyed() quand ils sont d�truits.

Si la derni�re fen�tre de premier niveau est ferm�e, le signal QApplication::lastWindowClosed() est �mis.

La fonction isAccepted() retourne true si le r�cepteur de l'�v�nement a accept� de fermer le widget ; appelez accept() pour autoriser sa fermeture et appelez ignore() si le r�cepteur de cet �v�nement ne veut pas que le widget soit ferm�.

Voir �galement QWidget::close(), QWidget::hide(), QObject::destroyed(), QCoreApplication::exec(), QCoreApplication::quit() et QApplication::lastWindowClosed().

Fonctions membres

QCloseEvent::QCloseEvent ()

Construit un �v�nement de fermeture.

Voir aussi accept().

Remerciements

Merci � Adrien Morel pour la traduction, ainsi qu'� Jonathan Courtois, Thibaut Cuvelier et Maxime Gault pour la relecture !