MessageBoxHandler 类

QInstaller 类::MessageBoxHandler

MessageBoxHandler 类提供了用于通知用户或向用户提问以及在获取答案时的模态对话框。更多...

头文件 #include <MessageBoxHandler>
继承 QObject

公共类型

枚举DefaultAction { AskUser, Accept, Reject, Default }
枚举MessageType { criticalType, informationType, questionType, warningType }

公共函数

intcritical(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Ok, int button = QMessageBox::NoButton)
intinformation(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Ok, int button = QMessageBox::NoButton)
intquestion(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Yes | QMessageBox::No, int button = QMessageBox::NoButton)
voidsetAutomaticAnswer(const QString &identifier, QMessageBox::StandardButton answer)
voidsetDefaultAction(QInstaller::MessageBoxHandler::DefaultAction defaultAction)
intwarning(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Ok, int button = QMessageBox::NoButton)

静态公共成员

QMessageBox::StandardButtoncritical(QWidget *parent, const QString &identifier, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = QMessageBox::Ok, QMessageBox::StandardButton button = QMessageBox::NoButton)
QWidget *currentBestSuitParent()
QMessageBox::StandardButtoninformation(QWidget *parent, const QString &identifier, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = QMessageBox::Ok, QMessageBox::StandardButton button = QMessageBox::NoButton)
QInstaller::MessageBoxHandler *instance()
QListorderedButtons()
QMessageBox::StandardButtonquestion(QWidget *parent, const QString &identifier, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = QMessageBox::Yes | QMessageBox::No, QMessageBox::StandardButton button = QMessageBox::NoButton)
QMessageBox::StandardButtonwarning(QWidget *parent, const QString &identifier, const QString &title, const QString &text, QMessageBox::StandardButtons buttons = QMessageBox::Ok, QMessageBox::StandardButton button = QMessageBox::NoButton)

详细信息

var result = QMessageBox.question("quit.question", "Installer", "Do you want to quit the installer?",
                                  QMessageBox.Yes | QMessageBox.No);
if (result == QMessageBox.Yes) {
   // ...
}

消息框中的按钮

QMessageBox 定义了一系列常见按钮

成员类型文档

枚举 MessageBoxHandler::DefaultAction

此枚举值保存消息框处理的默认操作

常数描述
QInstaller::MessageBoxHandler::AskUser0询问最终用户确认。
QInstaller::MessageBoxHandler::Accept1接受消息框。
QInstaller::MessageBoxHandler::Reject2拒绝消息框。
QInstaller::MessageBoxHandler::Default3使用消息框的默认答案集。

枚举 MessageBoxHandler::MessageType

此枚举值保存显示在消息框中的消息的严重级别

常数描述
QInstaller::MessageBoxHandler::criticalType0报告关键错误。
QInstaller::MessageBoxHandler::informationType1报告关于正常操作的信息。
QInstaller::MessageBoxHandler::questionType2在正常操作过程中提问。
QInstaller::MessageBoxHandler::warningType3报告非关键错误。

成员函数文档

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

以父对象 parent,标识符 identifier,标题 title 和文本 text 打开一个关键的消息框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

[可调用] int MessageBoxHandler::critical(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Ok, int button = QMessageBox::NoButton)

使用标识符 identifier,标题 title 和文本 text 打开一个关键的消息框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

注意:此函数可以通过元对象系统和 QML 进行调用。请参阅 Q_INVOKABLE

[静态] QWidget *MessageBoxHandler::currentBestSuitParent()

返回最适合成为消息框父件的部件或窗口。如果没有找到应用程序,则返回 0

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

打开带有父对象 parent、标识符 identifier、标题 title 和文本 text 的信息对话框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

[可调用] int MessageBoxHandler::information(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Ok, int button = QMessageBox::NoButton)

打开带有标识符 identifier、标题 title 和文本 text 的信息对话框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

注意:此函数可以通过元对象系统和 QML 进行调用。请参阅 Q_INVOKABLE

[静态] QInstaller::MessageBoxHandler *MessageBoxHandler::instance()

返回一个消息框处理程序实例。

[静态] QList<QMessageBox::Button> MessageBoxHandler::orderedButtons()

返回在消息框中显示的按钮的有序列表。

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

打开带有父对象 parent、标识符 identifier、标题 title 和文本 text 的询问消息框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

[可调用] int MessageBoxHandler::question(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Yes | QMessageBox::No, int button = QMessageBox::NoButton)

打开带有标识符 identifier、标题 title 和文本 text 的询问消息框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

注意:此函数可以通过元对象系统和 QML 进行调用。请参阅 Q_INVOKABLE

void MessageBoxHandler::setAutomaticAnswer(const QString &identifier, QMessageBox::StandardButton answer)

设置用作默认按钮并可在自动模式下显示消息框时自动调用的按钮。字符串 identifier 用于标识与默认按钮 answer 相关的消息框。

void MessageBoxHandler::setDefaultAction(QInstaller::MessageBoxHandler::DefaultAction defaultAction)

将消息框的默认操作设置为 defaultAction

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

以父类 parent、标识 identifier、标题 title 和文本 text 打开一个警告消息框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

[可调用] int MessageBoxHandler::warning(const QString &identifier, const QString &title, const QString &text, int buttons = QMessageBox::Ok, int button = QMessageBox::NoButton)

以标识 identifier、标题 title 和文本 text 打开一个警告消息框。

buttons 中指定的标准按钮添加到消息框。 button 指定了按下 Enter 键时使用的按钮。 button 必须引用在 buttons 中指定的按钮。如果 buttonQMessageBox::NoButton,则自动选择合适的默认选项。

返回被点击的标准按钮的标识符。但是,如果按下 Esc 键,则返回 esc 按钮。

注意:此函数可以通过元对象系统和 QML 进行调用。请参阅 Q_INVOKABLE

©2021 The Qt Company Ltd. 本文档中包含的贡献是各自拥有者的版权。本文档受 GNU自由文档许可证版本1.3 的条款许可,该许可证由自由软件基金会发布。Qt Company、Qt 及其相应标志是芬兰及其它国家和地区 Qt Company Ltd. 的商标。所有其他商标均为各自拥有者的财产。