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)

保護された関数

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 (通常はコンストラクタで設定します) とタイトルのアライメントも設定できます。グループボックスは、checkable 。チェック可能なグループ ボックスの子ウィジェットは、グループ ボックスがchecked であるかどうかに応じて有効または無効になります。

flat プロパティを有効にすると、グループ・ボックスのスペース消費を最小限に抑えることができます。ほとんどの場合styles 、このプロパティを有効にすると、フレームの左端、右端、下端が削除されます。

QGroupBox は、子ウィジェット(多くの場合、QCheckBoxes またはQRadioButtons ですが、どんなウィジェットでもかまいません)を自動的にレイアウトしません。次の例では、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 です。

アクセス関数:

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

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

checkable : bool

このプロパティは、グループボックスのタイトルにチェックボックスがあるかどうかを保持する。

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

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

このプロパティがグループ・ボックスに対して有効になっている場合、その内容が有効であることを保証するために、グループ・ボックスも最初にチェックされます。

アクセス関数:

bool isCheckable() const
void setCheckable(bool checkable)

checkedも参照してください

checked : bool

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

グループ・ボックスがチェック可能な場合、チェック・ボックスと共に表示される。チェックボックスがチェックされている場合、グループボックスの子は有効になり、そうでない場合、子は無効になり、ユーザはアクセスできなくなります。

デフォルトでは、チェック可能なグループボックスもチェックされている。

アクセス機能:

bool isChecked() const
void setChecked(bool checked)

通知シグナル:

void toggled(bool on)

checkableも参照のこと

flat : bool

このプロパティは、グループ・ボックスがフラットに描かれているか、フレームがあるかどうかを保持します。

グループボックスは通常、上部にタイトルを持つ周囲のフレームから構成される。このプロパティが有効な場合、ほとんどのスタイルで枠の上部のみが描画され、そうでない場合は枠全体が描画される。

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

注意:スタイルによっては、平らなグループボックスと平らでないグループボックスは似たような表現になり、他のスタイルでは区別がつかない場合があります。

アクセス関数:

bool isFlat() const
void setFlat(bool flat)

titleも参照してください

title : QString

このプロパティは、グループボックスのタイトルテキストを保持します。

グループ・ボックスのタイトル・テキストは、タイトルにアンパサンド('&')の後に文字が続く場合、キーボード・ショートカットを持ちます。

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

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

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

アクセス関数:

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

alignmentも参照してください

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

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

与えられたparent 、タイトルのないグループボックスウィジェットを構築します。

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

与えられたtitleparent でグループボックスを構築します。

[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 は真になり、チェック・ボックスがチェックされていない場合は偽になります。

checkabletoggled()、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

このQGroupBox の値でoption を初期化する。このメソッドは、サブクラスが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も参照してください

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