QMessageBox废弃成员

以下QMessageBox类的成员已弃用。 它们被提供以保持旧代码的运行。我们强烈建议不要在新代码中使用它们。

公共类型

公共函数

静态公共成员

成员类型文档

[已弃用] QMessageBox::Button

此typedef已弃用。我们强烈建议不要在新代码中使用它。

使用 QMessageBox::StandardButton 代替。

成员函数文档

[已弃用] QMessageBox::QMessageBox(const QString &标题, const QString &文本, QMessageBox::Icon 图标, int 按钮0, int 按钮1, int 按钮2, QWidget *父对象 = nullptr, Qt::WindowFlags 标志 = Qt::Dialog | Qt::MSWindowsFixedSizeDialogHint)

此函数已弃用。我们强烈建议不要在新代码中使用它。

使用此函数构建具有 标题、文本、图标 和最多三个按钮的消息框。

图标 必须是以下之一

• QMessageBox::NoIcon
• QMessageBox::Question
• QMessageBox::Information
• QMessageBox::Warning
• QMessageBox::Critical

每个按钮，即 按钮0、按钮1 和 按钮2，可以具有以下值之一

• QMessageBox::NoButton
• QMessageBox::Ok
• QMessageBox::Cancel
• QMessageBox::Yes
• QMessageBox::No
• QMessageBox::Abort
• QMessageBox::Retry
• QMessageBox::Ignore
• QMessageBox::YesAll
• QMessageBox::NoAll

使用 QMessageBox::NoButton 以在您的消息框中具有少于三个按钮。如果您一点也不指定按钮，则 QMessageBox 将提供一个“确定”按钮。

可以之一与 QMessageBox::Default 标志进行按位或，使其成为默认按钮（当按下 Enter 时被点击）。

可以之一与 QMessageBox::Escape 标志进行按位或，使其成为取消或关闭按钮（当按下 Esc 时被点击）。

        QMessageBox mb("Application Name",
                       "Hardware failure.\n\nDisk error detected\nDo you want to stop?",
                       QMessageBox::Question,
                       QMessageBox::Yes | QMessageBox::Default,
                       QMessageBox::No | QMessageBox::Escape,
                       QMessageBox::NoButton);
        if (mb.exec() == QMessageBox::No) {
            // try again

消息框是一个 应用模态 对话框。

将 父对象 和 标志 参数传递给 QDialog 构造函数。

另请参阅setWindowTitle()，setText() 和 setIcon()。

[已弃用] QString QMessageBox::buttonText(int 按钮) const

此函数已弃用。我们强烈建议不要在新代码中使用它。

返回消息框按钮 按钮 的文本，如果消息框不包含该按钮，则返回空字符串。

请使用 button() 和 QPushButton::text() 代替。

另请参阅setButtonText。

[静态，自6.2版本开始弃用] int QMessageBox::critical(QWidget *parent, const QString &title, const QString &text, int button0, int button1, int button2 = 0)

此函数自6.2版本开始已弃用。我们强烈建议在新代码中不要使用它。

请改用不接受 StandardButtons 的重载版本。

打开一个带有指定 标题 和 文本 的临界消息框。对话框可以有三个按钮。每个按钮参数 button0、button1 和 button2 可设为以下值之一

• QMessageBox::NoButton
• QMessageBox::Ok
• QMessageBox::Cancel
• QMessageBox::Yes
• QMessageBox::No
• QMessageBox::Abort
• QMessageBox::Retry
• QMessageBox::Ignore
• QMessageBox::YesAll
• QMessageBox::NoAll

如果您不希望有三个按钮，则将最后一个（或最后两个）按钮设置为 QMessageBox::NoButton。

一个按钮可以与 QMessageBox::Default 进行 OR 运算，另一个按钮可以与此进行 OR 运算 QMessageBox::Escape。

返回被点击按钮的身份（例如 QMessageBox::Ok 或 QMessageBox::No 等）。

消息框是一个 应用模态 对话框。

另请参阅 information()、question() 及 warning()。

[静态，自6.2版本开始弃用] int QMessageBox::critical(QWidget *parent, const QString &title, const QString &text, const QString &button0Text, const QString &button1Text = QString(), const QString &button2Text = QString(), int defaultButtonNumber = 0, int escapeButtonNumber = -1)

此函数自6.2版本开始已弃用。我们强烈建议在新代码中不要使用它。

请改用不接受 StandardButtons 的重载版本。

这是一个重载函数。

显示一个带有给定 标题 和 文本 的临界错误消息框，以及一个、两个或三个按钮。返回被点击按钮的编号（0、1或2）。

button0Text 是第一个按钮的文本，是可选的。如果没有提供 button0Text，将使用“确定”（已翻译）。button1Text 是第二个按钮的文本，是可选的，而 button2Text 是第三个按钮的文本，也是可选的。defaultButtonNumber（0、1或2）是默认按钮的索引；按下 Return 或 Enter 等同于点击默认按钮。默认为0（第一个按钮）。escapeButtonNumber 是 Escape 按钮的索引；按下 Escape 等同于点击此按钮。默认为-1；提供0、1或2则按下 Escape 等同于点击相应的按钮。

消息框是一个 应用模态 对话框。

另请参阅 information()、question() 及 warning()。

[静态，自6.2版本开始弃用] int QMessageBox::information(QWidget *parent, const QString &title, const QString &text, int button0, int button1 = 0, int button2 = 0)

此函数自6.2版本开始已弃用。我们强烈建议在新代码中不要使用它。

请改用不接受 StandardButtons 的重载版本。

以指定的 标题 和 文本 打开信息消息框。对话框可包含最多三个按钮。每个按钮 button0、button1 和 button2 可以设置为以下值之一

• QMessageBox::NoButton
• QMessageBox::Ok
• QMessageBox::Cancel
• QMessageBox::Yes
• QMessageBox::No
• QMessageBox::Abort
• QMessageBox::Retry
• QMessageBox::Ignore
• QMessageBox::YesAll
• QMessageBox::NoAll

如果您不希望有三个按钮，则将最后一个（或最后两个）按钮设置为 QMessageBox::NoButton。

一个按钮可以与 QMessageBox::Default 进行 OR 运算，另一个按钮可以与此进行 OR 运算 QMessageBox::Escape。

返回被点击按钮的身份（例如 QMessageBox::Ok 或 QMessageBox::No 等）。

消息框是一个 应用模态 对话框。

另请参阅 问题()，警告()，以及 临界()。

[静态，已过时] int QMessageBox::information(QWidget *parent，const QString &title，const QString &text，const QString &button0Text，const QString &button1Text = QString()，const QString &button2Text = QString()，int defaultButtonNumber = 0，int escapeButtonNumber = -1)

此函数已弃用。我们强烈建议不要在新代码中使用它。

自 6.2 版起使用接受 标准按钮 的重载版本。

这是一个重载函数。

显示具有给定 标题 和 文本 的信息消息框，以及一个、两个或三个按钮。返回被点击按钮的索引（0、1 或 2）。

button0Text 是第一个按钮的文本，是可选的。如果未提供 button0Text，则使用“确定”（已翻译）。button1Text 是第二个按钮的文本，是可选的。button2Text 是第三个按钮的文本，是可选的。defaultButtonNumber（0、1 或 2）是默认按钮的索引；按下 Return 或 Enter 与点击默认按钮相同。默认值为 0（第一个按钮）。escapeButtonNumber 是退出按钮的索引；按下 Esc 与点击此按钮相同。默认值为 -1；提供 0、1 或 2 以使按下 Esc 等同于点击相关按钮。

消息框是一个 应用模态 对话框。

另请参阅 问题()，警告()，以及 临界()。

[静态，6.2 版中已过时] int QMessageBox::question(QWidget *parent，const QString &title，const QString &text，int button0，int button1 = 0，int button2 = 0)

此函数自6.2版本开始已弃用。我们强烈建议在新代码中不要使用它。

请改用不接受 StandardButtons 的重载版本。

打开一个带有给定 标题 和 文本 的提问消息框。对话框可以包含最多三个按钮。每个按钮 button0、button1 和 button2 可以设置为以下值之一

• QMessageBox::NoButton
• QMessageBox::Ok
• QMessageBox::Cancel
• QMessageBox::Yes
• QMessageBox::No
• QMessageBox::Abort
• QMessageBox::Retry
• QMessageBox::Ignore
• QMessageBox::YesAll
• QMessageBox::NoAll

如果您不希望有三个按钮，则将最后一个（或最后两个）按钮设置为 QMessageBox::NoButton。

一个按钮可以与 QMessageBox::Default 进行 OR 运算，另一个按钮可以与此进行 OR 运算 QMessageBox::Escape。

返回被点击按钮的标识符（例如 QMessageBox::Yes 或 QMessageBox::No 等）。

消息框是一个 应用模态 对话框。

另请参阅 信息()，警告()，以及 临界()。

[静态，6.2 版中已过时] int QMessageBox::question(QWidget *parent，const QString &title，const QString &text，const QString &button0Text，const QString &button1Text = QString()，const QString &button2Text = QString()，int defaultButtonNumber = 0，int escapeButtonNumber = -1)

此函数自6.2版本开始已弃用。我们强烈建议在新代码中不要使用它。

请改用不接受 StandardButtons 的重载版本。

这是一个重载函数。

显示带有指定标题和文本的问题消息框，以及一个、两个或三个按钮。返回被点击的按钮索引（0、1或2）。

button0Text是第一个按钮的文本，是可选的。如果未提供button0Text，将使用默认的“确定”（已翻译）。button1Text是第二个按钮的文本，是可选的。button2Text是第三个按钮的文本，是可选的。defaultButtonNumber（0、1或2）是默认按钮的索引；按下Enter或Return键等于点击默认按钮。默认为0（第一个按钮）。escapeButtonNumber是Escape按钮的索引；按下Escape键等同于点击此按钮。默认为-1；提供0、1或2以使按下Escape等同于点击相应的按钮。

消息框是一个 应用模态 对话框。

另请参阅 信息()，警告()，以及 临界()。

[已过时] void QMessageBox::setButtonText(int button, const QString &text)

此函数已弃用。我们强烈建议不要在新代码中使用它。

设置消息框按钮button的文本为text。若为消息框中不存在的按钮设置文本，则会被静默忽略。

请使用addButton()。

另请参阅buttonText。

[静态，已过时] QPixmap QMessageBox::standardIcon(QMessageBox::Icon icon)

此函数已弃用。我们强烈建议不要在新代码中使用它。

返回用于标准图标的大图。这允许在更复杂的消息框中使用这些大图。icon指定所需的图标，例如 QMessageBox::Question、QMessageBox::Information、QMessageBox::Warning 或 QMessageBox::Critical。

请用QStyle::standardIcon() 并带QStyle::SP_MessageBoxInformation等来替换。

[静态，6.2版后已过时] int QMessageBox::warning(QWidget *parent, const QString &title, const QString &text, int button0, int button1, int button2 = 0)

此函数自6.2版本开始已弃用。我们强烈建议在新代码中不要使用它。

请改用不接受 StandardButtons 的重载版本。

打开一个警告消息框，带有指定的标题和文本。对话框可能有最多三个按钮。每个按钮参数 button0、button1 和 button2 可设置为以下值之一

• QMessageBox::NoButton
• QMessageBox::Ok
• QMessageBox::Cancel
• QMessageBox::Yes
• QMessageBox::No
• QMessageBox::Abort
• QMessageBox::Retry
• QMessageBox::Ignore
• QMessageBox::YesAll
• QMessageBox::NoAll

如果您不希望有三个按钮，则将最后一个（或最后两个）按钮设置为 QMessageBox::NoButton。

一个按钮可以与 QMessageBox::Default 进行 OR 运算，另一个按钮可以与此进行 OR 运算 QMessageBox::Escape。

返回被点击的按钮的标识（QMessageBox::Ok 或 QMessageBox::No 或 ...）。

消息框是一个 应用模态 对话框。

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

[静态，6.2 版本中已弃用] int QMessageBox::warning(QWidget *parent, const QString &title, const QString &text, const QString &button0Text, const QString &button1Text = QString(), const QString &button2Text = QString(), int defaultButtonNumber = 0, int escapeButtonNumber = -1)

此函数自6.2版本开始已弃用。我们强烈建议在新代码中不要使用它。

请改用不接受 StandardButtons 的重载版本。

这是一个重载函数。

显示一个带有给定 标题 和 文本 的警告消息框，以及一个、两个或三个按钮。返回被点击按钮的编号（0、1 或 2）。

button0Text 是第一个按钮的文本，是可选的。如果没有提供 button0Text，将使用“确定”（已翻译）。button1Text 是第二个按钮的文本，是可选的，而 button2Text 是第三个按钮的文本，也是可选的。defaultButtonNumber（0、1或2）是默认按钮的索引；按下 Return 或 Enter 等同于点击默认按钮。默认为0（第一个按钮）。escapeButtonNumber 是 Escape 按钮的索引；按下 Escape 等同于点击此按钮。默认为-1；提供0、1或2则按下 Escape 等同于点击相应的按钮。

消息框是一个 应用模态 对话框。

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