快捷導(dǎo)航

Python QButtonGroup類詳細(xì)介紹及常用方法

更新時(shí)間：2025年09月22日 15:32:15 作者：wanglaqqqq

QButtonGroup是PyQt5 中用于管理多個(gè)按鈕邏輯分組的類,常用于實(shí)現(xiàn)單選或多選功能,本文給大家介紹Python QButtonGroup類的常用方法,感興趣的朋友跟隨小編一起看看吧

QButtonGroup 是 PyQt5 中用于管理多個(gè)按鈕邏輯分組的類，常用于實(shí)現(xiàn)單選或多選功能。它允許將多個(gè)按鈕（如 QRadioButton、QCheckBox 或 QPushButton）歸為一組，統(tǒng)一處理選中狀態(tài)、信號(hào)和 ID 分配。以下是詳細(xì)介紹及常用方法：

一、核心功能

?互斥選擇：確保同一時(shí)間只有一個(gè)按鈕被選中（默認(rèn)啟用，適用于單選場(chǎng)景）。
?統(tǒng)一信號(hào)管理：通過(guò)組級(jí)信號(hào)處理所有按鈕的點(diǎn)擊、切換等事件。
?ID 綁定：為每個(gè)按鈕分配唯一 ID，便于快速識(shí)別。
?動(dòng)態(tài)增刪按鈕：支持運(yùn)行時(shí)添加或移除按鈕。

二、常用方法

?1. 創(chuàng)建與按鈕操作

方法	說(shuō)明	示例
`QButtonGroup(parent: QObject)`	構(gòu)造函數(shù)	`group = QButtonGroup()`
`addButton(button: QAbstractButton, id: int = -1)`	添加按鈕并可選分配 ID	`group.addButton(radio_btn, 1)`
`removeButton(button: QAbstractButton)`	從組中移除按鈕	`group.removeButton(btn)`

?2. 互斥性與選中狀態(tài)

方法	說(shuō)明	示例
`setExclusive(enable: bool)`	設(shè)置是否互斥（默認(rèn) True）	`group.setExclusive(False)`（允許多選）
`exclusive() -> bool`	檢查當(dāng)前是否互斥	`if group.exclusive(): ...`
`checkedButton() -> QAbstractButton`	返回當(dāng)前選中的按鈕（互斥模式下有效）	`selected = group.checkedButton()`
`checkedId() -> int`	返回選中按鈕的 ID（未設(shè)置 ID 時(shí)返回 -1）	`id = group.checkedId()`

?3. ID 管理

方法	說(shuō)明	示例
`setId(button: QAbstractButton, id: int)`	為按鈕設(shè)置 ID	`group.setId(btn, 1001)`
`id(button: QAbstractButton) -> int`	獲取按鈕的 ID	`btn_id = group.id(btn)`
`button(id: int) -> QAbstractButton`	根據(jù) ID 查找按鈕	`btn = group.button(1001)`

?4. 其他操作

方法	說(shuō)明	示例
`buttons() -> List[QAbstractButton]`	獲取組內(nèi)所有按鈕列表	`all_btns = group.buttons()`

?三、信號(hào)

信號(hào)	說(shuō)明	使用場(chǎng)景
`buttonClicked(button: QAbstractButton)`	按鈕被點(diǎn)擊時(shí)觸發(fā)	通用點(diǎn)擊事件
`buttonClicked(int)`	傳遞按鈕 ID 的點(diǎn)擊信號(hào)	根據(jù) ID 處理邏輯
`buttonToggled(button: QAbstractButton, checked: bool)`	按鈕切換狀態(tài)時(shí)觸發(fā)	監(jiān)聽(tīng)復(fù)選框勾選狀態(tài)

?四、代碼示例

1. 單選按鈕組（互斥）?

from PyQt5.QtWidgets import QApplication, QWidget, QVBoxLayout, QRadioButton, QButtonGroup, QLabel
class RadioDemo(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout(self)
        # 創(chuàng)建單選按鈕
        self.radio1 = QRadioButton("選項(xiàng)1")
        self.radio2 = QRadioButton("選項(xiàng)2")
        self.radio3 = QRadioButton("選項(xiàng)3")
        # 創(chuàng)建按鈕組并添加按鈕
        self.group = QButtonGroup(self)
        self.group.addButton(self.radio1, 1)  # 分配 ID
        self.group.addButton(self.radio2, 2)
        self.group.addButton(self.radio3, 3)
        # 監(jiān)聽(tīng)點(diǎn)擊事件（帶 ID）
        self.group.buttonClicked[int].connect(self.on_radio_clicked)
        # 添加控件到布局
        layout.addWidget(self.radio1)
        layout.addWidget(self.radio2)
        layout.addWidget(self.radio3)
        self.label = QLabel("當(dāng)前選中：無(wú)")
        layout.addWidget(self.label)
    def on_radio_clicked(self, btn_id):
        self.label.setText(f"當(dāng)前選中：選項(xiàng){btn_id}")
app = QApplication([])
window = RadioDemo()
window.show()
app.exec_()

?2. 多選按鈕組（非互斥）?

class CheckboxDemo(QWidget):
    def __init__(self):
        super().__init__()
        layout = QVBoxLayout(self)
        # 創(chuàng)建復(fù)選框
        self.check1 = QCheckBox("蘋(píng)果")
        self.check2 = QCheckBox("香蕉")
        self.check3 = QCheckBox("橙子")
        # 創(chuàng)建非互斥按鈕組
        self.group = QButtonGroup(self)
        self.group.setExclusive(False)  # 關(guān)閉互斥
        self.group.addButton(self.check1, 1)
        self.group.addButton(self.check2, 2)
        self.group.addButton(self.check3, 3)
        # 監(jiān)聽(tīng)切換事件
        self.group.buttonToggled.connect(self.on_check_toggled)
        layout.addWidget(self.check1)
        layout.addWidget(self.check2)
        layout.addWidget(self.check3)
        self.label = QLabel("已選：無(wú)")
        layout.addWidget(self.label)
    def on_check_toggled(self, btn, checked):
        selected = [btn.text() for btn in self.group.buttons() if btn.isChecked()]
        self.label.setText(f"已選：{', '.join(selected)}")

?五、注意事項(xiàng)

?互斥性與按鈕類型：
- QRadioButton 默認(rèn)互斥，但若未加入 QButtonGroup，同級(jí)按鈕可能無(wú)法正確互斥。
- QCheckBox 需手動(dòng)設(shè)置 setExclusive(False) 以允許多選。
?ID 管理：
- 若未顯式分配 ID，id(button) 返回自動(dòng)生成的唯一負(fù)數(shù) ID。
?內(nèi)存管理：
- QButtonGroup 不會(huì)自動(dòng)刪除子按鈕，需手動(dòng)管理或設(shè)置父對(duì)象。
?動(dòng)態(tài)按鈕操作：
- 動(dòng)態(tài)增刪按鈕時(shí)，需注意信號(hào)連接的更新。

?六、與布局的區(qū)別

?QButtonGroup	?布局類（如 QVBoxLayout）?
邏輯分組，處理按鈕狀態(tài)和信號(hào)	物理布局，控制界面位置和排列
不影響界面顯示	直接影響控件在窗口中的位置

通過(guò) QButtonGroup，可以輕松管理按鈕的選中邏輯和事件處理，特別適用于表單、設(shè)置選項(xiàng)等需要分組控制的場(chǎng)景！

到此這篇關(guān)于Python QButtonGroup類詳細(xì)介紹及常用方法的文章就介紹到這了,更多相關(guān)Python QButtonGroup類內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

亚洲乱码中文字幕综合,中国熟女仑乱hd,亚洲精品乱拍国产一区二区三区,一本大道卡一卡二卡三乱码全集资源,又粗又黄又硬又爽的免费视频

Python QButtonGroup類詳細(xì)介紹及常用方法

目錄

一、核心功能