QButtonGroup Class
QButtonGroupクラスは、ボタンウィジェットのグループをまとめるコンテナを提供します。詳細...
| Header: | #include <QButtonGroup> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Inherits: | 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も参照のこと 。
プロパティ Documentation
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()も参照して ください。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。
