PyQt5 QCommandLinkButton – 获取动作列表

针对您提出的问题，“PyQt5 QCommandLinkButton-获取动作列表”的完整使用攻略，下面就逐步展开：

1. 简介

PyQt5中的QCommandLinkButton类是一种命令按钮，它具有高亮的特点。QCommandLinkButton类扩展了QPushButton类，使其能够容易地创建符合Microsoft Windows用户界面指南的命令按钮。该类支持两种大小：普通和小型。它的构造函数是：

class PyQt5.QtWidgets.QCommandLinkButton(text: str = '', parent: PyQt5.QtWidgets.QWidget = None)

该类提供了获取动作列表的函数，可以方便地获取当前QCommandLinkButton上绑定的所有动作。

2. 函数说明

该类提供了两个函数获取动作列表：

2.1 actions()

该函数是继承于QWidget类的函数，用于获取当前QCommandLinkButton上绑定的所有动作。该函数的返回值为QList类型的指针，即所有动作的列表。

def actions(self) -> typing.List[PyQt5.QtWidgets.QAction]:
    '''Return type list[QAction]'''

2.2 actionsRemoved()

该信号是在QCommandLinkButton上的动作（通过setActions()设置）被移除时发出的信号。该信号带有一个QList类型的指针，其中包含了被移除的动作列表。

actionsRemoved = pyqtSignal(list)  # 信号：当动作列表发生变化

3. 综合示例

下面提供两个简单的示例，演示如何使用QCommandLinkButton的actions()函数：

3.1 示例一：

该示例展示了如何创建一个QCommandLinkButton，将一系列QAction绑定到按钮上，并获取所有动作列表。

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


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

        self.initUI()

    def initUI(self):

        # 创建QCommandLinkButton按钮
        button = QCommandLinkButton('动作列表', self)
        button.move(50, 50)

        # 创建动作
        action1 = QAction('动作1', self)
        action2 = QAction('动作2', self)
        action3 = QAction('动作3', self)

        # 将动作绑定到按钮上
        button.setActions([action1, action2, action3])

        # 获取所有动作列表
        actions_list = button.actions()
        print('所有动作列表：', [a.text() for a in actions_list])

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('QCommandLinkButton-获取动作列表')
        self.show()


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    sys.exit(app.exec_())

该示例创建了一个QCommandLinkButton按钮，并将三个QAction依次绑定到按钮上，最后使用actions()函数获取所有动作列表并打印输出结果。运行后，窗口中会出现一个名为“动作列表”的按钮，点击后会出现三个子选项，控制台中会输出所有动作的文本信息，即：

所有动作列表： ['动作1', '动作2', '动作3']

3.2 示例二：

该示例展示了如何创建一个QCommandLinkButton，然后通过连接actionsRemoved信号来监听动作列表的变化。

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


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

        self.initUI()

    def initUI(self):

        # 创建QCommandLinkButton按钮
        button = QCommandLinkButton('测试', self)
        button.move(50, 50)

        # 创建动作
        action1 = QAction('动作1', self)
        action2 = QAction('动作2', self)
        action3 = QAction('动作3', self)

        # 将动作绑定到按钮上
        button.setActions([action1, action2, action3])

        # 监听动作列表的变化
        button.actionsRemoved.connect(self.actions_removed)

        self.setGeometry(300, 300, 350, 250)
        self.setWindowTitle('QCommandLinkButton-获取动作列表')
        self.show()

    def actions_removed(self, actions_list):
        print('所有动作被删除：', [a.text() for a in actions_list])


if __name__ == '__main__':
    app = QApplication(sys.argv)
    demo = Demo()
    sys.exit(app.exec_())

该示例创建了一个QCommandLinkButton按钮，并将三个QAction依次绑定到按钮上，然后连接了该按钮的actionsRemoved信号和slots函数actions_removed()。当执行removeAction()方法来移除一个动作时，程序会触发该按钮的actionsRemoved信号，并且会传递一个包含被移除动作的QList类型的指针。此处重载的actions_removed()函数会接收该指针，并打印控制台输出所有被移除的动作的文本信息。即使演示的是动作被删除的情况，但是该方式同样适用于动作添加的情况，只需要在相应的slots函数中替换为动作添加的逻辑即可。运行后，窗口中会出现一个名为“测试”的按钮，点击后会出现三个子选项。现在，我们再次点击按钮，在弹出的菜单中选择任何一个选项进行删除，这时程序会输出被删除的动作文本信息，类似于：

所有动作被删除： ['动作1']