QMessageBox 类

成员函数文档

[明确指定] QMessageBox::QMessageBox(QWidget *parent = nullptr)

构造一个不带文本和按钮的应用程序模态消息框。 parent 传递给 QDialog 构造函数。

可以在调用 show() 之前通过 setWindowModality() 来覆盖窗口模态。

在 macOS 上，如果你想让消息框以其 父窗口 的 Qt::Sheet 的形式显示，请将消息框的 窗口模态 设置为 Qt::WindowModal 或使用 open(). 否则，消息框将是一个标准对话框。

另请参阅：setWindowTitle()，setText()，setIcon()，setStandardButtons() 和 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)

根据指定的 图标、标题、文本 和标准 按钮 构造一个 应用程序模态 消息框。可以使用 addButton() 在任何时候添加标准或自定义按钮。《i translate="no">父窗口 和 f 参数被传递给 QDialog 构造函数。

可以在调用 show() 之前通过 setWindowModality() 来覆盖窗口模态。

在 macOS 上，如果 父窗口 不是 nullptr 并且你想让你的消息框以那个父窗口的 Qt::Sheet 形式显示，请将消息框的 窗口模态 设置为 Qt::WindowModal（默认）。否则，消息框将是一个标准对话框。

另请参阅：setWindowTitle()，setText()，setIcon()，setStandardButtons() 和 setWindowModality().

[虚拟 noexcept] QMessageBox::~QMessageBox()

销毁消息框。

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

显示带有标题 title 和文本 text 的简单“关于”对话框。关于对话框的父类是 parent。

about() 在四个位置查找合适的图标

1. 如果存在，更倾向于 parent->icon()。
2. 如果没有，它会尝试包含 parent 的顶层小部件。
3. 如果这也失败了，它会尝试 活动窗口。
4. 最后，使用信息图标。

关于对话框只有一个名为“确定”的按钮。

在 macOS 上，关于对话框以无模态窗明的形式弹出；在其他平台上，它当前是应用程序模态。

另请参阅：QWidget::windowIcon() 和 QApplication::activeWindow().

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

显示有关 Qt 的简单消息框，其中包含给定的 标题 并位于 parent（如果 parent 不是 nullptr）的中央。消息包括应用程序使用的 Qt 版本号。

这适用于加入应用程序的帮助菜单，如菜单示例所示。

QApplication通过槽来提供此功能。

在macOS上，关于Qt的对话框以模态窗口弹出；在其他平台上，它目前以应用程序模态的方式显示。

另请参阅QApplication::aboutQt()。

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

将指定的按钮添加到具有指定角色的消息框中。

另请参阅removeButton()、button()和setStandardButtons()。

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

这是一个重载函数。

创建一个带有指定文本的按钮，将其添加到指定角色的消息框中，并返回它。

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

这是一个重载函数。

如果合适，向消息框添加一个标准按钮，并返回该按钮。

另请参阅setStandardButtons()。

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

返回对应于标准按钮which的指针，如果此消息框中没有标准按钮，则返回nullptr。

另请参阅standardButtons和standardButton()。

[信号] void QMessageBox::buttonClicked(QAbstractButton *button)

当在QMessageBox中点击按钮时，会发出此信号。所点击的按钮在button中返回。

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

返回指定按钮的按钮角色。如果button是nullptr或尚未添加到消息框，则此函数返回InvalidRole。

另请参阅buttons()和addButton()。

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

返回已添加到消息框的所有按钮的列表。

另请参阅 buttonRole()，addButton()和removeButton()。

[覆盖虚保护] void QMessageBox::changeEvent(QEvent *ev)

实现了：QWidget::changeEvent(QEvent *event)。

QCheckBox *QMessageBox::checkBox() const

返回对话框中显示的复选框。如果没有设置复选框，则为nullptr。

另请参阅 setCheckBox()。

QAbstractButton *QMessageBox::clickedButton() const

返回用户点击的按钮，或当用户按下键并未设置退出按钮时为nullptr。

如果尚未调用exec()，则返回nullptr。

示例

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

另请参阅 standardButton()和button()。

[覆盖虚保护] void QMessageBox::closeEvent(QCloseEvent *e)

实现了：QDialog::closeEvent(QCloseEvent *e)。

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

在指定父组件 ottenere una finestra a messaggio critica con il titolo fornito ed il testo specificato.

Aggiunge i pulsanti standard alla finestra a messaggio. defaultButton definisce il pulsante utilizzato quando premereInvio。 defaultButton deve fare riferimento a un pulsante specificato in pulsanti。 Se defaultButton èQMessageBox::NoButton，QMessageBox seleziona automaticamente un pulsante di default appropriato.

Restituisce l'identità del pulsante standard che è stato cliccato. Se viene premostrEsc al posto, viene restituito ilpulsante di escape.

La finestra a messaggio è una finestra di dialogoa modalità applicativa.

Altro vedere question()，warning() e information()。

QPushButton *QMessageBox::defaultButton() const

Restituisce il pulsante che dovrebbe essere ilpulsante di default del messaggio. Restituisce nullptr se non è impostato né pulsante di default né pulsante di escape.

参阅：setDefaultButton()，addButton() 和 QPushButton::setDefault()。

QAbstractButton *QMessageBox::escapeButton() const

返回当按下 Esc 键时被激活的按钮。

默认情况下，QMessageBox 尝试自动检测 escape 按钮如下所示：

1. 如果只有一个按钮，该按钮将成为 escape 按钮。
2. 如果有 取消 按钮，它将成为 escape 按钮。
3. 仅在 macOS 上，如果只有一个按钮具有 QMessageBox::RejectRole 角色，它将成为 escape 按钮。

当无法自动检测 escape 按钮时，按 Esc 无效。

参阅：setEscapeButton() 和 addButton()。

[覆盖虚拟受保护] bool QMessageBox::event(QEvent *e)

重新实现：QWidget::event(QEvent *event).

[覆盖虚拟槽] int QMessageBox::exec()

重新实现：QDialog::exec().

以模态对话框的形式显示消息框，直到用户关闭它才解除阻塞。

当使用具有标准按钮的 QMessageBox 时，此函数返回一个指示被点击的标准按钮的 StandardButton 值。当使用自定义按钮的 QMessageBox 时，此函数返回一个不透明的值；使用 clickedButton() 来确定哪个按钮被点击。

直到用户关闭对话框（无论是通过点击按钮还是使用窗口系统提供的机制），用户不能与同一应用程序中的任何其他窗口进行交互。

参阅：show() 和 result()。

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

在指定的 parent 小部件之前打开一个具有给定 title 和 text 的信息消息框。

Aggiunge i pulsanti standard alla finestra a messaggio. defaultButton definisce il pulsante utilizzato quando premereInvio。 defaultButton deve fare riferimento a un pulsante specificato in pulsanti。 Se defaultButton èQMessageBox::NoButton，QMessageBox seleziona automaticamente un pulsante di default appropriato.

Restituisce l'identità del pulsante standard che è stato cliccato. Se viene premostrEsc al posto, viene restituito ilpulsante di escape.

La finestra a messaggio è una finestra di dialogoa modalità applicativa.

参阅：question()，warning() 和 critical()。

[覆盖虚拟受保护] void QMessageBox::keyPressEvent(QKeyEvent *e)

重新实现：QDialog::keyPressEvent(QKeyEvent *e).

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

打开对话框，并将其 finished() 或 buttonClicked() 信号连接到 receiver 和 member 指定的槽。如果 member 中的槽的第一个参数是指针，则连接到 buttonClicked()，否则连接到 finished()。

当对话框关闭时，将信号从槽断开。

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

在指定的 parent 小部件之前打开带有给定 title 和 text 的询问消息框。

Aggiunge i pulsanti standard alla finestra a messaggio. defaultButton definisce il pulsante utilizzato quando premereInvio。 defaultButton deve fare riferimento a un pulsante specificato in pulsanti。 Se defaultButton èQMessageBox::NoButton，QMessageBox seleziona automaticamente un pulsante di default appropriato.

Restituisce l'identità del pulsante standard che è stato cliccato. Se viene premostrEsc al posto, viene restituito ilpulsante di escape.

La finestra a messaggio è una finestra di dialogoa modalità applicativa.

另请参阅信息，警告 和 严重。

void QMessageBox::removeButton(QAbstractButton *button)

从按钮框中移除 button 而不删除它。

另请参阅添加按钮 和 设置标准按钮。

[重写虚受保护] void QMessageBox::resizeEvent(QResizeEvent *event)

重新实现了：QDialog::resizeEvent(QResizeEvent *).

void QMessageBox::setCheckBox(QCheckBox *cb)

在消息对话框上设置复选框 cb。消息框拥有复选框的所有权。参数 cb 可以是 nullptr 以移除消息框中的现有复选框。

另请参阅复选框。

void QMessageBox::setDefaultButton(QPushButton *button)

将消息框的 默认按钮 设置为 button。

另请参阅默认按钮，添加按钮 和 QPushButton::setDefault。

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

将消息框的 默认按钮 设置为 button。

另请参阅添加按钮 和 QPushButton::setDefault。

void QMessageBox::setEscapeButton(QAbstractButton *button)

设置当按下Esc键时被激活的按钮为button。

另请参阅escapeButton()，addButton()和clickedButton。

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

设置当按下Esc键时被激活的按钮为button。

另请参阅addButton()和clickedButton。

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

如果on为true，则将给定的option设置为启用；否则，清除给定的option。

选项（尤其是Option::DontUseNativeDialog选项）应在显示对话框之前设置。

当对话框可见时设置选项，不一定直接对对话框产生效果。

在更改其他属性之后设置选项可能会导致这些值无效。

此功能是在Qt 6.6中引入的。

另请参阅options和testOption。

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

此函数隐藏了QWidget::setWindowModality。

将消息框的模式设置为windowModality。

在macOS上，如果模式设置为Qt::WindowModal且消息框有父对象，则消息框将是一个Qt::Sheet，否则消息框将是一个标准对话框。

void QMessageBox::setWindowTitle(const QString &title)

此函数隐藏了QWidget::setWindowTitle。

将消息框的标题设置为title。在macOS上，窗口标题将被忽略（符合macOS指南要求）。

[重写虚受保护] void QMessageBox::showEvent(QShowEvent *e)

重写: QDialog::showEvent(QShowEvent *event)。

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

返回与给定button对应的标准按钮枚举值，或者如果给定的button不是标准按钮，则返回NoButton。

另请参阅button()和standardButtons。

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

如果给定的option被启用，则返回true；否则返回false。

此功能是在Qt 6.6中引入的。

另请参阅options和setOption。

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

在指定的 parent 小部件前打开带给定 title 和 text 的警告信息框。

Aggiunge i pulsanti standard alla finestra a messaggio. defaultButton definisce il pulsante utilizzato quando premereInvio。 defaultButton deve fare riferimento a un pulsante specificato in pulsanti。 Se defaultButton èQMessageBox::NoButton，QMessageBox seleziona automaticamente un pulsante di default appropriato.

Restituisce l'identità del pulsante standard che è stato cliccato. Se viene premostrEsc al posto, viene restituito ilpulsante di escape.

La finestra a messaggio è una finestra di dialogoa modalità applicativa.

另请参阅 question()，information() 和 critical()。