QMessageBox Class

Documentation sur les fonctions membres

[explicit] QMessageBox::QMessageBox(QWidget *parent = nullptr)

Construit une boîte de message application modal sans texte ni bouton. parent est transmis au constructeur QDialog.

La modalité de la fenêtre peut être remplacée par setWindowModality() avant d'appeler show().

Sous macOS, si vous voulez que votre boîte de message apparaisse comme une Qt::Sheet de sa parent, définissez la window modality de la boîte de message sur Qt::WindowModal ou utilisez open(). Sinon, la boîte de message sera une boîte de dialogue standard.

Voir également setWindowTitle(), setText(), setIcon(), setStandardButtons() et setWindowModality().

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

Construit une boîte de message application modal avec les éléments donnés icon, title, text, et l'élément standard buttons. Des boutons standard ou personnalisés peuvent être ajoutés à tout moment à l'aide de addButton(). Les arguments parent et f sont transmis au constructeur QDialog.

La modalité de la fenêtre peut être remplacée par setWindowModality() avant d'appeler show().

Sous macOS, si parent n'est pas nullptr et que vous souhaitez que votre boîte de message apparaisse en tant que Qt::Sheet de ce parent, définissez window modality de la boîte de message sur Qt::WindowModal (par défaut). Sinon, la boîte de message sera une boîte de dialogue standard.

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

[virtual noexcept] QMessageBox::~QMessageBox()

Détruit la boîte de message.

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

Affiche une boîte "à propos" simple avec le titre title et le texte text. Le parent de la boîte "about" est parent.

about() recherche une icône appropriée à quatre endroits :

1. Il préfère parent->icon() s'il existe.
2. Si ce n'est pas le cas, il essaie le widget de premier niveau contenant parent.
3. En cas d'échec, il essaie le widget de niveau supérieur contenant . active window.
4. En dernier recours, il utilise l'icône Information.

La boîte "À propos" comporte un seul bouton intitulé "OK".

Sur macOS, la boîte "À propos" s'affiche sous la forme d'une fenêtre sans modèle ; sur les autres plates-formes, il s'agit actuellement d'une application modale.

Voir également QWidget::windowIcon() et QApplication::activeWindow().

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

Affiche une boîte de message simple sur Qt, avec l'adresse title et centrée sur parent (si parent n'est pas nullptr). Le message inclut le numéro de version de Qt utilisé par l'application.

Il est utile de l'inclure dans le menu Help d'une application, comme le montre l'exemple des menus.

QApplication fournit cette fonctionnalité sous forme de slot.

Sur macOS, la boîte aboutQt est affichée comme une fenêtre sans modèle ; sur d'autres plateformes, elle est actuellement modale.

Voir aussi QApplication::aboutQt().

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

Ajoute le message button donné à la boîte aux lettres avec le message role spécifié.

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

QPushButton *QMessageBox::addButton(QMessageBox::StandardButton button)

Ajoute un button standard à la boîte de message s'il est valide, et renvoie le bouton poussoir.

Voir aussi setStandardButtons().

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

Crée un bouton avec le nom text, l'ajoute à la boîte de message pour le nom role et le renvoie.

QAbstractButton *QMessageBox::button(QMessageBox::StandardButton which) const

Renvoie un pointeur correspondant au bouton standard which, ou nullptr si le bouton standard n'existe pas dans cette boîte de message.

Voir aussi standardButtons et standardButton().

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

Ce signal est émis chaque fois qu'un bouton est cliqué à l'intérieur du site QMessageBox. Le bouton qui a été cliqué est renvoyé dans le site button.

QMessageBox::ButtonRole QMessageBox::buttonRole(QAbstractButton *button) const

Renvoie le rôle du bouton pour l'adresse button spécifiée. Cette fonction renvoie InvalidRole si button est nullptr ou n'a pas été ajouté à la boîte aux lettres.

Voir aussi buttons() et addButton().

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

Renvoie une liste de tous les boutons qui ont été ajoutés à la boîte de message.

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

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

Réimplémente : QWidget::changeEvent(QEvent *event).

QCheckBox *QMessageBox::checkBox() const

Renvoie la case à cocher affichée dans la boîte de dialogue. C'est nullptr si aucune case à cocher n'est définie.

Voir également setCheckBox().

QAbstractButton *QMessageBox::clickedButton() const

Renvoie le bouton sur lequel l'utilisateur a cliqué, ou nullptr si l'utilisateur a appuyé sur la touche Esc et qu'aucun escape button n'a été défini.

Si exec() n'a pas encore été appelé, il renvoie nullptr.

Exemple :

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

Voir aussi standardButton() et button().

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

Réimplémente : QDialog::closeEvent(QCloseEvent *e).

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

Ouvre une boîte de message critique avec les adresses title et text devant le widget parent spécifié.

Le standard buttons est ajouté à la boîte de message. defaultButton spécifie le bouton utilisé lorsque Enter est pressé. defaultButton doit faire référence à un bouton qui a été donné dans buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisit automatiquement une valeur par défaut appropriée.

Renvoie l'identité du bouton standard qui a été cliqué. Si Esc a été pressé à la place, escape button est renvoyé.

La boîte de message est une boîte de dialogue application modal.

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

QPushButton *QMessageBox::defaultButton() const

Renvoie le bouton qui doit être le bouton de la boîte de message default button. Renvoie nullptr si aucun bouton par défaut n'a été défini.

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

QAbstractButton *QMessageBox::escapeButton() const

Renvoie le bouton qui est activé lorsque l'on appuie sur escape.

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, il devient le bouton d'échappement.
2. S'il y a un bouton Cancel, il devient le bouton d'échappement.
3. Sur macOS uniquement, s'il y a exactement un bouton avec le rôle QMessageBox::RejectRole, il devient le bouton d'échappement.

Lorsqu'un bouton d'échappement n'a pas pu être détecté automatiquement, le fait d'appuyer sur Esc n'a aucun effet.

Voir également setEscapeButton() et addButton().

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

Réimplémente : QWidget::event(QEvent *event).

[override virtual slot] int QMessageBox::exec()

Réimplémente : QDialog::exec().

Affiche la boîte de message sous forme de modal dialog, en la bloquant jusqu'à ce que l'utilisateur la ferme.

Lors de l'utilisation d'un QMessageBox avec des boutons standard, cette fonction renvoie une valeur StandardButton indiquant le bouton standard sur lequel l'utilisateur a cliqué. Lors de l'utilisation de QMessageBox avec des boutons personnalisés, cette fonction renvoie une valeur opaque ; utilisez clickedButton() pour déterminer le bouton sur lequel l'utilisateur a cliqué.

Les utilisateurs ne peuvent interagir avec aucune autre fenêtre de la même application tant qu'ils n'ont pas fermé la boîte de dialogue, soit en cliquant sur un bouton, soit en utilisant un mécanisme fourni par le système de fenêtres.

Voir aussi show() et result().

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

Ouvre une boîte de message d'information avec les adresses title et text devant le widget parent spécifié.

Le standard buttons est ajouté à la boîte de message. defaultButton spécifie le bouton utilisé lorsque Enter est pressé. defaultButton doit faire référence à un bouton qui a été donné dans buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisit automatiquement une valeur par défaut appropriée.

Renvoie l'identité du bouton standard qui a été cliqué. Si Esc a été pressé à la place, escape button est renvoyé.

La boîte de message est une boîte de dialogue application modal.

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

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

Réimplémente : QDialog::keyPressEvent(QKeyEvent *e).

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

Ouvre la boîte de dialogue et connecte son signal finished() ou buttonClicked() à l'emplacement spécifié par receiver et member. Si l'emplacement dans member a un pointeur pour son premier paramètre, la connexion est à buttonClicked(), sinon la connexion est à finished().

Le signal sera déconnecté de l'emplacement lorsque la boîte de dialogue sera fermée.

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

Ouvre une boîte de questions avec les adresses title et text devant le widget parent spécifié.

Le standard buttons est ajouté à la boîte de message. defaultButton spécifie le bouton utilisé lorsque Enter est pressé. defaultButton doit faire référence à un bouton qui a été donné dans buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisit automatiquement une valeur par défaut appropriée.

Renvoie l'identité du bouton standard qui a été cliqué. Si Esc a été pressé à la place, escape button est renvoyé.

La boîte de message est une boîte de dialogue application modal.

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

void QMessageBox::removeButton(QAbstractButton *button)

Retire button de la boîte à boutons sans la supprimer.

Voir aussi addButton() et setStandardButtons().

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

Réimplémente : QDialog::resizeEvent(QResizeEvent *).

void QMessageBox::setCheckBox(QCheckBox *cb)

Définit la case à cocher cb dans la boîte de dialogue du message. La boîte de message est propriétaire de la case à cocher. L'argument cb peut être nullptr pour supprimer une case à cocher existante de la boîte de message.

Voir également checkBox().

void QMessageBox::setDefaultButton(QMessageBox::StandardButton button)

Fixe la valeur de la boîte de message default button à button.

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

void QMessageBox::setDefaultButton(QPushButton *button)

Fixe la valeur de la boîte de message default button à button.

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

void QMessageBox::setEscapeButton(QAbstractButton *button)

Définit le bouton qui est activé lorsque la touche Escape est pressée à button.

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

void QMessageBox::setEscapeButton(QMessageBox::StandardButton button)

Définit les boutons qui sont activés lorsque la touche Escape est pressée à button.

Voir aussi addButton() et clickedButton().

[since 6.6] void QMessageBox::setOption(QMessageBox::Option option, bool on = true)

Active l'option option si on est vrai ; sinon, efface l'option option.

Les options (en particulier l'option Option::DontUseNativeDialog ) doivent être définies avant d'afficher la boîte de dialogue.

La définition d'options pendant que la boîte de dialogue est visible n'est pas garantie d'avoir un effet immédiat sur la boîte de dialogue.

Le fait de définir des options après avoir modifié d'autres propriétés peut faire en sorte que ces valeurs n'aient aucun effet.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi options et testOption().

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

Cette fonction fait de l'ombre à QWidget::setWindowModality().

Définit la modalité de la boîte de message à windowModality.

Sous macOS, si la modalité est définie sur Qt::WindowModal et que la boîte de message a un parent, la boîte de message sera une Qt::Sheet, sinon la boîte de message sera une boîte de dialogue standard.

void QMessageBox::setWindowTitle(const QString &title)

Cette fonction fait de l'ombre à QWidget::setWindowTitle().

Définit le titre de la boîte de message à title. Sous macOS, le titre de la fenêtre est ignoré (conformément aux directives macOS).

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

Réimplémente : QDialog::showEvent(QShowEvent *event).

QMessageBox::StandardButton QMessageBox::standardButton(QAbstractButton *button) const

Renvoie la valeur de l'énumération des boutons standard correspondant à l'adresse button, ou NoButton si l'adresse button n'est pas un bouton standard.

Voir aussi button() et standardButtons().

[since 6.6] bool QMessageBox::testOption(QMessageBox::Option option) const

Renvoie true si le site option est activé ; sinon, renvoie false.

Cette fonction a été introduite dans Qt 6.6.

Voir aussi options et setOption().

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

Ouvre une boîte de message d'avertissement avec les adresses title et text devant le widget parent spécifié.

Le standard buttons est ajouté à la boîte de message. defaultButton spécifie le bouton utilisé lorsque Enter est pressé. defaultButton doit faire référence à un bouton qui a été donné dans buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisit automatiquement une valeur par défaut appropriée.

Renvoie l'identité du bouton standard qui a été cliqué. Si Esc a été pressé à la place, escape button est renvoyé.

La boîte de message est une boîte de dialogue application modal.

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