このページでは

QGroupBox Class

QGroupBox ウィジェットは、タイトル付きのグループボックスフレームを提供します。詳細...

ヘッダー: #include <QGroupBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
継承元: QWidget

プロパティ

パブリック関数

QGroupBox(QWidget *parent = nullptr)
QGroupBox(const QString &title, QWidget *parent = nullptr)
virtual ~QGroupBox()
Qt::Alignment alignment() const
bool isCheckable() const
bool isChecked() const
bool isFlat() const
void setAlignment(int alignment)
void setCheckable(bool checkable)
void setFlat(bool flat)
void setTitle(const QString &title)
QString title() const

再実装されたパブリック関数

virtual QSize minimumSizeHint() const override

パブリックスロット

void setChecked(bool checked)

シグナル

void clicked(bool checked = false)
void toggled(bool on)

protected関数

virtual void initStyleOption(QStyleOptionGroupBox *option) const

再実装されたプロテクト関数

virtual void changeEvent(QEvent *ev) override
virtual void childEvent(QChildEvent *c) override
virtual bool event(QEvent *e) override
virtual void focusInEvent(QFocusEvent *fe) override
virtual void mouseMoveEvent(QMouseEvent *event) override
virtual void mousePressEvent(QMouseEvent *event) override
virtual void mouseReleaseEvent(QMouseEvent *event) override
virtual void paintEvent(QPaintEvent *event) override
virtual void resizeEvent(QResizeEvent *e) override

詳細な説明

複数のラジオボタン項目を表示するグループボックス

グループボックスは、フレーム、上部のタイトル、キーボードショートカットを提供し、その内部にさまざまなウィジェットを表示します。キーボードショートカットは、グループボックスの子ウィジェットのいずれかにキーボードフォーカスを移動させます。

QGroupBox では、title (通常はコンストラクタで設定される)や、タイトルのalignment を設定することもできます。グループボックスはcheckable に設定可能です。チェック可能なグループボックス内の子ウィジェットは、グループボックスがchecked であるかどうかに応じて、有効または無効になります。

flat プロパティを有効にすることで、グループボックスの占有スペースを最小限に抑えることができます。ほとんどのstyles において、このプロパティを有効にすると、フレームの左、右、および下辺が削除されます。

QGroupBoxは、子ウィジェット(多くの場合、QCheckBoxやQRadioButtonですが、任意のウィジェットでも構いません)のレイアウトを自動的に行いません。以下の例は、レイアウトを設定したQGroupBoxの構築方法を示しています:

QGroupBox *groupBox = new QGroupBox(tr("Group Box with Layout"));

QRadioButton *radio1 = new QRadioButton(tr("&Radio button 1"));
QRadioButton *radio2 = new QRadioButton(tr("R&adio button 2"));
QRadioButton *radio3 = new QRadioButton(tr("Ra&dio button 3"));

radio1->setChecked(true);

QVBoxLayout *vbox = new QVBoxLayout;
vbox->addWidget(radio1);
vbox->addWidget(radio2);
vbox->addWidget(radio3);
vbox->addStretch(1);
groupBox->setLayout(vbox);

QButtonGroupも参照してください 。

プロパティのドキュメント

alignment : Qt::Alignment

このプロパティは、グループボックスのタイトルの配置を指定します。

ほとんどのスタイルでは、タイトルはフレームの上部に配置されます。タイトルの水平方向の配置は、以下のリストにある単一の値を使用して指定できます。

  • Qt::AlignLeft タイトルテキストをグループボックスの左端に揃えます。
  • Qt::AlignRight タイトルテキストをグループボックスの右端に揃えます。
  • Qt::AlignHCenter タイトルテキストをグループボックスの水平中央に揃えます。

デフォルトの配置はQt::AlignLeft です。

Accessの関数:

Qt::Alignment alignment() const
void setAlignment(int alignment)

「Qt::Alignment」も参照してください 。

checkable : bool

このプロパティは、グループボックスのタイトルにチェックボックスが含まれているかどうかを指定します

このプロパティがtrue に設定されている場合、グループボックスは通常のラベルの代わりにチェックボックスを使用してタイトルを表示します。チェックボックスがオンになっている場合、グループボックスの子要素は有効になります。そうでない場合は、無効になり、操作できません。

デフォルトでは、グループボックスはチェックできません。

グループボックスでこのプロパティが有効になっている場合、その内容が有効になるよう、初期状態でチェックボックスがオンになります。

Access 関数:

bool isCheckable() const
void setCheckable(bool checkable)

「checked」も参照してください 。

checked : bool

このプロパティは、グループボックスがチェックされているかどうかを表します

グループボックスがチェック可能な場合、チェックボックスと共に表示されます。チェックボックスがオンになっている場合、グループボックスの子要素は有効になります。そうでない場合、子要素は無効となり、ユーザーは操作できません。

デフォルトでは、チェック可能なグループボックスはチェックされた状態になっています。

注:グループボックスのチェックが 外れていても、グループボックス自体は 無効化されません。また、チェックが外れているグループボックス内の個々の子要素を明示的に有効にすることも可能です。ただし、エンドユーザーに予期せぬ操作体験を与える可能性があるため、この操作は推奨されません。

アクセス関数:

bool isChecked() const
void setChecked(bool checked)

Notifierシグナル:

void toggled(bool on)

関連項目: checkable 。

flat : bool

このプロパティは、グループボックスが枠なし表示か、枠付き表示かに関わらず有効です

グループボックスは通常、上部にタイトルがある枠で囲まれています。このプロパティが有効になっている場合、ほとんどのスタイルでは枠の上部のみが描画されます。無効になっている場合は、枠全体が描画されます。

デフォルトでは、このプロパティは無効になっており、明示的に指定しない限り、グループボックスはフラット表示されません。

注:一部のスタイルでは、フラットなグループボックスと非フラットなグループボックスの表示が似ており、他のスタイルほど区別がつきにくい場合があります。

Access 関数:

bool isFlat() const
void setFlat(bool flat)

関連項目: ` title`。

title : QString

このプロパティには、グループボックスのタイトルテキストが格納されます

グループボックスのタイトルテキストに、アンパサンド('&')とその後に続く文字が含まれている場合、そのテキストにはキーボードショートカットが割り当てられます。

g->setTitle("&User information");

上記の例では、Alt+U と入力すると、キーボードフォーカスがグループボックスに移動します。詳細については、QShortcut のドキュメントを参照してください(実際のアンパサンドを表示するには、「&&」を使用してください)。

デフォルトのタイトルテキストはありません。

Access 関数:

QString title() const
void setTitle(const QString &title)

「配置」も参照してください 。

メンバ関数のドキュメント

[explicit] QGroupBox::QGroupBox(QWidget *parent = nullptr)

指定されたparent を持つグループボックスウィジェットを作成しますが、タイトルは設定されません。

[explicit] QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)

指定されたtitle およびparent を使用して、グループボックスを作成します。

[virtual noexcept] QGroupBox::~QGroupBox()

グループボックスを破棄します。

[override virtual protected] void QGroupBox::changeEvent(QEvent *ev)

QWidget::changeEvent(QEvent *event) を再実装しています。

[override virtual protected] void QGroupBox::childEvent(QChildEvent *c)

QObject::childEvent(QChildEvent *event) を再実装します。

[signal] void QGroupBox::clicked(bool checked = false)

このシグナルは、チェックボックスがアクティブになったとき(つまり、マウスカーソルがボタン内にある状態でチェックボックスが押されてから離されたとき)、またはショートカットキーが入力されたときに発生します。なお、setChecked() を呼び出した場合は、このシグナルは発生しません。

チェックボックスがオンになっている場合、checked はtrueとなり、オフになっている場合はfalseとなります。

checkable 、toggled()、およびcheckedも参照してください 。

[override virtual protected] bool QGroupBox::event(QEvent *e)

QWidget::event(QEvent *event) を再実装します。

[override virtual protected] void QGroupBox::focusInEvent(QFocusEvent *fe)

QWidget::focusInEvent(QFocusEvent *event) を再実装します。

[virtual protected] void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const

option を、QGroupBox の値を用いて初期化します。このメソッドは、QStyleOptionGroupBox が必要であるものの、すべての情報を自分で入力したくないサブクラスにとって便利です。

QStyleOption::initFrom()も参照してください 。

[override virtual] QSize QGroupBox::minimumSizeHint() const

プロパティ「QWidget::minimumSizeHint 」のアクセス関数を再実装します。

[override virtual protected] void QGroupBox::mouseMoveEvent(QMouseEvent *event)

QWidget::mouseMoveEvent(QMouseEvent *event) を再実装します。

[override virtual protected] void QGroupBox::mousePressEvent(QMouseEvent *event)

QWidget::mousePressEvent(QMouseEvent *event) を再実装します。

[override virtual protected] void QGroupBox::mouseReleaseEvent(QMouseEvent *event)

QWidget::mouseReleaseEvent(QMouseEvent *event) を再実装しています。

[override virtual protected] void QGroupBox::paintEvent(QPaintEvent *event)

QWidget::paintEvent(QPaintEvent *event) を再実装しています。

[override virtual protected] void QGroupBox::resizeEvent(QResizeEvent *e)

QWidget::resizeEvent(QResizeEvent *event) を再実装します。

[signal] void QGroupBox::toggled(bool on)

グループボックスがチェック可能な場合、このシグナルはチェックボックスがトグルされたときに発火します。on は、チェックボックスがオンになっている場合は true、そうでない場合は false になります。

注: プロパティ `checked`の通知 シグナルです。

「checkable」も参照してください 。

© 2026 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.