快捷導(dǎo)航

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

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

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

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

一、核心功能

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

二、常用方法

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

方法	說明	示例
`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)

方法	說明	示例
`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 時返回 -1）	`id = group.checkedId()`

?3. ID 管理

方法	說明	示例
`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. 其他操作

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

?三、信號

信號	說明	使用場景
`buttonClicked(button: QAbstractButton)`	按鈕被點擊時觸發(fā)	通用點擊事件
`buttonClicked(int)`	傳遞按鈕 ID 的點擊信號	根據(jù) ID 處理邏輯
`buttonToggled(button: QAbstractButton, checked: bool)`	按鈕切換狀態(tài)時觸發(fā)	監(jiān)聽復(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("選項1")
        self.radio2 = QRadioButton("選項2")
        self.radio3 = QRadioButton("選項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)聽點擊事件（帶 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)前選中：無")
        layout.addWidget(self.label)
    def on_radio_clicked(self, btn_id):
        self.label.setText(f"當(dā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("蘋果")
        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)聽切換事件
        self.group.buttonToggled.connect(self.on_check_toggled)
        layout.addWidget(self.check1)
        layout.addWidget(self.check2)
        layout.addWidget(self.check3)
        self.label = QLabel("已選：無")
        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)}")

?五、注意事項

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

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

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

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

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

您可能感興趣的文章:

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

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

目錄

一、核心功能