Qt5學習筆記——QRadioButton與QbuttonGroup

【我是小標題：使用QToolButton實現radio button功能。】

QRadioButton是什么？ 
　　下圖是Windows系統中典型的radio button顯示效果。 
　　 
　　QRadioButton是一個可以switch on或off的按鈕，對應的狀態為checked和unchecked。一組QRadioButton通常用於表示程序中“多選一”的選擇，例如單項選擇題。在一組radio buttons中，同一時刻只能有一個button處於checked狀態，如果用戶選擇了其他button，原先被選中的button將變為unchecked。 
　　和QpushButton一樣，QRadioButton類提供了一個text label和一個small icon，其中text可以在構造函數中設置，也可以通過setText()方法設置，但是icon只能通過setIcon()方法設置，還可以通過在text中某個字母前加“&”符號來指定快捷鍵，例如：

QRadioButton *button = new QRadioButton("Search from the &cursor", this);

上面例子的快捷鍵為“Alt + c”。

分組 
　　上面其實已經提到過，“同一個父窗體”或“一個button group”，這就是分組。如果沒有進行分組，則默認擁有相同父窗體的radio buttons都將具有相互排他性，所以如果你想在一個窗體中表達多組radio buttons的效果，需要顯式地對它們進行分組，可以使用QGroupBox或者QButtonGroup。建議使用QButtonGroup，因為它僅僅是一個容器，不會有任何視覺表現，並且對於包含在它里面的子buttons，QButtonGroup提供比QGroupBox方便的信號槽操作。

信號 
　　QRadioButton的信號繼承自QAbstractButton，一般我們比較關注的是toggled()和clicked()， 
　　需要注意的是，radio button無論是被switch on還是off，它都會發送一個toggled(bool)信號，其中包含一個bool型參數用於記錄此次發生的是被switch on還是off，所以如果你想根據radio button的狀態變化來處理一些事的話，就需要connect它們。 
　　當然，如果組內有很多個radio buttons，並且你又想跟蹤toggled或clicked的狀態，你不需要一個個來connect，因為一旦使用QButtonGroup來管理，完全可以用buttonToggled()和buttonClicked()來處理組內所有buttons的toggled()和clicked()信號。

方法 
　　在QButtonGroup中添加一個button可以使用addButton()方法，刪除一個button可以使用removeButton()方法。如果這個button group是exclusive的，還可以通過checkedButton()方法來找到當前處於checked狀態的button。可以通過button()方法找到該button group中的某一個button，以及通過buttons()方法獲得該button group中的buttons列表。

屬性 
　　接下來，我們需要關注一個名為autoExclusive的bool型屬性，它是QAbstractButton類的屬性，該屬性用於控制一個button是否具有排他性（auto-exclusivity），可以通過autoExclusive() 方法進行查詢，通過setAutoExclusive(bool)方法進行設置。 
　　如果autoExclusive為true，屬於同一個父窗體的所有checkable按鈕的行為將表現得與它們被放在一個exclusive的button group中一樣，任何時刻都只能有一個按鈕處於checked狀態。不過別擔心， autoExclusive屬性的缺省值為false（除了QRadioButton）。 
　　還要注意的是，如果buttons已經放在了一個button group，那么autoExclusive屬性將失效。 
　　QButtonGroup默認是exclusive的，所以只要它的組內的所有buttons是checkable的，不管是不是QRadioButton，都將表現得與QRadioButton一樣。最后如果你創建了一個exclusive的button group，最好為它設置一個初選項，否則組內將沒有任何一個button被選中，這不太符合“one of many”的設計吧。

示例 
　　以下示例代碼，包括普通QRadioButton的用法以及用QToolButton模擬的單選按鈕組，相關代碼解釋請看注釋。（因為QRadioButton只提供了一個small icon，但是我們希望可以更加個性化，所以嘗試用QToolButton來實現） 
　　 
【mainwidget.h】文件

#ifndef MAINWIDGET_H
#define MAINWIDGET_H

#include <QWidget>
#include <QRadioButton>
#include <QButtonGroup>
#include <QToolButton>
#include <QLabel>

class MainWidget : public QWidget {
    Q_OBJECT

public:
    MainWidget(QWidget *parent = 0);
    ~MainWidget();

    // 設備操作模式類型（用於表示普通QButtonGroup）
    typedef enum {
        OM_Auto,
        OM_Manual,
        OM_ManualFullSpeed
    }operatingModeTypes;

    // 動物選項類型（用於表示QToolButton模擬的單選按鈕）
    typedef enum {
        AN_PIG,
        AN_MONKEY,
        AN_CAT
    }animalTypes;

private slots:
    void operatingModeButtonsToggled(int, bool);
    void operatingModeButtonsClicked(int);

    void customButtonsToggled(int, bool);
    void customButtonsClicked(int);

private:
    // 設備操作模式組
    QButtonGroup *operatingModeGroup;
    QRadioButton *autoBtn;
    QRadioButton *manualBtn;
    QRadioButton *manualFullSpeedBtn;

    // 電源開關組
    QButtonGroup *powerGroup;
    QRadioButton *powerOnBtn;
    QRadioButton *powerOffBtn;

    // 動物選項組
    QButtonGroup *customGroup;
    QStringList animalStrList;  // 記錄動物名稱
    QLabel *curAnimalLabel;     // 顯式當前選中的動物名稱
};

#endif // MAINWIDGET_H

 

【mainwidget.cpp】文件

#include "mainwidget.h"
#include <QVBoxLayout>
#include <QHBoxLayout>

// 保存customGroup中checked和unchecked按鈕的樣式
QString toolBtnCheckedStyleSheet("border-style: solid; ");
QString toolBtnUncheckedStyleSheet("border-style: solid; ");

MainWidget::MainWidget(QWidget *parent)
    : QWidget(parent)
{
    setWindowTitle(tr("QRadioButtonTest"));
    setFixedSize(400, 300);

    /* ******* 普通RadioButton ******* */
    autoBtn = new QRadioButton(tr("Auto"));
    manualBtn = new QRadioButton(tr("Manual"));
    manualFullSpeedBtn = new QRadioButton(tr("Manual Full Speed"));

    operatingModeGroup = new QButtonGroup(this);
    operatingModeGroup->addButton(autoBtn, OM_Auto);
    operatingModeGroup->addButton(manualBtn, OM_Manual);
    operatingModeGroup->addButton(manualFullSpeedBtn, OM_ManualFullSpeed);
    autoBtn->setChecked(true);  // 為operatingModeGroup組設置初選項

    /* ******* 添加Icon的RadioButton ******* */
    powerOnBtn = new QRadioButton(tr("Power ON"));
    powerOnBtn->setIcon(QIcon(":/images/power_on.png"));
    powerOffBtn = new QRadioButton(tr("Power OFF"));
    powerOffBtn->setIcon(QIcon(":/images/power_off.png"));

    powerGroup = new QButtonGroup(this);
    powerGroup->addButton(powerOnBtn);
    powerGroup->addButton(powerOffBtn);
    powerOffBtn->setChecked(true);  // 為powerGroup組設置初選項

    /* ******* 自定義RadioButton ******* */
    QSize size(100, 100);
    animalStrList<<"pig"<<"monkey"<<"cat";

    customGroup = new QButtonGroup(this);
    customGroup->setExclusive(true);
    curAnimalLabel = new QLabel;
    QHBoxLayout *customBtnBarLayout = new QHBoxLayout;

    for(int i=0; i<3; i++)
    {
        QToolButton *customBtn = new QToolButton;
        customGroup->addButton(customBtn, AN_PIG+i);    // 將自定義的button加入customGroup中，並為其設置id

        customBtn->setToolButtonStyle(Qt::ToolButtonTextUnderIcon); //文字處於圖片下方
        QPixmap pixmap(QString(":/images/%1.jpg").arg(animalStrList.at(i)));
        customBtn->setIcon(pixmap);   // 為按鈕設置圖標
        customBtn->setIconSize(size);   // 設置圖片大小
        customBtn->setFixedSize(size.width()+30, size.height()+30); // 設置按鈕大小
        customBtn->setText(animalStrList.at(i)); // 設置提示文字
        customBtn->setCheckable(true);
        customBtn->setChecked(false);
        customBtn->setStyleSheet(toolBtnUncheckedStyleSheet); // 所有按鈕初始狀態為unchecked

        customBtnBarLayout->addWidget(customBtn);   // 添加到布局
    }
    customGroup->button(AN_PIG)->setChecked(true);  // 為customGroup組設置初選項
    customGroup->button(AN_PIG)->setStyleSheet(toolBtnCheckedStyleSheet);   // 修改被checked按鈕的樣式
    curAnimalLabel->setText(QString(tr("當前選擇："))+animalStrList.at(customGroup->checkedId()));

    // 創建布局
    QVBoxLayout *mainLayout = new QVBoxLayout;
    mainLayout->addWidget(autoBtn);
    mainLayout->addWidget(manualBtn);
    mainLayout->addWidget(manualFullSpeedBtn);
    mainLayout->addStretch();
    mainLayout->addWidget(powerOnBtn);
    mainLayout->addWidget(powerOffBtn);
    mainLayout->addStretch();
    mainLayout->addWidget(curAnimalLabel);
    mainLayout->addLayout(customBtnBarLayout);
    setLayout(mainLayout);

    // 連接信號
    connect(operatingModeGroup, SIGNAL(buttonToggled(int,bool)), this, SLOT(operatingModeButtonsToggled(int,bool)));
    connect(operatingModeGroup, SIGNAL(buttonClicked(int)), this, SLOT(operatingModeButtonsClicked(int)));
    connect(customGroup, SIGNAL(buttonClicked(int)), this, SLOT(customButtonsClicked(int)));
    connect(customGroup, SIGNAL(buttonToggled(int,bool)), this, SLOT(customButtonsToggled(int,bool)));
}

MainWidget::~MainWidget()
{

}

void MainWidget::operatingModeButtonsToggled(int id, bool status)
{
    int tmp = operatingModeGroup->checkedId();
    QString str = operatingModeGroup->checkedButton()->text();
    QByteArray byteArray = str.toLocal8Bit();
    qDebug("flag = %d, status = %d, tmp = %d, checked = %s", id, status, tmp, byteArray.data());
}

void MainWidget::operatingModeButtonsClicked(int id)
{
    qDebug("Clicked: %d", id);
}

void MainWidget::customButtonsToggled(int id, bool state)
{
    if(state == false)
    {   // 修改被unchecked按鈕的樣式
        customGroup->button(id)->setStyleSheet(toolBtnUncheckedStyleSheet);
    }else
    {   // 修改被checked按鈕的樣式
        customGroup->checkedButton()->setStyleSheet(toolBtnCheckedStyleSheet);
    }
}

void MainWidget::customButtonsClicked(int id)
{
    curAnimalLabel->setText(QString(tr("當前選擇："))+animalStrList.at(id));
}

 

示例圖片 

 

原文鏈接: http://www.voidcn.com/article/p-uakncscd-bkp.html