PyQt5 QCommandLinkButton – 添加动作对象

当我们在PyQt5中创建GUI界面时，经常需要添加各种交互控件，例如按钮、复选框、单选按钮等等。其中，QCommandLinkButton是一种专为用户指引而设计的按钮。它提供明确的文本和一个指向相关文档的URL链接。

在QCommandLinkButton中添加动作对象非常简单。下面就详细讲解一下具体操作步骤以及两个示例说明：

步骤一：创建命令式链接按钮

首先，我们需要创建QCommandLinkButton控件，在界面中显示。下面是创建QCommandLinkButton的代码：

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QCommandLinkButton

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()

        cmd_button = QCommandLinkButton("按钮名称", self)
        cmd_button.setGeometry(50, 50, 200, 50)

        layout = QVBoxLayout(self)
        layout.addWidget(cmd_button)

if __name__ == '__main__':
    app = QApplication([])
    win = MyWidget()
    win.show()
    app.exec_()

在代码中，我们创建了一个名为cmd_button的QCommandLinkButton对象，并设置它在窗口中的位置和大小。接下来，我们将它添加到垂直布局中，并将布局应用到窗口上。

步骤二：添加菜单动作

我们接下来需要将动作添加到QCommandLinkButton对象中。QCommandLinkButton提供了一个addAction()方法，可用于添加QAction类的动作对象。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QCommandLinkButton, QAction

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()

        cmd_button = QCommandLinkButton("按钮名称", self)
        cmd_button.setGeometry(50, 50, 200, 50)

        action = QAction("动作名称", self)
        cmd_button.addAction(action)

        layout = QVBoxLayout(self)
        layout.addWidget(cmd_button)

if __name__ == '__main__':
    app = QApplication([])
    win = MyWidget()
    win.show()
    app.exec_()

在代码中，我们创建了一个名为action的QAction对象，并将它添加到QCommandLinkButton中。如果需要添加多个动作对象，可以重复使用addAction()方法即可。

示例一：在QCommandLinkButton中添加多个动作

我们通过一个具体的示例说明如何在QCommandLinkButton中添加多个动作对象。在示例中，我们创建了一个QCommandLinkButton，然后在其中添加了两个动作对象。除此之外，我们还定义了两个槽函数，用于分别输出动作1和动作2的文本信息。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QCommandLinkButton, QAction

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()

        cmd_button = QCommandLinkButton("按钮名称", self)
        cmd_button.setGeometry(50, 50, 200, 50)

        action1 = QAction("动作1", self)
        action2 = QAction("动作2", self)

        cmd_button.addAction(action1)
        cmd_button.addAction(action2)

        layout = QVBoxLayout(self)
        layout.addWidget(cmd_button)

        action1.triggered.connect(self.on_action1_triggered)
        action2.triggered.connect(self.on_action2_triggered)

    def on_action1_triggered(self):
        print("点击了动作1")

    def on_action2_triggered(self):
        print("点击了动作2")

if __name__ == '__main__':
    app = QApplication([])
    win = MyWidget()
    win.show()
    app.exec_()

在示例中，我们通过action1.triggered.connect()方法将槽函数与动作1相连，通过action2.triggered.connect()方法将槽函数与动作2相连。

示例二：在QCommandLinkButton中添加菜单动作并设置快捷键

我们通过一个具体的示例说明如何在QCommandLinkButton中添加菜单动作并设置快捷键。在示例中，我们创建了一个QCommandLinkButton，在其中添加了一个动作对象，并设置了快捷键。在点击按钮后，按下快捷键即可执行动作。

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QCommandLinkButton, QAction

class MyWidget(QWidget):
    def __init__(self):
        super().__init__()

        cmd_button = QCommandLinkButton("按钮名称", self)
        cmd_button.setGeometry(50, 50, 200, 50)

        action = QAction("动作名称", self)
        action.setShortcut("Ctrl+A")
        cmd_button.addAction(action)

        layout = QVBoxLayout(self)
        layout.addWidget(cmd_button)

        action.triggered.connect(self.on_action_triggered)

    def on_action_triggered(self):
        print("点击了动作，按下快捷键")

if __name__ == '__main__':
    app = QApplication([])
    win = MyWidget()
    win.show()
    app.exec_()

在示例中，我们通过action.setShortcut()方法设置了快捷键，可以看到创建的菜单，它的快捷键为Ctrl+A。在triggered信号发射时，程序调用on_action_triggered()方法来执行动作。

因为常常需要动态调整菜单的内容和行为，所以QCommandLinkButton提供了很多丰富的动态操作功能，例如插入、移除和清空动作。所以，QCommandLinkButton是一种非常方便实用的控件，在Qt中用于创建明确的文本与文档之间的链接，可以给用户提供足够清晰的操作指引。