Qt Widgets サンプルコード集：ボタン、入力、レイアウト、ダイアログ、その他

QButtonGroup::checkedButton() の詳細解説

QButtonGroup::checkedButton() メソッドは、Qt Widgets モジュールにおける QButtonGroup クラスの重要な機能の一つです。このメソッドは、ボタングループ内に存在するチェックされているボタンを取得することを可能にします。ボタングループは、互いに排他的な動作をする複数のボタンを管理する機能を提供します。

使用方法

checkedButton() メソッドは、以下の構文で呼び出すことができます。

QAbstractButton* checkedButton() const;

このメソッドは、チェックされているボタンを QAbstractButton 型のポインタとして返します。チェックされていないボタンが存在する場合、またはボタングループ内にボタンが存在しない場合は、nullptr が返されます。

例

以下のコードは、QButtonGroup に 3 つのボタンを追加し、checkedButton() メソッドを使用して、チェックされているボタンを取得する例です。

QButtonGroup buttonGroup;

// ボタンを作成してボタングループに追加する
QRadioButton* radioButton1 = new QRadioButton("Option 1");
QRadioButton* radioButton2 = new QRadioButton("Option 2");
QRadioButton* radioButton3 = new QRadioButton("Option 3");

buttonGroup.addButton(radioButton1);
buttonGroup.addButton(radioButton2);
buttonGroup.addButton(radioButton3);

// ボタンのいずれかをチェックする
radioButton2->setChecked(true);

// チェックされているボタンを取得する
QAbstractButton* checkedButton = buttonGroup.checkedButton();

if (checkedButton) {
    qDebug() << "Checked button: " << checkedButton->text();
} else {
    qDebug() << "No button is checked";
}

このコードを実行すると、以下の出力がコンソールに表示されます。

Checked button: Option 2

注意点

• checkedButton() メソッドは、チェックされているボタンのみを取得します。チェックされていないボタンを取得するには、buttons() メソッドと組み合わせる必要があります。
• checkedButton() メソッドは、ボタングループ内に存在するボタンのみを取得します。ボタングループに属していないボタンをチェックしても、このメソッドで取得することはできません。

QButtonGroup::checkedButton() メソッドは、ボタングループ内のチェックされているボタンを取得する際に役立ちます。このメソッドを活用することで、ボタングループの動作をより柔軟に制御することができます。

• この説明が分かりやすく、役に立てば幸いです。

• 上記以外にも、様々な種類のサンプルコードが公開されています。
• 探したいサンプルコードが見つからない場合は、Google 検索で「Qt Widgets」とキーワードを入力して検索してみてください。

1. Using the buttons() method:

   The buttons() method returns a list of all the buttons in the QButtonGroup. You can then iterate over the list to find the checked button.

   QList<QAbstractButton*> buttons = buttonGroup.buttons();
   
   for (QAbstractButton* button : buttons) {
       if (button->isChecked()) {
           checkedButton = button;
           break;
       }
   }
   

2. Using the id() method:

   Each button in a QButtonGroup has a unique ID. You can use the id() method to get the ID of the checked button, and then use the button() method to get the button itself.

   int checkedId = buttonGroup.checkedId();
   
   if (checkedId != -1) {
       checkedButton = buttonGroup.button(checkedId);
   }
   

3. Connecting to the buttonClicked() signal:

   The buttonClicked() signal is emitted whenever a button in the QButtonGroup is clicked. You can connect to this signal and use the sender() method to get the checked button.

   connect(buttonGroup, &QButtonGroup::buttonClicked, this, &MyClass::onButtonClicked);
   
   void MyClass::onButtonClicked(int id) {
       checkedButton = buttonGroup.button(id);
   }
   

Which method you use depends on your specific needs. If you only need to get the checked button once, then the checkedButton() method is the simplest way to do it. If you need to get the checked button more than once, or if you need to know which button was clicked, then the other methods are better choices.

Here is a table that summarizes the pros and cons of each method:

I hope this helps! Let me know if you have any other questions.