PyQt QDialog: 如何使用问号 () 按钮

在本文中，我们将介绍如何使用 PyQt 中 QDialog 类的问号按钮，以及如何处理用户对话框中的问号按钮的点击事件。QDialog 是 PyQt 中用于创建对话框的基类，它提供了丰富的功能和属性，方便我们进行自定义对话框的设计和实现。

阅读更多：PyQt 教程

QDialog 问号按钮的功能

问号按钮是 QDialog 类自带的一个按钮，通常位于对话框右上角的标题栏，在大多数操作系统平台上都有相同的显示。用户点击问号按钮后，鼠标会变为一个问号的形状，然后用户再点击对话框的任意部分，对话框会展示有关该对话框的帮助信息。

问号按钮为用户提供了一种快速访问帮助文档或说明的方式，帮助用户了解如何使用该对话框或了解相关的信息。对于复杂的对话框，使用问号按钮可以提高用户的操作效率和体验。

设置问题按钮

为了在 PyQt 中使用问号按钮，我们需要通过重写 QDialog 类的 showEvent() 方法来实现。showEvent() 方法在对话框显示前被调用，我们可以在此方法中添加和定制对话框的问号按钮。

下面是一个简单的示例代码，展示了如何在 PyQt 对话框中设置问号按钮：

from PyQt5.QtWidgets import QApplication, QDialog, QPushButton, QVBoxLayout, QWhatsThis

class MyDialog(QDialog):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("My Dialog")

        layout = QVBoxLayout()
        button = QPushButton("Click Me")
        button.clicked.connect(self.show_help)
        layout.addWidget(button)

        self.setLayout(layout)

    def show_help(self):
        QWhatsThis.enterWhatsThisMode()
        QWhatsThis.showText(QWhatsThis.why(), self.mapToGlobal(self.rect().topRight()))

app = QApplication([])
dialog = MyDialog()
dialog.exec_()

在这个示例中，我们创建了一个自定义的 QDialog 子类 MyDialog，重写了父类的 showEvent() 方法，通过调用 QWhatsThis 类的 enterWhatsThisMode() 方法和 showText() 方法，来显示帮助信息。

当用户点击按钮时，show_help() 方法会被调用，首先进入帮助模式，然后使用 showText() 方法来显示帮助信息，帮助信息的内容可以通过参数进行自定义。

处理问号按钮的点击事件

除了在对话框中显示帮助信息，我们还可以为问号按钮绑定其他的点击事件。当用户点击问号按钮时，我们可以触发一些自定义的操作，比如打开一个帮助文档或者跳转到一个特定的网页等。

为了实现这一功能，在 MyDialog 类中，我们可以重写 QDialog 类的 onHelpRequested() 方法来处理问号按钮的点击事件。下面是一个处理问号按钮点击事件的示例代码：

from PyQt5.QtWidgets import QApplication, QDialog, QPushButton, QVBoxLayout, QWhatsThis

class MyDialog(QDialog):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("My Dialog")

        layout = QVBoxLayout()
        button = QPushButton("Click Me")
        button.clicked.connect(self.on_button_clicked)
        layout.addWidget(button)

        self.setLayout(layout)

    def on_button_clicked(self):
        print("Button clicked!")

    def onHelpRequested(self):
        print("Question mark button clicked!")

app = QApplication([])
dialog = MyDialog()
dialog.setWhatsThis("?")
dialog.setWindowFlags(dialog.windowFlags() | Qt.WindowContextHelpButtonHint)
dialog.exec_()

在这个示例中，我们在 MyDialog 类中重写了 onHelpRequested() 方法，并在方法中打印了一条消息来表示问号按钮的点击事件被触发。同时，我们还通过调用 setWhatsThis() 方法来设置帮助文本内容。

通过上述代码，我们可以在窗口中的按钮被点击时，控制台会输出”Button clicked!”的消息，而当问号按钮被点击时，控制台会输出”Question mark button clicked!”的消息。

需要注意的是，在重写 QDialog 类的 onHelpRequested() 方法时，我们需要确保在 QDialog 类中设置了 setWindowFlags() 方法，并将 Qt.WindowContextHelpButtonHint 标志加入到窗口的标志中，以确保问号按钮能够正常工作。