QGroupBox类

QGroupBox小部件提供带标题的分组框框架。更多...

头文件 #include <QGroupBox>
CMakefind_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmakeQT += widgets
继承 QWidget

属性

公有函数

QGroupBox(QWidget *parent = nullptr)
QGroupBox(const QString &title, QWidget *parent = nullptr)
虚拟~QGroupBox()
Qt::Alignmentalignment() const
boolisCheckable() const
boolisChecked() const
boolisFlat() const
voidsetAlignment(int alignment)
voidsetCheckable(bool checkable)
voidsetFlat(bool flat)
voidsetTitle(const QString &title)
QStringtitle() const

重写的公有函数

虚拟minimumSizeHint() const override

公有槽

voidsetChecked(bool checked)

信号

voidclicked(bool checked = false)
voidtoggled(bool on)

保护函数

虚拟initStyleOption(QStyleOptionGroupBox *option) const

重写的保护函数

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

详细描述

分组框提供了边框、顶部标题、快捷键,并在其内部显示各种其他小部件。快捷键可以将键盘焦点移动到分组框的子小部件之一。

QGroupBox 还允许您设置 标题(通常在构造函数中设置)和标题的对齐方式。分组框可以是可 选择的。可选择的分组框中的子小部件将根据分组框是否 选中 来启用或禁用。

您可以通过启用 flat 属性来最小化分组框的空间消耗。在大多数 风格 中,启用此属性会导致边框的左、右和底部边框被移除。

QGroupBox 不自动布局子小部件(这些小部件通常是 QCheckBoxQRadioButton,但可以是任何小部件)。以下示例显示了如何使用布局设置 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::Alignmentalignment() const
voidsetAlignment(int alignment)

另请参阅Qt::Alignment

checkable : bool

该属性包含分组框是否有在标题中的复选框。

如果此属性为 true,则分组框使用复选框替换普通标签来显示其标题。如果复选框被选中,则分组框的子项将被启用;否则,它们将被禁用且不可访问。

默认情况下,分组框是不可选择的。

如果为此分组框启用了此属性,它将默认选中以确保其内容被启用。

访问函数

boolisCheckable() const
voidsetCheckable(bool checkable)

另请参阅checked

checked : bool

该属性包含分组框是否选中。

如果分组框是可选择的,则它将以复选框的形式显示。如果复选框被选中,则分组框的子项将被启用;否则,子项将被禁用且用户无法访问。

默认情况下,可选择的分组框也是选中的。

访问函数

boolisChecked() const
voidsetChecked(bool checked)

通知信号

voidtoggled(bool on)

另请参阅 可勾选.

flat : bool

此属性表示组框是绘制为平面还是带有边框

组框通常由一个带有顶部的标题的外边框组成。如果启用了此属性,则大多数样式中只绘制边框的顶部部分;否则,将绘制整个边框。

默认情况下,此属性是禁用的,即除非明确指定,否则组框不是平面的。

注意:在某些样式中,平面和非平面组框的表现可能相似,可能不如其他样式中的可区分性高。

访问函数

boolisFlat() const
voidsetFlat(bool flat)

另请参阅 标题.

title : QString

此属性包含组框标题文本

如果标题包含一个字母后跟字母的省略号('&'),则组框标题文本将有键盘快捷方式。

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

在上面的示例中,Alt+U 将键盘焦点移动到组框。有关详细信息,请参阅QShortcut文档(要显示实际的省略号,请输入'&&')。

没有默认的标题文本。

访问函数

QStringtitle() const
voidsetTitle(const QString &title)

另请参阅 对齐.

成员函数文档

[显式] QGroupBox::QGroupBox(QWidget *parent = nullptr)

使用给定的 parent 构造一个没有标题的组框小部件。

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

使用给定的 titleparent 构造一个组框。

[虚拟 noexcept] QGroupBox::~QGroupBox()

销毁组框。

[覆盖虚拟受保护的] void QGroupBox::changeEvent(QEvent *ev)

重新实现了: QWidget::changeEvent(QEvent *event).

[覆盖虚拟受保护的] void QGroupBox::childEvent(QChildEvent *c)

重新实现了:QObject::childEvent(QChildEvent *event).

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

当复选框被激活(即,当鼠标光标在按钮内按下并释放时),或当按下快捷键时,会发出此信号。值得注意的是,如果您调用 setChecked(),则不会发出此信号。

如果复选框被勾选,则 checked 为 true;如果复选框未勾选,则为 false。

另请参阅 可勾选toggled() 和 checked.

[重写虚保护] bool QGroupBox::event(QEvent *e)

重实现: QWidget::event(QEvent *event).

[重写虚保护] void QGroupBox::focusInEvent(QFocusEvent *fe)

重实现: QWidget::focusInEvent(QFocusEvent *event).

[虚拟保护] void QGroupBox::initStyleOption(QStyleOptionGroupBox *option) const

使用此 QGroupBox 的值初始化 option。此方法对子类很有用,当它们需要 QStyleOptionGroupBox,但又不想自己填写所有信息时。

另请参阅 QStyleOption::initFrom.

[重写虚] QSize QGroupBox::minimumSizeHint() const

重实现了属性: QWidget::minimumSizeHint.

[重写虚保护] void QGroupBox::mouseMoveEvent(QMouseEvent *event)

重实现: QWidget::mouseMoveEvent(QMouseEvent *event).

[重写虚保护] void QGroupBox::mousePressEvent(QMouseEvent *event)

重实现: QWidget::mousePressEvent(QMouseEvent *event).

[重写虚保护] void QGroupBox::mouseReleaseEvent(QMouseEvent *event)

重实现: QWidget::mouseReleaseEvent(QMouseEvent *event).

[重写虚保护] void QGroupBox::paintEvent(QPaintEvent *event)

重实现: QWidget::paintEvent(QPaintEvent *event).

[重写虚保护] void QGroupBox::resizeEvent(QResizeEvent *e)

重实现: QWidget::resizeEvent(QResizeEvent *event).

[信号] void QGroupBox::toggled(bool on)

如果组框是可勾选的,当复选框切换时发出此信号。如果复选框处于勾选状态,则 on 为 true,否则为 false。

注意:属性 checked 的通知信号。

另请参阅 可勾选.

© 2024 Qt公司有限公司。本文档中包含的贡献都是其各自所有者的版权。提供的文档是根据自由软件基金会发布的、在 GNU自由文档许可协议版本1.3 的条款进行许可的。Qt及其相应标志是芬兰以及全球其他国家的Qt公司有限公司的商标。所有其他商标均为其各自所有者的财产。