QMessageBox Class

Documentation sur les fonctions membres

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

Crée une boîte de message « application modal » sans texte ni boutons. La valeur « parent » est transmise au constructeur « QDialog ».

La modalité de la fenêtre peut être redéfinie via setWindowModality() avant d’appeler show().

Sous macOS, si vous souhaitez que votre boîte de message s'affiche en tant que « Qt::Sheet » de sa « parent », définissez le paramètre « window modality » de la boîte de message sur « Qt::WindowModal » ou utilisez la fonction « open() ». Sinon, la boîte de message s'affichera sous la forme d'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)

Crée une boîte de message « application modal » avec les éléments suivants : « icon », « title », « text » et le message standard « buttons ». Des boutons standard ou personnalisés peuvent être ajoutés à tout moment à l’aide de la fonction « addButton()». Les arguments « parent » et « f » sont transmis au constructeur de « QDialog ».

La modalité de la fenêtre peut être redéfinie via setWindowModality() avant d’appeler show().

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

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

[virtual noexcept] QMessageBox::~QMessageBox()

Ferme la boîte de dialogue.

[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 ». La boîte « À propos » est une enfant de « parent ».

La fonction about() recherche une icône appropriée à quatre emplacements différents :

1. Elle privilégie parent->icon() si celui-ci existe.
2. Sinon, elle essaie le widget de niveau supérieur contenant « parent ».
3. Si cela échoue, elle essaie le active window.
4. En dernier recours, elle utilise l’icône « Informations ».

La boîte de dialogue « À propos » comporte un seul bouton intitulé « OK ».

Sous macOS, la boîte « À propos » s’affiche sous forme de fenêtre non modale ; sur les autres plateformes, elle est actuellement modale au niveau de l’application.

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

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

Affiche une boîte de message simple concernant Qt, avec l'title ion indiquée 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.

Cette fonctionnalité est utile pour être intégrée dans le menu « Help » d'une application, comme illustré dans l'exemple « Menus ».

QApplication fournit cette fonctionnalité sous forme de slot.

Sous macOS, la boîte de dialogue aboutQt s’affiche sous forme de fenêtre non modale ; sur les autres plateformes, elle est actuellement modale au niveau de l’application.

Voir également ` QApplication::aboutQt()` ().

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

Ajoute l'button on indiquée à la boîte de message avec l'role spécifiée.

Voir également removeButton(), button() et setStandardButtons().

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

Ajoute un message standard « button » à la boîte de dialogue si cela est possible, puis renvoie le bouton.

Voir également setStandardButtons().

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

Crée un bouton avec l'text fournie, l'ajoute à la boîte de message correspondant à l'role spécifiée, puis le renvoie.

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

Renvoie un pointeur correspondant au bouton standard « which », ou « nullptr » si ce bouton standard n'existe pas dans cette boîte de dialogue.

Voir également standardButtons et standardButton().

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

Ce signal est émis chaque fois qu'un bouton est cliqué à l'intérieur de l'élément ` QMessageBox`. Le bouton sur lequel on a cliqué est renvoyé dans ` button`.

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

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

Voir également 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 également 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. Cette valeur est « nullptr » si aucune case à cocher n'est cochée.

Voir aussi 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 la fonction ` exec()` n'a pas encore été appelée, renvoie `nullptr`.

Exemple :

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

Voir également 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)

Affiche une boîte de message critique avec les paramètres « title » et « text » indiqués, devant le widget « parent » spécifié.

Les buttons standard sont ajoutés à la boîte de message. defaultButton spécifie le bouton utilisé lorsque Enter est cliqué. defaultButton doit faire référence à un bouton spécifié dans buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisit automatiquement une valeur par défaut appropriée.

Renvoie l’identifiant du bouton standard sur lequel l’utilisateur a cliqué. Si Esc a été sélectionné à la place, la valeur escape button est renvoyée.

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

Voir également question(), warning() et information().

QPushButton *QMessageBox::defaultButton() const

Renvoie le bouton qui doit servir de bouton par défaut ( default button) de la boîte de dialogue. Renvoie nullptr si aucun bouton par défaut n'a été défini.

Voir également setDefaultButton(), addButton() et QPushButton::setDefault().

QAbstractButton *QMessageBox::escapeButton() const

Renvoie le bouton qui est activé lorsque l'on appuie sur la touche Échap.

Par défaut, QMessageBox tente de détecter automatiquement un bouton « Échap » comme suit :

1. S'il n'y a qu'un seul bouton, celui-ci devient le bouton d'échappement.
2. S'il existe un bouton « Cancel », celui-ci est désigné comme bouton « escape ».
3. Sous macOS uniquement, s'il n'y a qu'un seul bouton ayant le rôle « QMessageBox::RejectRole », celui-ci est désigné comme bouton « Échap ».

Lorsqu’aucun bouton « Échap » n’a pu être détecté automatiquement, 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 la forme d’un « modal dialog », en bloquant l’exécution jusqu’à ce que l’utilisateur la ferme.

Lorsqu’on utilise une boîte de message de type « QMessageBox » avec des boutons standard, cette fonction renvoie une valeur de type « StandardButton » indiquant le bouton standard sur lequel l’utilisateur a cliqué. Lorsqu’on utilise une boîte de mess QMessageBox avec des boutons personnalisés, cette fonction renvoie une valeur opaque ; utilisez la fonction « clickedButton()» pour déterminer quel bouton a été 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êtrage.

Voir également 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 paramètres ` title ` et ` text ` indiqués, devant le widget ` parent ` spécifié.

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

Renvoie l’identifiant du bouton standard sur lequel l’utilisateur a cliqué. Si Esc a été sélectionné à la place, la valeur escape button est renvoyée.

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

Voir également 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 relie son signal « finished() » ou « buttonClicked() » au slot spécifié par « receiver » et « member ». Si le slot indiqué dans « member » a un pointeur comme premier paramètre, la connexion s'effectue vers « buttonClicked() » ; sinon, elle s'effectue vers « finished() ».

Le signal sera déconnecté du slot 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 dialogue de question avec les paramètres « title » et « text » indiqués, devant le widget « parent » spécifié.

Les buttons standard sont ajoutées à la boîte de message. defaultButton spécifie le bouton utilisé lorsque Enter est cliqué. defaultButton doit faire référence à un bouton indiqué dans buttons. Si defaultButton est QMessageBox::NoButton, QMessageBox choisit automatiquement une valeur par défaut appropriée.

Renvoie l’identifiant du bouton standard sur lequel l’utilisateur a cliqué. Si c’est plutôt Esc qui a été cliqué, la valeur escape button est renvoyée.

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

Voir également information(), warning() et critical().

void QMessageBox::removeButton(QAbstractButton *button)

Supprime button de la liste des boutons sans l'effacer.

Voir également addButton() et setStandardButtons().

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

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

void QMessageBox::setCheckBox(QCheckBox *cb)

Active la case à cocher « cb » dans la boîte de dialogue de message. La boîte de dialogue de message prend en charge cette case à cocher. L'argument ` cb ` peut prendre la valeur ` nullptr ` pour supprimer une case à cocher existante de la boîte de dialogue de message.

Voir également checkBox().

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

Définit la propriété « default button » de la boîte de message sur « button ».

Voir également defaultButton(), addButton() et QPushButton::setDefault().

void QMessageBox::setDefaultButton(QPushButton *button)

Définit l'default button de la boîte de message sur « button ».

Voir également addButton() et QPushButton::setDefault().

void QMessageBox::setEscapeButton(QAbstractButton *button)

Définit le bouton qui s'active lorsque la touche « Escape » est enfoncée sur « button ».

Voir également escapeButton(), addButton() et clickedButton().

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

Définit les boutons qui s'activent lorsque l'on appuie sur la touche « Escape » sur « button ».

Voir également addButton() et clickedButton().

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

Active l'option spécifiée si la valeur de « on » est « true » ; dans le cas contraire, désactive l'option spécifiée.

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

La définition d’options alors que la boîte de dialogue est visible n’a pas nécessairement d’effet immédiat sur celle-ci.

La définition d’options après la modification d’autres propriétés peut entraîner l’absence d’effet de ces valeurs.

Cette fonction a été introduite dans Qt 6.6.

Voir également options et testOption().

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

Cette fonction remplace la fonction QWidget::setWindowModality().

Définit la modalité de la boîte de message sur « windowModality ».

Sous macOS, si la modalité est définie sur ` Qt::WindowModal ` et que la boîte de message possède un parent, alors la boîte de message sera une « Qt::Sheet » ; dans le cas contraire, elle sera une boîte de dialogue standard.

void QMessageBox::setWindowTitle(const QString &title)

Cette fonction est une version alternative de la fonction ` QWidget::setWindowTitle()`.

Définit le titre de la boîte de message sur « 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 d'énumération standard du bouton correspondant à l'button donné, ou NoButton si l'button donné n'est pas un bouton standard.

Voir également button() et standardButtons().

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

Renvoie « true » si l’option « option » est activée ; 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 contenant les éléments « title » et « text » indiqués, devant le widget « parent » spécifié.

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

Renvoie l'identifiant du bouton standard sur lequel l'utilisateur a cliqué. Si l'utilisateur a cliqué sur Esc à la place, la valeur escape button est renvoyée.

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

Voir également question(), information() et critical().