QMessageBox Class

Dokumentation zu den Member-Funktionen

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

Erstellt ein „ application modal “-Meldungsfenster ohne Text und ohne Schaltflächen. „ parent “ wird an den Konstruktor von „ QDialog “ übergeben.

Die Fenstermodalität kann vor dem Aufruf von ` show()` über ` setWindowModality()` überschrieben werden.

Wenn Sie unter macOS möchten, dass Ihr Meldungsfeld als „ Qt::Sheet “ des zugehörigen „ parent “ angezeigt wird, setzen Sie die Eigenschaft „ window modality “ des Meldungsfelds auf „ Qt::WindowModal “ oder verwenden Sie „ open()“. Andernfalls wird das Meldungsfeld als Standarddialogfeld angezeigt.

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)

Erstellt ein Meldungsfenster vom Typ „ application modal “ mit den angegebenen Argumenten „ icon “, „ title “, „ text “ und dem Standardargument „ buttons “. Standard- oder benutzerdefinierte Schaltflächen können jederzeit mithilfe von „ addButton()“ hinzugefügt werden. Die Argumente „ parent “ und „ f “ werden an den Konstruktor von „ QDialog “ übergeben.

Die Fenstermodalität kann vor dem Aufruf von ` show()` über ` setWindowModality()` überschrieben werden.

Wenn unter macOS ` parent ` nicht ` nullptr ` ist und Sie möchten, dass Ihr Meldungsfeld als „ Qt::Sheet “ dieses übergeordneten Fensters erscheint, setzen Sie die Eigenschaft ` window modality ` des Meldungsfelds auf ` Qt::WindowModal ` (Standard). Andernfalls wird das Meldungsfeld als Standarddialog angezeigt.

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

[virtual noexcept] QMessageBox::~QMessageBox()

Löst das Meldungsfeld auf.

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

Zeigt ein einfaches „Über“-Fenster mit dem Titel „ title “ und dem Text „ text “ an. Das übergeordnete Element des „Über“-Fensters ist „ parent “.

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

1. Es bevorzugt „ parent->icon()“, sofern dieses vorhanden ist.
2. Ist dies nicht der Fall, versucht es es mit dem Widget der obersten Ebene, das „ parent “ enthält.
3. Schlägt dies fehl, versucht es das active window.
4. Als letzte Möglichkeit wird das Informationssymbol verwendet.

Das „Über“-Fenster enthält eine einzige Schaltfläche mit der Beschriftung „OK“.

Unter macOS wird das „Über“-Fenster als modales Fenster angezeigt; auf anderen Plattformen ist es derzeit an die Anwendung gebunden.

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

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

Zeigt ein einfaches Meldungsfeld zu Qt an, mit dem angegebenen title und zentriert über parent (sofern 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 Einbindung in das Menü „ Help “ einer Anwendung, wie im Beispiel „Menüs“ gezeigt.

QApplication bietet diese Funktionalität als Slot an.

Unter macOS wird das „aboutQt“-Fenster als modales Fenster angezeigt; auf anderen Plattformen ist es derzeit an die Anwendung gebunden.

Siehe auch ` QApplication::aboutQt()` ().

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

Fügt die angegebene „ button “ zur Meldungsbox mit der angegebenen „ role “ hinzu.

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

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

Fügt der Meldungsbox eine Standard- button -Schaltfläche hinzu, sofern dies zulässig ist, und gibt die Schaltfläche zurück.

Siehe auch ` setStandardButtons()`.

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

Erstellt eine Schaltfläche mit dem angegebenen Text „ text “, fügt sie dem Meldungsfeld 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 “, falls die Standardschaltfläche in diesem Meldungsfeld nicht vorhanden ist.

Siehe auch „ standardButtons “ und „ standardButton “ ().

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

Dieses Signal wird ausgelöst, sobald innerhalb von ` QMessageBox` auf eine Schaltfläche geklickt wird. Die angeklickte Schaltfläche wird in ` button` zurückgegeben.

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

Gibt die Schaltflächenrolle für das angegebene button zurück. Diese Funktion gibt „ InvalidRole “ zurück, wenn „ button “ den Wert „ nullptr “ hat oder nicht zum Meldungsfeld hinzugefügt wurde.

Siehe auch buttons() und addButton().

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

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

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

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

Umsetzt: ` QWidget::changeEvent(QEvent *event)`.

QCheckBox *QMessageBox::checkBox() const

Gibt das im Dialogfeld angezeigte Kontrollkästchen zurück. Ist kein Kontrollkästchen aktiviert, lautet der Wert „ nullptr “.

Siehe auch „ setCheckBox()“.

QAbstractButton *QMessageBox::clickedButton() const

Gibt die Schaltfläche zurück, auf die der Benutzer geklickt hat, oder „ nullptr “, wenn der Benutzer die Taste „ Esc “ gedrückt hat und kein „ escape button “ festgelegt 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)

Umsetzt: ` 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 ein Meldungsfeld mit dem Status „Kritisch“ und den angegebenen Werten für „ title “ und „ text “ vor dem angegebenen Widget „ parent “.

Die Standard- buttons werden dem Meldungsfeld hinzugefügt. defaultButton gibt die Schaltfläche an, die beim Drücken von Enter verwendet wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton QMessageBox::NoButton ist, wählt QMessageBox automatisch einen geeigneten Standard aus.

Gibt die Kennung der Standardschaltfläche zurück, auf die geklickt wurde. Wurde stattdessen Esc gedrückt, wird escape button zurückgegeben.

Das Meldungsfeld ist ein „ application modal “-Dialogfeld.

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

QPushButton *QMessageBox::defaultButton() const

Gibt die Schaltfläche zurück, die als „ default button “ des Meldungsfelds dienen soll. Gibt nullptr zurück, wenn keine Standardschaltfläche festgelegt wurde.

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

QAbstractButton *QMessageBox::escapeButton() const

Gibt die Schaltfläche zurück, die beim Drücken der Escape-Taste aktiviert wird.

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

1. Wenn nur eine Schaltfläche vorhanden ist, wird diese zur Escape-Schaltfläche.
2. Wenn eine Schaltfläche mit der Rolle „ Cancel “ vorhanden ist, wird diese zur Escape-Schaltfläche festgelegt.
3. Nur unter macOS: Wenn genau eine Schaltfläche mit der Rolle „ QMessageBox::RejectRole “ vorhanden ist, wird diese zur Escape-Schaltfläche festgelegt.

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)

Umsetzt: ` QWidget::event(QEvent *event)`.

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

Implementiert neu: ` QDialog::exec()`.

Zeigt das Meldungsfeld als „ modal dialog “ an und blockiert die Ausführung, bis der Benutzer es schließt.

Bei Verwendung eines „ QMessageBox “ mit Standardschaltflächen gibt diese Funktion einen „ StandardButton “-Wert zurück, der angibt, welche Standardschaltfläche angeklickt wurde. Bei 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 derselben Anwendung interagieren, bis sie den Dialog schließen – entweder durch Klicken auf eine Schaltfläche oder mithilfe eines 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 Informationsfeld mit den angegebenen Werten „ title “ und „ text “ vor dem angegebenen Widget „ parent “.

Die Standard- buttons werden dem Meldungsfeld hinzugefügt. defaultButton gibt die Schaltfläche an, die beim Drücken von Enter verwendet wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton gleich QMessageBox::NoButton ist, wählt QMessageBox automatisch einen geeigneten Standard aus.

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

Das Meldungsfeld ist ein „ application modal “-Dialogfeld.

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

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

Implementiert: ` QDialog::keyPressEvent(QKeyEvent *e)`.

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

Öffnet das Dialogfeld und verbindet dessen Signal „ finished()“ oder „ buttonClicked()“ mit dem durch „ receiver “ und „ member “ angegebenen Slot. Wenn der Slot in „ member “ als ersten Parameter einen Zeiger enthält, erfolgt die Verbindung zu „ buttonClicked()“, andernfalls zu „ finished()“.

Das Signal wird vom Slot getrennt, sobald das Dialogfeld 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 Meldungsfeld mit den angegebenen Werten für „ title “ und „ text “ vor dem angegebenen Widget „ parent “.

Die Standard- buttons werden dem Meldungsfeld hinzugefügt. defaultButton gibt die Schaltfläche an, die beim Drücken von Enter verwendet wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton gleich QMessageBox::NoButton ist, wählt QMessageBox automatisch eine geeignete Standardschaltfläche aus.

Gibt die Kennung der Standardschaltfläche zurück, auf die geklickt wurde. Wurde stattdessen Esc gedrückt, wird „ escape button “ zurückgegeben.

Das Meldungsfeld ist ein „ application modal “-Dialogfeld.

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

void QMessageBox::removeButton(QAbstractButton *button)

Entfernt „ button “ aus der Schaltflächenliste, ohne die Datei zu löschen.

Siehe auch „ addButton()“ und „ setStandardButtons()“.

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

Implementiert: ` QDialog::resizeEvent` (`QResizeEvent *`).

void QMessageBox::setCheckBox(QCheckBox *cb)

Setzt das Kontrollkästchen „ cb “ im Meldungsdialogfeld. Das Meldungsfeld übernimmt die Kontrolle über das Kontrollkästchen. Das Argument „ cb “ kann auf „ nullptr “ gesetzt werden, um ein vorhandenes Kontrollkästchen aus dem Meldungsfeld zu entfernen.

Siehe auch „ checkBox()“.

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

Setzt die Eigenschaft „ default button “ des Meldungsfelds auf „ button “.

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

void QMessageBox::setDefaultButton(QPushButton *button)

Setzt die Eigenschaft „ default button “ des Meldungsfelds auf „ button “.

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

void QMessageBox::setEscapeButton(QAbstractButton *button)

Legt die Schaltfläche fest, die beim Drücken der Taste „ Escape “ aktiviert wird, auf „ button “.

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

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

Legt fest, dass die Schaltflächen, die beim Drücken der Taste „ Escape “ aktiviert werden, auf „ button “ gesetzt werden.

Siehe auch „ addButton()“ und „ clickedButton()“.

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

Legt fest, dass die angegebene Option „ option “ aktiviert wird, wenn „ on “ auf „true“ gesetzt ist; andernfalls wird die angegebene Option „ option “ deaktiviert.

Optionen (insbesondere die Option „ Option::DontUseNativeDialog “) sollten vor dem Anzeigen des Dialogfelds festgelegt werden.

Es ist nicht garantiert, dass das Festlegen von Optionen, während der Dialog sichtbar ist, eine sofortige Auswirkung auf den Dialog hat.

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

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch „ options “ und „ testOption()“.

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

Diese Funktion überschreibt die Funktion „ QWidget::setWindowModality()“.

Legt die Modalität des Meldungsfensters auf „ windowModality “ fest.

Unter macOS gilt: Wenn die Modalität auf „ Qt::WindowModal “ gesetzt ist und das Meldungsfeld ein übergeordnetes Element hat, wird das Meldungsfeld als „ Qt::Sheet “ angezeigt; andernfalls wird das Meldungsfeld als Standarddialogfeld angezeigt.

void QMessageBox::setWindowTitle(const QString &title)

Diese Funktion ist eine Kopie von ` QWidget::setWindowTitle()`.

Setzt den Titel des Meldungsfensters auf „ title “. Unter macOS wird der Fenstertitel ignoriert (gemäß den macOS-Richtlinien).

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

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

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

Gibt den Standard-Enum-Wert für die Schaltfläche zurück, der dem angegebenen „ button “ entspricht, oder „ NoButton “, falls 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 Funktion „ 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 Warnungsfenster mit den angegebenen Werten für „ title “ und „ text “ vor dem angegebenen Widget „ parent “.

Die Standard- buttons werden dem Meldungsfeld hinzugefügt. defaultButton gibt die Schaltfläche an, die beim Drücken von Enter verwendet wird. defaultButton muss sich auf eine Schaltfläche beziehen, die in buttons angegeben wurde. Wenn defaultButton gleich QMessageBox::NoButton ist, wählt QMessageBox automatisch einen geeigneten Standard aus.

Gibt die Kennung der Standardschaltfläche zurück, auf die geklickt wurde. Wurde stattdessen Esc gedrückt, wird escape button zurückgegeben.

Das Meldungsfeld ist ein „ application modal “-Dialogfeld.

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