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) |
シグナル
保護された関数
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)
与えられた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 は真になり、チェック・ボックスがチェックされていない場合は偽になります。
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
このQGroupBox の値でoption を初期化する。このメソッドは、サブクラスがQStyleOptionGroupBox を必要とするが、すべての情報を自分で入力したくない場合に便利です。
QStyleOption::initFrom()も参照 。
[override virtual]
QSize QGroupBox::minimumSizeHint() const
[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.