QMessageBox Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert ein application modal Nachrichtenfenster ohne Text und ohne Schaltflächen. parent wird an den QDialog Konstruktor übergeben.

Die Fenstermodalität kann mit setWindowModality() überschrieben werden, bevor show() aufgerufen wird.

Wenn Sie unter macOS möchten, dass Ihr Nachrichtenfeld als Qt::Sheet seines parent erscheint, setzen Sie window modality des Nachrichtenfeldes auf Qt::WindowModal oder verwenden Sie open(). Andernfalls ist das Nachrichtenfeld ein Standarddialogfeld.

Siehe auch setWindowTitle(), setText(), setIcon(), setStandardButtons(), und 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)

Konstruiert ein application modal Nachrichtenfeld mit den gegebenen icon, title, text, und Standard buttons. Standard- oder benutzerdefinierte Schaltflächen können jederzeit mit addButton() hinzugefügt werden. Die Argumente parent und f werden an den Konstruktor QDialog übergeben.

Die Fenstermodalität kann mit setWindowModality() überschrieben werden, bevor show() aufgerufen wird.

Wenn unter macOS parent nicht nullptr ist und Sie möchten, dass Ihr Nachrichtenfeld als Qt::Sheet des übergeordneten Fensters erscheint, setzen Sie window modality des Nachrichtenfeldes auf Qt::WindowModal (Standard). Andernfalls wird das Nachrichtenfeld ein Standarddialogfeld sein.

Siehe auch setWindowTitle(), setText(), setIcon(), setStandardButtons(), und setWindowModality().

[virtual noexcept] QMessageBox::~QMessageBox()

Zerstört das Nachrichtenfeld.

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

Zeigt ein einfaches Informationsfeld mit dem Titel title und dem Text text an. Das übergeordnete Element der about-Box ist parent.

about() sucht an vier Stellen nach einem geeigneten Symbol:

1. Es bevorzugt parent->icon(), wenn es existiert.
2. Ist dies nicht der Fall, versucht es das oberste Widget, das parent enthält.
3. Schlägt dies fehl, versucht es das active window.
4. Als letzten Ausweg verwendet es das Informationssymbol.

Das Info-Feld hat eine einzelne Schaltfläche mit der Aufschrift "OK".

Unter macOS wird das Info-Fenster als modellloses Fenster angezeigt; auf anderen Plattformen ist es derzeit ein modales Anwendungsfenster.

Siehe auch QWidget::windowIcon() und QApplication::activeWindow().

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

Zeigt ein einfaches Nachrichtenfeld über Qt an, mit der angegebenen title und zentriert über parent (wenn parent nicht nullptr ist). Die Meldung enthält die Versionsnummer von Qt, die von der Anwendung verwendet wird.

Dies ist nützlich für die Aufnahme in das Help Menü einer Anwendung, wie im Beispiel Menüs gezeigt.

QApplication bietet diese Funktionalität als Slot.

Unter macOS wird das aboutQt-Fenster als modellloses Fenster angezeigt; auf anderen Plattformen ist es derzeit modal.

Siehe auch QApplication::aboutQt().

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

Fügt die angegebene button in das Nachrichtenfeld mit der angegebenen role ein.

Siehe auch removeButton(), button(), und setStandardButtons().

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

Dies ist eine überladene Funktion.

Fügt dem Nachrichtenfeld einen Standard button hinzu, wenn dies zulässig ist, und gibt die Drucktaste zurück.

Siehe auch setStandardButtons().

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

Dies ist eine überladene Funktion.

Erzeugt eine Schaltfläche mit der angegebenen text, fügt sie dem Nachrichtenfeld für die angegebene role hinzu und gibt sie zurück.

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

Gibt einen Zeiger zurück, der der Standardschaltfläche which entspricht, oder nullptr, wenn die Standardschaltfläche in diesem Meldungsfenster nicht vorhanden ist.

Siehe auch standardButtons und standardButton().

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

Dieses Signal wird immer dann ausgegeben, wenn ein Button innerhalb von QMessageBox angeklickt wird. Der angeklickte Button wird in button zurückgegeben.

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

Gibt die Schaltflächenrolle für die angegebene button zurück. Diese Funktion gibt InvalidRole zurück, wenn button nullptr ist oder dem Nachrichtenfeld nicht hinzugefügt wurde.

Siehe auch buttons() und addButton().

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

Gibt eine Liste aller Schaltflächen zurück, die dem Nachrichtenfeld hinzugefügt wurden.

Siehe auch buttonRole(), addButton(), und removeButton().

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

Reimplements: QWidget::changeEvent(QEvent *Event).

QCheckBox *QMessageBox::checkBox() const

Gibt das im Dialogfeld angezeigte Kontrollkästchen zurück. Dies ist nullptr, wenn kein Kontrollkästchen gesetzt ist.

Siehe auch setCheckBox().

QAbstractButton *QMessageBox::clickedButton() const

Gibt die Schaltfläche zurück, die der Benutzer angeklickt hat, oder nullptr, wenn der Benutzer die Taste Esc gedrückt hat und keine escape button gesetzt wurde.

Wenn exec() noch nicht aufgerufen wurde, wird nullptr zurückgegeben.

Beispiel:

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

Siehe auch standardButton() und button().

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

Reimplements: 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)

Öffnet eine kritische Nachrichtenbox mit den angegebenen title und text vor dem angegebenen parent Widget.

Die Standard-Schaltflächen buttons werden der Messagebox hinzugefügt. defaultButton gibt die Schaltfläche an, die verwendet wird, wenn Enter gedrückt wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton QMessageBox::NoButton ist, wählt QMessageBox automatisch eine geeignete Standard-Schaltfläche.

Gibt die Identität der Standardschaltfläche zurück, die angeklickt wurde. Wurde stattdessen Esc gedrückt, wird escape button zurückgegeben.

Die Nachrichtenbox ist eine application modal Dialogbox.

Siehe auch question(), warning(), und information().

QPushButton *QMessageBox::defaultButton() const

Gibt die Schaltfläche zurück, die die Schaltfläche des Nachrichtenfeldes default button sein soll. Gibt nullptr zurück, wenn keine Standardschaltfläche festgelegt wurde.

Siehe auch setDefaultButton(), addButton(), und QPushButton::setDefault().

QAbstractButton *QMessageBox::escapeButton() const

Gibt die Taste zurück, die aktiviert wird, wenn die Escape-Taste gedrückt wird.

Standardmäßig versucht QMessageBox, eine Escape-Taste automatisch wie folgt zu erkennen:

1. Wenn es nur eine Taste gibt, wird diese zur Escape-Taste gemacht.
2. Wenn es eine Cancel Taste gibt, wird diese zur Escape-Taste gemacht.
3. Nur unter macOS, wenn es genau eine Schaltfläche mit der Rolle QMessageBox::RejectRole gibt, wird diese zur Escape-Schaltfläche gemacht.

Wenn eine Escape-Taste nicht automatisch erkannt werden konnte, hat das Drücken von Esc keine Wirkung.

Siehe auch setEscapeButton() und addButton().

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

Reimplements: QWidget::event(QEvent *Event).

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

Reimplements: QDialog::exec().

Zeigt das Nachrichtenfeld als modal dialog an und blockiert es, bis der Benutzer es schließt.

Bei Verwendung von QMessageBox mit Standardschaltflächen gibt diese Funktion einen StandardButton Wert zurück, der die Standardschaltfläche angibt, auf die geklickt wurde. Bei der Verwendung von QMessageBox mit benutzerdefinierten Schaltflächen gibt diese Funktion einen undurchsichtigen Wert zurück; verwenden Sie clickedButton(), um festzustellen, welche Schaltfläche angeklickt wurde.

Benutzer können mit keinem anderen Fenster in derselben Anwendung interagieren, bis sie den Dialog schließen, entweder durch Anklicken einer Schaltfläche oder durch einen vom Fenstersystem bereitgestellten Mechanismus.

Siehe auch show() und result().

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

Öffnet ein Informationsfenster mit den angegebenen title und text vor dem angegebenen parent Widget.

Die Standard-Schaltfläche buttons wird der Nachrichtenbox hinzugefügt. defaultButton gibt die Schaltfläche an, die verwendet wird, wenn Enter gedrückt wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton QMessageBox::NoButton ist, wählt QMessageBox automatisch eine geeignete Standard-Schaltfläche.

Gibt die Identität der Standardschaltfläche zurück, die angeklickt wurde. Wurde stattdessen Esc gedrückt, wird escape button zurückgegeben.

Die Nachrichtenbox ist eine application modal Dialogbox.

Siehe auch question(), warning(), und critical().

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

Reimplements: QDialog::keyPressEvent(QKeyEvent *e).

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

Öffnet den Dialog und verbindet sein finished() oder buttonClicked() Signal mit dem durch receiver und member angegebenen Slot. Wenn der Slot in member einen Zeiger für seinen ersten Parameter hat, ist die Verbindung zu buttonClicked(), andernfalls ist die Verbindung zu finished().

Das Signal wird vom Slot getrennt, wenn der Dialog geschlossen wird.

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

Öffnet ein Frage-Meldungsfeld mit den angegebenen title und text vor dem angegebenen parent Widget.

Die Standard-Schaltflächen buttons werden der Messagebox hinzugefügt. defaultButton gibt die Schaltfläche an, die verwendet wird, wenn Enter gedrückt wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton QMessageBox::NoButton ist, wählt QMessageBox automatisch eine geeignete Standard-Schaltfläche.

Gibt die Identität der Standardschaltfläche zurück, die angeklickt wurde. Wurde stattdessen Esc gedrückt, wird escape button zurückgegeben.

Die Nachrichtenbox ist eine application modal Dialogbox.

Siehe auch information(), warning(), und critical().

void QMessageBox::removeButton(QAbstractButton *button)

Entfernt button aus dem Schaltflächenfeld, ohne es zu löschen.

Siehe auch addButton() und setStandardButtons().

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

Reimplements: QDialog::resizeEvent(QResizeEvent *).

void QMessageBox::setCheckBox(QCheckBox *cb)

Legt das Kontrollkästchen cb im Meldungsdialog fest. Das Meldungsfenster übernimmt das Eigentum an dem Kontrollkästchen. Das Argument cb kann nullptr sein, um ein vorhandenes Kontrollkästchen aus dem Meldungsfenster zu entfernen.

Siehe auch checkBox().

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

Setzt das Feld default button des Nachrichtenfeldes auf button.

Siehe auch defaultButton(), addButton(), und QPushButton::setDefault().

void QMessageBox::setDefaultButton(QPushButton *button)

Setzt das Feld default button des Nachrichtenfeldes auf button.

Siehe auch addButton() und QPushButton::setDefault().

void QMessageBox::setEscapeButton(QAbstractButton *button)

Setzt die Schaltfläche, die aktiviert wird, wenn die Taste Escape gedrückt wird, auf button.

Siehe auch escapeButton(), addButton(), und clickedButton().

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

Setzt die Tasten, die aktiviert werden, wenn die Taste Escape gedrückt wird, auf button.

Siehe auch addButton() und clickedButton().

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

Setzt das angegebene option auf aktiv, wenn on wahr ist; andernfalls wird das angegebene option gelöscht.

Optionen (insbesondere die Option Option::DontUseNativeDialog ) sollten gesetzt werden, bevor der Dialog angezeigt wird.

Das Setzen von Optionen, während der Dialog sichtbar ist, hat nicht garantiert eine unmittelbare Auswirkung auf den Dialog.

Das Setzen von Optionen nach dem Ändern anderer Eigenschaften kann dazu führen, dass diese Werte keine Wirkung haben.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch options und testOption().

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

Diese Funktion stellt QWidget::setWindowModality() in den Schatten.

Setzt die Modalität des Meldungsfelds auf windowModality.

Unter macOS, wenn die Modalität auf Qt::WindowModal eingestellt ist und das Nachrichtenfeld ein übergeordnetes Element hat, ist das Nachrichtenfeld ein Qt::Sheet, andernfalls ist das Nachrichtenfeld ein Standarddialogfeld.

void QMessageBox::setWindowTitle(const QString &title)

Diese Funktion stellt QWidget::setWindowTitle() in den Schatten.

Setzt den Titel des Nachrichtenfensters auf title. Unter macOS wird der Fenstertitel ignoriert (wie in den macOS-Richtlinien gefordert).

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

Reimplements: QDialog::showEvent(QShowEvent *event).

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

Gibt den Enum-Wert der Standardschaltfläche zurück, der der angegebenen button entspricht, oder NoButton, wenn die angegebene button keine Standardschaltfläche ist.

Siehe auch button() und standardButtons().

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

Gibt true zurück, wenn die angegebene option aktiviert ist; andernfalls wird false zurückgegeben.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch options und setOption().

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

Öffnet ein Warnmeldungsfeld mit den angegebenen title und text vor dem angegebenen parent Widget.

Die Standard-Schaltfläche buttons wird dem Meldungsfeld hinzugefügt. defaultButton gibt die Schaltfläche an, die verwendet wird, wenn Enter gedrückt wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton QMessageBox::NoButton ist, wählt QMessageBox automatisch eine geeignete Vorgabe.

Gibt die Identität der Standardschaltfläche zurück, die angeklickt wurde. Wurde stattdessen Esc gedrückt, wird escape button zurückgegeben.

Die Nachrichtenbox ist eine application modal Dialogbox.

Siehe auch question(), information(), und critical().