PyQt5 – QActionGroup

下面为你详细讲解Python中PyQt5模块中QActionGroup类的完整使用攻略：

一、概述

在PyQt5中，QActionGroup是一个动作组，用于管理几个相关的QAction对象。可以将QActionGroup看成是一组单选按钮。常见用法是用QActionGroup来创建菜单、工具栏或自定义按钮等交互界面中的控件。

QActionGroup类继承自QObject类，因此可以通过连接（connect）这个对象的信号和槽（slot）函数来控制对象的行为。

二、QActionGroup的基本用法

QActionGroup对象的创建非常简单，只需要在初始化时将父级节点作为参数即可。例如：

action_group = QActionGroup(self)

创建了一个名为"action_group"的QActionGroup对象，并将其设置为self对象的子级。

在QActionGroup对象中，可以通过addAction()方法向组中添加QAction对象。例如：

action1 = QAction("One", self)
action2 = QAction("Two", self)
action3 = QAction("Three", self)

action_group.addAction(action1)
action_group.addAction(action2)
action_group.addAction(action3)

在这段代码中，我们创建了三个名为"action1"、 "action2"和"action3"的QAction对象，并通过addAction()方法添加到名为"action_group"的QActionGroup对象中。

需要注意的是，QAction对象的parent必须设置为QActionGroup对象，否则添加到一个没有父级的QActionGroup中将会出错。

三、QActionGroup的常用方法

1. checkedAction()

checkedAction()返回当前选中的QAction对象，如果当前没有选中的QAction，则返回None。例如：

checked_action = action_group.checkedAction()

该方法可以用于更新程序中的响应界面状态。

2. setExclusive()

在QActionGroup中，setExclusive()方法用于设置组内的QAction对象是否为互斥（只能选择一个）。默认情况下，组内的QAction对象是互斥的。

action_group.setExclusive(False)

将组内的QAction对象设置为非互斥。

四、QActionGroup的示例演示

1. 菜单栏添加单选菜单

from PyQt5.QtWidgets import QMainWindow，QMenuBar，QMenu，QAction，QApplication，QActionGroup
from PyQt5.QtCore import Qt

class MyWindow(QMainWindow):

    def __init__(self):
        super().__init__()

        menubar = self.menuBar()
        menu = menubar.addMenu("File")

        action_group = QActionGroup(self)

        text_action = QAction("Text", self)
        text_action.setCheckable(True)
        text_action.setChecked(True)
        action_group.addAction(text_action)
        menu.addAction(text_action)

        image_action = QAction("Image", self)
        image_action.setCheckable(True)
        action_group.addAction(image_action)
        menu.addAction(image_action)

app = QApplication([])

window = MyWindow()
window.show()

app.exec_()

在这个示例中，我们创建了一个名为"File"的菜单，并在菜单中添加了两个QAction对象"Text"和"Image"。我们将这两个QAction对象添加到了同一个QActionGroup对象中，这意味着在菜单中只能选择一个QAction对象。

2. 工具栏添加单选按钮

from PyQt5.QtWidgets import QMainWindow，QToolBar，QAction，QApplication，QActionGroup
from PyQt5.QtGui import QIcon
from PyQt5.QtCore import Qt

class MyWindow(QMainWindow):

    def __init__(self):
        super().__init__()

        toolbar = self.addToolBar("Tool")

        action_group = QActionGroup(self)

        line_action = QAction(QIcon("line.png"), "Line", self)
        line_action.setCheckable(True)
        line_action.setChecked(True)
        action_group.addAction(line_action)
        toolbar.addAction(line_action)

        rect_action = QAction(QIcon("rect.png"), "Rectangle", self)
        rect_action.setCheckable(True)
        action_group.addAction(rect_action)
        toolbar.addAction(rect_action)

app = QApplication([])

window = MyWindow()
window.show()

app.exec_()

在该示例中，我们创建了一个名为"Tool"的工具栏，并在该工具栏上添加了两个QAction对象。同样，我们将这两个QAction对象添加到了同一个QActionGroup对象中，这意味着在工具栏中只能选择一个QAction对象。