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) |
シグナル
保護された関数
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)
与えられた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)
再リンプルメント: (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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。