QGroupBox Class

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

Header: #include <QGroupBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Inherits: 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も参照して ください。

プロパティ Documentation

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)

再リンプルメント: (QEvent *event):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)

再リンプルメント: (QMouseEvent *event):QWidget::mouseReleaseEvent(QMouseEvent *event).

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

再リンプルメント: (QMouseEvent *event):QWidget::paintEvent(QPaintEvent *event)。

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

再リンプルメント: (QPaintEvent *event):QWidget::resizeEvent(QResizeEvent *event)。

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

グループボックスがチェック可能な場合、このシグナルはチェックボックスがトグルされたときに発せられます。on 、チェックボックスがチェックされていればtrue、そうでなければfalseです。

注: プロパティchecked に対するノーティファイア・シグナル。

checkableも参照してください

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。