PySide6.QtWidgets.QErrorMessage

class QErrorMessage

QErrorMessage 类提供了一个错误消息显示对话框。更多

PySide6.QtWidgets.QErrorMessage 的继承图

概要

方法

插槽

静态函数

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

错误消息小部件由一个文本标签和一个复选框组成。复选框允许用户控制是否在未来再次显示相同的错误消息,通常会显示翻译成适当本地语言的文本,“再次显示此消息”。

对于生产应用程序,该类可用于显示用户只需查看一次的消息。要像这样使用QErrorMessage,您可以按通常方式创建对话框,并通过调用showMessage()槽或连接信号来显示它。

静态函数 qtHandler() 使用 qInstallMessageHandler() 安装消息处理程序,并创建一个 QErrorMessage 来显示 qDebug()、qWarning() 和 qFatal() 消息。这在没有控制台可用于显示警告和错误消息的环境中非常有用。

在这两种情况下,QErrorMessage 将会排队等待的消息并按顺序显示它们,每当用户接受前一条消息后,新的消息就会立即显示。一旦用户指定不再显示某条消息,该消息将自动跳过,对话框将显示队列中的下一条合适的消息。

标准对话框示例展示了如何使用QErrorMessage以及其他内置的Qt对话框。

../../_images/qerrormessage.png

另请参阅

QMessageBox showMessage() 标准对话框示例

__init__([parent=None])
Parameters:

父级QWidget

使用给定的parent构建并安装一个错误处理窗口。

对话框的默认窗口模态取决于平台。在调用showMessage()之前,可以通过setWindowModality()来覆盖窗口模态。

static qtHandler()
Return type:

QErrorMessage

返回一个指向QErrorMessage对象的指针,该对象输出默认的Qt消息。如果尚未存在这样的对象,此函数将创建一个。

该对象将仅输出QLoggingCategory::defaultCategory()的日志消息。

该对象将把所有消息转发给原始消息处理程序。

另请参阅

qInstallMessageHandler

showMessage(message)
Parameters:

消息 – str

显示给定的消息,message,并立即返回。如果用户请求不再显示该消息,则此函数不执行任何操作。

通常,消息会立即显示。但是,如果有待处理的消息,它将被排队稍后显示。

showMessage(message, type)
Parameters:
  • message – str

  • type – str

这是一个重载函数。

显示给定的消息,message,并立即返回。如果用户已请求不再显示类型为type的消息,则此函数不执行任何操作。

通常,消息会立即显示。但是,如果有待处理的消息,它将被排队稍后显示。

另请参阅

showMessage()