QErrorMessage Class
QErrorMessage 类提供了一个错误信息显示对话框。更多
| Header： | #include <QErrorMessage> |
| CMake.QErrorMessage | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承： | QDialog |
公共函数
| QErrorMessage(QWidget *parent = nullptr) | |
| virtual | ~QErrorMessage() |
公共插槽
| void | showMessage(const QString &message) |
| void | showMessage(const QString &message, const QString &type) |
静态公共成员
| QErrorMessage * | qtHandler() |
重新实现的受保护函数
| virtual void | changeEvent(QEvent *e) override |
| virtual void | done(int a) override |
详细说明
错误信息 widget 由一个文本标签和一个复选框组成。复选框可让用户控制将来是否再次显示相同的错误信息，通常会显示翻译成相应本地语言的文本 "再次显示此信息"。
对于生产应用程序，该类可用于显示用户只需看到一次的信息。要像这样使用 QErrorMessage，您可以按照常规方法创建对话框，并通过调用showMessage() 槽或连接信号来显示它。
静态qtHandler() 函数使用qInstallMessageHandler() 安装了一个消息处理程序，并创建了一个 QErrorMessage，用于显示qDebug(),qWarning() 和qFatal() 消息。这在没有控制台显示警告和错误信息的环境中最有用。
在这两种情况下，QErrorMessage 都会将待处理的消息排成队列，并按顺序显示，每条新消息都会在用户接受前一条消息后立即显示。一旦用户指定不再显示某条信息，该信息将自动跳过，对话框将显示队列中下一条合适的信息。
标准对话框示例展示了如何使用 QErrorMessage 以及其他内置 Qt 对话框。
另请参阅 QMessageBox,QStatusBar::showMessage() 和标准对话框示例。
成员函数文档
[explicit] QErrorMessage::QErrorMessage(QWidget *parent = nullptr)
使用给定的parent 构建并安装错误处理程序窗口。
对话框的默认window modality 取决于平台。窗口模式可在调用showMessage() 之前通过setWindowModality() 进行重写。
[virtual noexcept] QErrorMessage::~QErrorMessage()
销毁错误信息对话框。
[override virtual protected] void QErrorMessage::changeEvent(QEvent *e)
重实现：QWidget::changeEvent(QEvent *event).
[override virtual protected] void QErrorMessage::done(int a)
重实现：QDialog::done(int r)。
[static] QErrorMessage *QErrorMessage::qtHandler()
返回一个指向QErrorMessage 对象的指针，该对象可输出默认 Qt 消息。如果还没有这样一个对象，则该函数将创建这样一个对象。
该对象只会输出QLoggingCategory::defaultCategory() 的日志信息。
该对象将把所有消息转发给原始消息处理程序。
另请参见 qInstallMessageHandler 。
[slot] void QErrorMessage::showMessage(const QString &message)
显示给定的消息，message ，并立即返回。如果用户要求不再显示该消息，则该函数不会执行任何操作。
通常，消息会立即显示。但如果有待处理的消息，则会排队等待稍后显示。
[slot] void QErrorMessage::showMessage(const QString &message, const QString &type)
这是一个重载函数。
显示给定消息message 并立即返回。如果用户要求不再显示type 类型的消息，则该函数不会执行任何操作。
正常情况下，消息会立即显示。但是，如果有待处理的消息，则会排队等待稍后显示。
另请参阅 showMessage() 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
