QButtonGroup Class
QButtonGroupクラスは、ボタンウィジェットのグループをまとめるコンテナを提供します。詳細...
| ヘッダー | #include <QButtonGroup> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 継承： | QObject |
プロパティ
- exclusive : bool
パブリック機能
| QButtonGroup(QObject *parent = nullptr) | |
| virtual | ~QButtonGroup() |
| void | addButton(QAbstractButton *button, int id = -1) |
| QAbstractButton * | button(int id) const |
| QList<QAbstractButton *> | buttons() const |
| QAbstractButton * | checkedButton() const |
| int | checkedId() const |
| bool | exclusive() const |
| int | id(QAbstractButton *button) const |
| void | removeButton(QAbstractButton *button) |
| void | setExclusive(bool) |
| void | setId(QAbstractButton *button, int id) |
シグナル
| void | buttonClicked(QAbstractButton *button) |
| void | buttonPressed(QAbstractButton *button) |
| void | buttonReleased(QAbstractButton *button) |
| void | buttonToggled(QAbstractButton *button, bool checked) |
| void | idClicked(int id) |
| void | idPressed(int id) |
| void | idReleased(int id) |
| void | idToggled(int id, bool checked) |
詳細説明
QButtonGroupは、ボタンウィジェットを配置できる抽象コンテナを提供します。このコンテナの視覚的な表現は提供せず（コンテナウィジェットについてはQGroupBox を参照）、代わりにグループ内の各ボタンの状態を管理します。
exclusive ボタングループは、クリックされたボタン以外のすべてのチェック可能な（トグル）ボタンをオフにします。デフォルトでは、ボタングループは排他的です。ボタングループ内のボタンは通常、チェック可能なQPushButtons、QCheckBoxes（通常、排他的でないボタングループの場合）、QRadioButtons のいずれかです。排他的ボタングループを作成する場合、グループ内のボタンのいずれかが最初にチェックされるようにする必要があります。そうでない場合、グループは最初、どのボタンもチェックされていない状態になります。
ボタンは、addButton （）でグループに追加でき、removeButton （）で削除できる。グループが排他的な場合、現在チェックされているボタンはcheckedButton() で利用できる。ボタンがクリックされると、buttonClicked() シグナルが発せられます。排他的グループ内のチェック可能なボタンの場合、これはボタンがチェックされたことを意味します。グループ内のボタンのリストはbuttons() で返されます。
さらに、QButtonGroupは整数とボタンを対応付けることができます。setId （）でボタンに整数idを割り当て、id （）でそれを取り出すことができる。現在チェックされているボタンのidはcheckedId （）で取得でき、ボタンのidを発するシグナルidClicked （）があります。id-1 はQButtonGroupによって予約されており、「そのようなボタンはない」という意味である。マッピング・メカニズムの目的は、ユーザー・インターフェースにおける列挙値の表現を単純化することです。
QGroupBox,QPushButton,QCheckBox,QRadioButtonも参照のこと 。
プロパティ・ドキュメンテーション
exclusive : bool
このプロパティは、ボタングループが排他的であるかどうかを保持する。
このプロパティがtrue の場合、グループ内のボタンは常に1つしかチェックできません。ユーザは任意のボタンをクリックしてチェックすることができ、そのボタンはグループ内のチェックされたボタンとして既存のボタンに取って代わります。
排他的グループでは、ユーザーは現在チェックされているボタンをクリックしてもチェックを外すことはできません。代わりに、グループ内の別のボタンをクリックして、そのグループの新しいチェック済みボタンを設定する必要があります。
デフォルトでは、このプロパティはtrue です。
アクセス関数：
| bool | exclusive() const |
| void | setExclusive(bool) |
メンバ関数ドキュメント
[explicit] QButtonGroup::QButtonGroup(QObject *parent = nullptr)
与えられたparent で、新しい空のボタングループを構築します。
addButton() およびsetExclusive()も参照 。
[virtual noexcept] QButtonGroup::~QButtonGroup()
ボタングループを破棄する。
void QButtonGroup::addButton(QAbstractButton *button, int id = -1)
指定されたbutton をボタングループに追加します。id が -1 の場合、ボタンに id が割り当てられます。自動的に割り当てられるidは、-2から始まる負の値であることが保証されています。独自のidを割り当てる場合は、競合を避けるために正の値を使用してください。
removeButton() およびbuttons()も参照してください 。
QAbstractButton *QButtonGroup::button(int id) const
指定されたid を持つボタン、またはそのようなボタンが存在しない場合はnullptr を返します。
[signal] void QButtonGroup::buttonClicked(QAbstractButton *button)
このシグナルは、与えられたbutton がクリックされたときに発せられる。ボタンがクリックされるのは、そのボタンが最初に押された後に離されたとき、そのボタンのショートカット・キーが入力されたとき、またはQAbstractButton::click() やQAbstractButton::animateClick() がプログラムで呼び出されたときです。
checkedButton() およびQAbstractButton::clicked()も参照して ください。
[signal] void QButtonGroup::buttonPressed(QAbstractButton *button)
このシグナルは、与えられたbutton が押されたときに発せられる。
QAbstractButton::pressed()も参照 。
[signal] void QButtonGroup::buttonReleased(QAbstractButton *button)
このシグナルは、与えられたbutton が解放されたときに発せられる。
QAbstractButton::released()も参照 。
[signal] void QButtonGroup::buttonToggled(QAbstractButton *button, bool checked)
このシグナルは、与えられたbutton がトグルされたときに発せられる。ボタンがチェックされていればchecked は真、チェックされていなければ偽となる。
QAbstractButton::toggled()も参照してください 。
QList<QAbstractButton *> QButtonGroup::buttons() const
ボタングループのボタンリストを返します。これは空でもかまいません。
addButton() およびremoveButton()も参照して ください。
QAbstractButton *QButtonGroup::checkedButton() const
ボタングループのチェックされたボタン、またはチェックされたボタンがない場合はnullptr を返します。
buttonClicked()も参照してください 。
int QButtonGroup::checkedId() const
checkedButton() の id、またはボタンがチェックされていない場合は -1 を返す。
setId()も参照してください 。
int QButtonGroup::id(QAbstractButton *button) const
指定されたbutton の id を返し、そのようなボタンが存在しない場合は -1 を返します。
setId()も参照してください 。
[signal] void QButtonGroup::idClicked(int id)
このシグナルは、与えられたid を持つボタンがクリックされたときに発せられる。
checkedButton() およびQAbstractButton::clicked()も参照してください 。
[signal] void QButtonGroup::idPressed(int id)
このシグナルは、指定されたid のボタンが押下されたときに発せられる。
QAbstractButton::pressed()も参照 。
[signal] void QButtonGroup::idReleased(int id)
このシグナルは、与えられたid のボタンが離されたときに発せられる。
QAbstractButton::released()も参照 。
[signal] void QButtonGroup::idToggled(int id, bool checked)
このシグナルは、与えられたid を持つボタンがトグルされたときに発せられる。ボタンがチェックされていればchecked は真、チェックされていなければ偽となる。
QAbstractButton::toggled()も参照してください 。
void QButtonGroup::removeButton(QAbstractButton *button)
指定されたbutton をボタングループから削除します。
addButton() およびbuttons()も参照してください 。
void QButtonGroup::setId(QAbstractButton *button, int id)
指定されたbutton に対してid を設定する。id には -1 を指定できないことに注意。
id()も参照のこと 。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
