QMessageBox

La classe QMessageBox fournit une bo�te de dialogue modale pour informer l'utilisateur ou lui poser une question et recevoir une r�ponse. Plus d'informations...

 #include <QMessageBox>

H�ritage

H�rite de QDialog.

Description d�taill�e

La classe QMessageBox fournit une bo�te de dialogue modale pour informer l'utilisateur ou lui poser une question et recevoir une r�ponse.

Une QMessageBox (bo�te de message) affiche un texte principal pour alerter l'utilisateur d'une situation, un texte informatif pour expliquer d'avantage l'alerte ou pour poser une question � l'utilisateur et un texte d�taill� optionnel pour fournir encore plus d'informations si l'utilisateur le demande. Une bo�te de message peut �galement afficher une ic�ne et des boutons standard pour accepter la r�ponse de l'utilisateur.

Deux API pour utiliser QMessageBox sont fournies, l'API bas�e sur les propri�t�s et les fonctions statiques. L'appel d'une des fonctions statiques est l'approche la plus simple, mais elle est moins flexible que d'utiliser l'API bas�e sur les propri�t�s et le r�sultat contient moins d'informations. Il est recommand� d'utiliser l'API bas�e sur les propri�t�s.

L'API bas�e sur les propri�t�s

Pour utiliser l'API bas�e sur les propri�t�s, construisez une instance de QMessageBox, d�finissez les propri�t�s d�sir�es et appelez exec() pour afficher le message. La configuration la plus simple est de d�finir uniquement la propri�t� message text.

 QMessageBox msgBox;
 msgBox.setText("Le document a �t� modifi�.");
 msgBox.exec();

L'utilisateur doit cliquer sur le bouton OK pour fermer la bo�te de dialogue. Le reste de la l'interface utilisateur est bloqu� jusqu'� ce que la bo�te de dialogue soit ferm�e.

Une meilleure approche que de simplement avertir l'utilisateur d'un �v�nement est d'�galement lui demander ce qu'il veut faire. Stockez la question dans la propri�t� texte informatif et d�finissez la propri�t� boutons standard en fonction des r�ponses possibles de l'utilisateur. Les boutons sont sp�cifi�s par des combinaisons de valeurs de StandardButtons utilisant l'op�rateur bit � bit OU. L'ordre d'affichage des boutons d�pend de la plateforme. Par exemple, sur Windows, Enregistrer est affich� � la gauche de Annuler, alors que sur Mac OS, l'ordre est invers�.

Marquez un de vos boutons standard comme �tant le bouton par d�faut.

 QMessageBox msgBox;
 msgBox.setText("Le document a �t� modifi�.");
 msgBox.setInformativeText("Voulez-vous enregistrer les changements ?");
 msgBox.setStandardButtons(QMessageBox::Save | QMessageBox::Discard | QMessageBox::Cancel);
 msgBox.setDefaultButton(QMessageBox::Save);
 int ret = msgBox.exec();

Ceci est l'approche recommand�e dans Directives Mac OS X. Des directives similaires s'appliquent pour d'autres plateformes, mais notez les diff�rentes mani�res dont le texte informatif est pr�sent� sur diff�rentes plateformes.

Le slot exec() retourne la valeur StandardButtons du bouton qui a �t� cliqu�.

 switch (ret) {
   case QMessageBox::Save:
       // Clic sur Enregistrer
       break;
   case QMessageBox::Discard:
       // Clic sur Ne pas enregistrer
       break;
   case QMessageBox::Cancel:
       // Clic sur Annuler
       break;
   default:
       // ne doit pas se produire
       break;
 }

Pour donner � l'utilisateur plus d'informations pour l'aider � r�pondre � la question, d�finissez la propri�t� texte d�taill�. Si la propri�t� detailed text est d�finie, le bouton Afficher les d�tails... sera affich�.

Cliquer sur le bouton Afficher les d�tails... affiche le texte d�taill�.

Texte enrichi et propri�t� de format de texte

La propri�t� texte d�taill� est toujours interpr�t�e comme du texte brut. Les propri�t�s texte principal et texte informatif peuvent �tre soit du texte brut soit du texte enrichi. Ces cha�nes de caract�res sont interpr�t�es en fonction de la propri�t� format de texte. La valeur par d�faut est auto-text.

Notez que pour certains textes bruts contenant des m�tacaract�res XML, le test de d�tection de texte enrichi (auto-text) peut �chouer et causer l'interpr�tation incorrecte du texte brut comme du texte enrichi. Dans ces rares cas, utilisez Qt::convertFromPlainText() pour convertir votre texte brut en un texte enrichi visuellement �quivalent ou sp�cifiez explicitement la propri�t� format de texte avec setTextFormat().

Niveaux de gravit� et les propri�t�s ic�ne et pixmap

QMessageBox g�re quatre niveaux de gravit� de message ou types de message, qui diff�rent uniquement par l'ic�ne pr�d�fini qu'ils affichent. Sp�cifiez un des quatre types de message pr�d�finis en d�finissant la propri�t� icon � l'une des ic�nes pr�d�finies. Utilisez comme guide les r�gles suivantes :

	Question	Pour poser une question durant les op�rations normales.
	Information	Pour donner une information � propos des op�rations normales.
	Warning	Pour signaler les erreurs non critiques.
	Critical	Pour signaler les erreurs critiques.

Les ic�nes pr�d�finies ne sont pas d�finies par QMessageBox mais sont fournies par le style. La valeur par d�faut est No Icon. Pour le reste, les bo�tes de message sont les m�mes dans tous les cas. Lors de l'utilisation d'une ic�ne standard, utilisez l'une de celles recommand�es dans le tableau ou utilisez l'une de celles recommand�es par les directives de style de votre plateforme. Si aucune des ic�nes standard ne convient pour votre bo�te de message, vous pouvez utiliser une ic�ne personnalis�e en d�finissant la propri�t� pixmap d'ic�ne plut�t que la propri�t� ic�ne.

En r�sum�, pour sp�cifier une ic�ne, utilisez soit setIcon() pour l'une des quatre ic�nes standard, soit setIconPixmap() pour une ic�ne personnalis�e.

L'API des fonctions statiques

Construire les bo�tes de message avec l'API des fonctions statiques, bien que pratique, est moins flexible que d'utiliser l'API bas�e sur les propri�t�s, parce que les signatures des fonctions statiques n'ont pas de param�tres pour indiquer les propri�t�s texte informatif et texte d�taill�. Une mani�re de contourner cette absence est d'utiliser le param�tre title comme texte principal de la bo�te de message et le param�tre text comme texte d'information. Comme ceci a l'inconv�nient �vident de rendre la bo�te de message moins lisible, les directives de la plateforme le d�conseillent. Le Microsoft Windows User Interface Guidelines recommande d'utiliser le nom de l'application en tant que titre de fen�tre, ce qui signifie que si vous avez un texte d'information en plus de votre texte principal, vous devrez le concat�ner au param�tre text.

Notez que dans les signatures des fonctions statiques, les param�tres de boutons ont chang�, ils sont maintenant utilis�s pour d�finir les boutons standard et le bouton par d�faut.

Des fonctions statiques existent pour la cr�ation des bo�tes de message information(), question(), warning() et critical().

 int ret = QMessageBox::warning(this, tr("My Application"),
                                tr("Le document a �t� modifi�.\n"
                                   "Voulez-vous enregistrer les changements ?"),
                                QMessageBox::Save | QMessageBox::Discard
                                | QMessageBox::Cancel,
                                QMessageBox::Save);

L'exemple Bo�tes de dialogue standard montre comment utiliser QMessageBox et les autres bo�tes de dialogue de Qt.

Utilisation avanc�e

Si les boutons standard ne sont pas assez flexibles pour votre bo�te de message, vous pouvez utiliser la variante de la m�thode addButton() prenant en param�tres un texte et un r�le de bouton pour ajouter des boutons personnalis�s. Le ButtonRole est utilis� par QMessageBox pour d�terminer l'ordre des boutons � l'�cran (lequel varie en fonction de la plateforme). Vous pouvez tester la valeur de clickedButton() apr�s un appel � exec(). Par exemple,

 QMessageBox msgBox;
 QPushButton *connectButton = msgBox.addButton(tr("Connect"), QMessageBox::ActionRole);
 QPushButton *abortButton = msgBox.addButton(QMessageBox::Abort);
 
 msgBox.exec();
 
 if (msgBox.clickedButton() == connectButton) {
     // connect
 } else if (msgBox.clickedButton() == abortButton) {
     // abort
 }

Les touches par d�faut et d?�chappement

Le bouton par d�faut(c'est-�-dire le bouton activ� lorsque la touche Entr�e est appuy�e) peut �tre sp�cifi� en utilisant setDefaultButton(). Si aucun bouton par d�faut n'est sp�cifi�, QMessageBox tente d'en trouver un en se basant sur le r�le des boutons utilis�s.

Le bouton d'�chappement (le bouton activ� lorsque la touche Echap est appuy�e) peut �tre sp�cifi� en utilisant setEscapeButton(). Si aucun bouton d'�chappement n'est sp�cifi�, QMessageBox tente d'en trouver un en suivant les r�gles suivantes :

1. S'il n'y a qu'un seul bouton, c'est ce bouton qui est activ� lors d'un appui sur Echap ;
2. S'il y a un bouton Annuler, c'est ce bouton qui est activ� lors d'un appui sur Echap ;
3. S'il n'y a qu'un seul bouton avec soit le r�le Reject, soit le r�le No role, c'est ce bouton qui est activ� lors d'un appui sur Echap.

Lorsque le bouton d'�chappement ne peut �tre d�termin� en utilisant ces r�gles, l'appui sur la touche Echap est sans effet.

Voir aussi QDialogButtonBox, GUI Design Handbook: Message Box, Exemple de bo�tes de dialogue standard et Exemple d'application.

Type

enum QMessageBox::ButtonRole

Cette �num�ration d�crit les r�les qui peuvent �tre utilis�s pour d�crire les boutons. Les combinaisons de ces r�les sous forme de drapeaux sont utilis�es pour d�crire les diff�rents aspects de leur comportement.

Voir aussi StandardButton.

enum QMessageBox::Icon

Cette �num�ration peut prendre les valeurs suivantes :

enum QMessageBox::StandardButtonflags QMessageBox::StandardButtons

Ces �num�rations d�crivent les drapeaux pour les boutons standard. Chaque bouton poss�de un r�le d�fini.

Les valeurs suivantes sont obsol�tes :

Cette �num�ration a �t� introduite ou modifi�e dans Qt 4.2.

Le type StandardButtons est un typedef pour QFlags<StandardButton>. Il contient une combinaison OU de valeurs de StandardButton.

Voir aussi ButtonRole et standardButtons.

Propri�t�s

detailedText : QString

Cette propri�t� contient le texte qui doit �tre affich� dans la zone de d�tail.

Le texte sera interpr�t� comme un texte brut.

Par d�faut, cette propri�t� contient une cha�ne vide.

Cette classe a �t� introduite dans Qt 4.2.

Fonction d'acc�s

QString detailedText () const

void setDetailedText ( const QString & text )

Voir aussi QMessageBox::text and QMessageBox::informativeText.

icon : Icon

Cette propri�t� contient l'ic�ne de la bo�te de dialogue.

L'ic�ne de la bo�te de message peut �tre sp�cifi� avec l'une de ces valeurs :

• QMessageBox::NoIcon ;
• QMessageBox::Question ;
• QMessageBox::Information ;
• QMessageBox::Warning ;
• QMessageBox::Critical.

La valeur par d�faut est QMessageBox::NoIcon.

La pixmap utilis�e pour afficher l'ic�ne actuelle d�pend du style courant . Vous pouvez aussi sp�cifier une pixmap personnalis�e en tant qu'ic�ne en utilisant la propri�t� pixmap de l'ic�ne.

Fonction d'acc�s

Icon icon () const

void setIcon ( Icon )

Voir aussi iconPixmap.

iconPixmap : QPixmap

Cette propri�t� contient l'ic�ne courante.

L'ic�ne utilis�e par la bo�te de message. Notez qu'il est souvent difficile de dessiner une pixmap adapt�e � tous les styles d'interface utilisateur ; vous aurez peut-�tre � fournir une pixmap diff�rente pour chaque plateforme.

Par d�faut, cette propri�t� n'est pas d�finie.

Fonction d'acc�s

QPixmap iconPixmap () const

void setIconPixmap ( const QPixmap & pixmap )

Voir aussi icon.

informativeText : QString

Cette propri�t� contient le texte d'information qui fournit une description plus compl�te pour le message.

Le texte d'information peut �tre utilis� pour d�velopper le text() afin de fournir plus d'informations � l'utilisateur. Sur Mac, ce texte appara�t en petite police syst�me sous le text(). Sur les autres syst�mes, il est simplement ajout� au texte existant.

Par d�faut, cette propri�t� contient une cha�ne vide.

Cette classe a �t� introduite dans Qt 4.2.

Fonction d'acc�s

QString informativeText () const

void setInformativeText ( const QString & text )

Voir aussi QMessageBox::text et QMessageBox::detailedText.

standardButtons : StandardButtons

Cette propri�t� contient la collection de boutons standard de la bo�te de message.

Cette propri�t� contr�le quels boutons standard sont utilis�s par la bo�te de message.

Par d�faut, cette propri�t� ne contient aucun des boutons standard.

Cette classe a �t� introduite dans Qt 4.2.

Fonction d'acc�s

StandardButtons standardButtons () const

void setStandardButtons ( StandardButtons buttons )

Voir aussi addButton().

text : QString

Cette propri�t� contient le texte � afficher dans la bo�te de message.

Le texte sera interpr�t� soit comme du texte brut, soit comme du texte enrichi, en fonction du format de texte sp�cifi� par (QMessageBox::textFormat). Par d�faut, le format est Qt::AutoText, c'est-�-dire que la bo�te de message tentera de d�tecter automatiquement le format du texte.

La valeur par d�faut de cette propri�t� est une cha�ne vide.

Fonction d'acc�s

QString text () const

void setText ( const QString & text )

Voir aussi textFormat, QMessageBox::informativeText et QMessageBox::detailedText.

textFormat : Qt::TextFormat

Cette propri�t� contient le format du texte affich�.

Le format du texte courant utilis� dans la bo�te de message. Voir l'�num�ration Qt::TextFormat pour une explication des options possibles.

Le format par d�faut est Qt::AutoText.

Fonction d'acc�s

Qt::TextFormat textFormat () const

void setTextFormat ( Qt::TextFormat format )

Voir aussi setText().

Fonctions membres

QMessageBox::QMessageBox ( QWidget * parent = 0 )

Construit une bo�te de message sans texte ni bouton. parent est pass� au constructeur de QDialog

Sur Mac OS X, si vous voulez faire appara�tre votre bo�te de message comme une Qt::Sheet (feuille) de son parent, sp�cifiez Qt::WindowModal comme modalit� de la bo�te de message ou utilisez open(). Sinon, la bo�te de message sera une boite de dialogue standard.

QMessageBox::QMessageBox ( Icon icon, const QString & title, const QString & text, StandardButtons buttons = NoButton, QWidget * parent = 0, Qt::WindowFlags f = Qt::Dialog | Qt::MSWindowsFixedSizeDialogHint )

Construit une bo�te de message avec l'ic�ne icon, le titre title et les boutons standard buttons. Des boutons standard ou personnalis�s peuvent �tre ajout�s � tout moment en utilisant addButton(). Les arguments parent et f sont pass�s au constructeur de QDialog.

La bo�te de message est une bo�te de dialogue modale � l'application.

Sur Mac OS X, si parent ne vaut pas 0 et que vous voulez faire appara�tre votre bo�te de message comme une Qt::Sheet de son parent, sp�cifiez Qt::WindowModal comme modalit� de la bo�te de message (valeur par d�faut). Sinon, la bo�te de message sera une bo�te de dialogue standard.

Voir aussi setWindowTitle(), setText(), setIcon() et setStandardButtons().

QMessageBox::~QMessageBox ()

D�truit la bo�te de message.

void QMessageBox::about ( QWidget * parent, const QString & title, const QString & text ) [static]

Affiche une simple bo�te de message « � propos » avec le titre title et le texte text. Le parent de la bo�te de dialogue est parent.

about() regarde dans quatre emplacement pour trouver un ic�ne adapt� :

1. Il pr�f�rera parent->icon() s'il existe ;
2. Sinon, il tentera celui du widget de plus haut niveau contenant parent ;
3. S'il �choue, il tentera celui de la fen�tre active ;
4. En dernier recours, il utilisera l'ic�ne d'information.

La bo�te de dialogue « � propos » poss�de un seul bouton « OK ». Sur Mac OS X, la bo�te de dialogue « � propos » est modale � la fen�tre ; sur les autres plateformes elle est actuellement modale � l'application.

Voir aussi QWidget::windowIcon() et QApplication::activeWindow().

void QMessageBox::aboutQt ( QWidget * parent, const QString & title = QString() ) [static]

Affiche une simple bo�te de message � propos de Qt avec le titre title et centr� sur parent (si parent ne vaut pas 0). Le message inclut le num�ro de version de Qt utilis�e par l'application.

C'est tr�s utile pour l'inclusion dans le menu Aide de l'application, comme montr� dans l'exemple Menus.

QApplication fournit cette fonctionnalit� sous forme d'un slot.

Sur Mac OS X, la bo�te de dialogue « � propos » est modale � la fen�tre ; sur les autres plateformes elle est actuellement modale � l'application.

Voir aussi QApplication::aboutQt().

void QMessageBox::addButton ( QAbstractButton * button, ButtonRole role )

Ajoute le bouton button � la bo�te de message avec le role sp�cifi�.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi removeButton(), button() et setStandardButtons().

QPushButton * QMessageBox::addButton ( const QString & text, ButtonRole role )

Il s'agit d'une fonction surcharg�e.

Cr�e un bouton avec le texte text, l'ajoute � la bo�te de message avec le role sp�cifi� et le retourne.

Cette fonction a �t� introduite dans Qt 4.2.

QPushButton * QMessageBox::addButton ( StandardButton button )

Il s'agit d'une fonction surcharg�e.

Ajoute un bouton standard button � la bo�te de message si cette op�ration est valide, et retourne le bouton.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi setStandardButtons().

QAbstractButton * QMessageBox::button ( StandardButton which ) const

Retourne un pointeur correspondant au bouton standard which ou 0 si le bouton standard n'existe pas dans la bo�te de message.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi standardButtons et standardButton().

void QMessageBox::buttonClicked ( QAbstractButton * button ) [signal]

Ce signal est �mis d�s qu'un bouton est cliqu� dans le QMessageBox. Le bouton qui a �t� cliqu� est retourn� dans bouton.

ButtonRole QMessageBox::buttonRole ( QAbstractButton * button ) const

Retourne le r�le du bouton pour le bouton button sp�cifi�. Cette fonction retourne InvalidRole si button vaut 0 ou s'il n'a pas �t� ajout� � la bo�te de message.

Cette fonction a �t� introduite dans Qt 4.5.

Voir aussi buttons() and addButton().

QList<QAbstractButton *> QMessageBox::buttons () const

Retourne une liste de tous les boutons qui ont �t� ajout�s � la bo�te de message.

Cette fonction a �t� introduite dans Qt 4.5.

Voir aussi buttonRole(), addButton() et removeButton().

void QMessageBox::changeEvent ( QEvent * ev ) [virtual protected]

R�impl�mentation de QWidget::changeEvent().

QAbstractButton * QMessageBox::clickedButton () const

Retourne le bouton qui a �t� cliqu� par l'utilisateur ou 0 si l'utilisateur appuie sur la touche Echap et qu'il n'y a pas de bouton d'�chappement.

Si exec() n'a pas encore �t� appel�e, retourne 0.

Exemple:

 QMessageBox messageBox(this);
 QAbstractButton *disconnectButton =
       messageBox.addButton(tr("Disconnect"), QMessageBox::ActionRole);
 ...
 messageBox.exec();
 if (messageBox.clickedButton() == disconnectButton) {
     ...
 }

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi standardButton() et button().

void QMessageBox::closeEvent ( QCloseEvent * e ) [virtual protected]

R�impl�mentation de QWidget::closeEvent().

StandardButton QMessageBox::critical ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton ) [static]

Ouvre une bo�te de message critique avec le titre sp�cifi� par title et le texte text. Les boutons standard buttons sont ajout�s � la bo�te de message. defaultButton sp�cifie le bouton utilis� lors d'un appui sur la touche Entr�e. defaultButton doit faire r�f�rence � un bouton qui fait partie de buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisira automatiquement une valeur par d�faut appropri�e.

Retourne l'identit� du bouton standard cliqu�. Si Echap a �t� appuy�e, retourne le bouton d'�chappement.

La bo�te de message est une bo�te de dialogue de type modale � l'application.

Attention : ne d�truisez pas parent durant l'ex�cution de la bo�te de dialogue. Si vous voulez le faire, vous devez cr�er la bo�te de dialogue vous-m�me en utilisant un des constructeurs de QMessageBox.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi question(), warning() et information().

QPushButton * QMessageBox::defaultButton () const

Retourne le bouton qui devrait �tre le bouton par d�faut. Retourne 0 si aucun bouton par d�faut n'a �t� sp�cifi�.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi setDefaultButton(), addButton() et QPushButton::setDefault().

QAbstractButton * QMessageBox::escapeButton () const

Retourne le bouton qui sera activ� lors d'un appui sur la touche d'�chappement.

Par d�faut, QMessageBox tente de d�tecter automatiquement un bouton d'�chappement comme suit :

1. S'il n'y a qu'un seul bouton, ce sera le bouton d'�chappement.
2. S'il y a un bouton Annuler, il sera le bouton d'�chappement.
3. Sur Max OS X uniquement, s'il y a exactement un bouton avec le r�le QMessageBox::RejectRole, ce sera le bouton d'�chappement.

Lorsqu'aucun bouton d'�chappement ne peut �tre automatiquement d�tect�, un appui sur Echap n'a aucun effet.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi setEscapeButton() et addButton().

bool QMessageBox::event ( QEvent * e ) [virtual protected]

R�impl�mentation de QObject::event().

int QMessageBox::exec () [slot]

Affiche la bo�te de message en tant que bo�te de dialogue modale, bloquante jusqu'� ce que l'utilisateur la ferme.

Lorsque cette fonction est utilis�e sur un QMessageBox avec des boutons standard, elle retourne une valeur de StandardButton indiquant le bouton standard qui a �t� cliqu�. Lorsqu'elle est utilis�e sur un QMessageBox avec des boutons personnalis�s, cette fonction retourne une valeur opaque ; utilisez clickedButton() pour d�terminer quel bouton a �t� cliqu�.

Les utilisateurs ne peuvent interagir avec aucune autre fen�tre de la m�me application jusqu'� ce qu'ils ferment la bo�te de dialogue, soit en cliquant sur un bouton, soit en utilisant un m�canisme fourni par le syst�me de fen�tre.

Voir aussi show() et result().

StandardButton QMessageBox::information ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton ) [static]

Ouvre une bo�te de message d'information avec le titre sp�cifi� par title et le texte text. Les boutons standard buttons sont ajout�s � la bo�te de message. defaultButton sp�cifie le bouton utilis� lors d'un appui sur la touche Entr�e. defaultButton doit faire r�f�rence � un bouton qui fait partie de buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisira automatiquement une valeur par d�faut appropri�e.

Retourne l'identit� du bouton standard cliqu�. Si Echap a �t� press�e, retourne le bouton d'�chappement.

La bo�te de message est une bo�te de dialogue de type modale � l'application.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi question(), warning() et critical().

void QMessageBox::keyPressEvent ( QKeyEvent * e ) [virtual protected]

R�impl�mentation de QWidget::keyPressEvent().

void QMessageBox::open ( QObject * receiver, const char * member )

Il s'agit d'une fonction surcharg�e.

Ouvre une bo�te de dialogue et connecte ses signaux finished() ou buttonClicked() au slot sp�cifi� par receiver et member. Si le premier param�tre du slot dans member est un pointeur, la connexion est vers buttonClicked(), sinon elle est vers finished().

Le signal sera d�connect� du slot d�s que la bo�te de dialogue sera ferm�e.

StandardButton QMessageBox::question ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton ) [static]

Ouvre une bo�te de message d'information avec le titre sp�cifi� par title et le texte text. Les boutons standard buttons sont ajout�s � la bo�te de message. defaultButton sp�cifie le bouton utilis� lors d'un appui sur la touche Entr�e. defaultButton doit faire r�f�rence � un bouton qui fait partie de buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisira automatiquement une valeur par d�faut appropri�e.

Retourne l'identit� du bouton standard cliqu�. Si Echap a �t� press�e, retourne le bouton d'�chappement.

La bo�te de message est une bo�te de dialogue de type modale � l'application.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi information(), warning() et critical().

void QMessageBox::removeButton ( QAbstractButton * button )

Retire le bouton button des boutons de la bo�te de dialogue sans le d�truire.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi addButton() et setStandardButtons().

void QMessageBox::resizeEvent ( QResizeEvent * event ) [virtual protected]

R�impl�mentation de QWidget::resizeEvent().

void QMessageBox::setDefaultButton ( QPushButton * button )

D�finit button comme bouton par d�faut de la bo�te de message.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi defaultButton(), addButton() et QPushButton::setDefault().

void QMessageBox::setDefaultButton ( StandardButton button )

D�finit button comme bouton par d�faut de la bo�te de message.

Cette fonction a �t� introduite dans Qt 4.3.

Voir aussi addButton() and QPushButton::setDefault().

void QMessageBox::setEscapeButton ( QAbstractButton * button )

D�finit button comme bouton � activer lors d'un appui sur la touche Echap.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi escapeButton(), addButton() et clickedButton().

void QMessageBox::setEscapeButton ( StandardButton button )

D�finit button comme bouton � activer lors d'un appui sur la touche Echap.

Cette fonction a �t� introduite dans Qt 4.3.

Voir aussi addButton() et clickedButton().

void QMessageBox::setVisible ( bool visible ) [virtual]

R�impl�mentation de QWidget::setVisible().

void QMessageBox::setWindowModality ( Qt::WindowModality windowModality )

Cette fonction masque QWidget::setWindowModality().

D�finit la modalit� de la bo�te de message � windowModality.

Sur Mac OS X, si la modalit� est d�finie � Qt::WindowModal et que la bo�te de dialogue a un parent, elle sera un Qt::Sheet, sinon elle sera une bo�te de dialogue standard.

Cette fonction a �t� introduite dans Qt 4.2.

void QMessageBox::setWindowTitle ( const QString & title )

Cette fonction masque QWidget::setWindowTitle().

D�finit le titre de la bo�te de message � title. Sur Mac OS X, le titre de la fen�tre est ignor� (comme requis par les directives de Mac OS X).

Cette fonction a �t� introduite dans Qt 4.2.

void QMessageBox::showEvent ( QShowEvent * e ) [virtual protected]

R�impl�mentation de QWidget::showEvent().

StandardButton QMessageBox::standardButton ( QAbstractButton * button ) const

Retourne la valeur de l'�num�ration de bouton standard correspondant � button ou NoButton, si le bouton indiqu� n'est pas un bouton standard.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi button() et standardButtons().

StandardButton QMessageBox::warning ( QWidget * parent, const QString & title, const QString & text, StandardButtons buttons = Ok, StandardButton defaultButton = NoButton ) [static]

Ouvre une bo�te de message d'avertissement avec le titre sp�cifi� par title et le texte text. Les boutons standard buttons sont ajout�s � la bo�te de message. defaultButton sp�cifie le bouton utilis� lors d'un appui sur la touche Entr�e. defaultButton doit faire r�f�rence � un bouton qui fait partie de buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisira automatiquement une valeur par d�faut appropri�e.

Retourne l'identit� du bouton standard cliqu�. Si Echap a �t� press�e, retourne le bouton d'�chappement.

La bo�te de message est une bo�te de dialogue de type modale � l'application.

Cette fonction a �t� introduite dans Qt 4.2.

Voir aussi question(), information() et critical().

Remerciements

Merci � Dimitry Ernot pour la traduction, ainsi qu'� Ilya Diallo et Claude Leloup pour la relecture !