QGroupBox类
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) | |
虚拟 | ~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 |
重写的公有函数
虚拟 | minimumSizeHint() const override |
公有槽
void | setChecked(bool checked) |
信号
保护函数
虚拟 | 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 不自动布局子小部件(这些小部件通常是 QCheckBox 或 QRadioButton,但可以是任何小部件)。以下示例显示了如何使用布局设置 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) |
另请参阅 可勾选.
flat : bool
此属性表示组框是绘制为平面还是带有边框
组框通常由一个带有顶部的标题的外边框组成。如果启用了此属性,则大多数样式中只绘制边框的顶部部分;否则,将绘制整个边框。
默认情况下,此属性是禁用的,即除非明确指定,否则组框不是平面的。
注意:在某些样式中,平面和非平面组框的表现可能相似,可能不如其他样式中的可区分性高。
访问函数
bool | isFlat() const |
void | setFlat(bool flat) |
另请参阅 标题.
title : QString
此属性包含组框标题文本
如果标题包含一个字母后跟字母的省略号('&'),则组框标题文本将有键盘快捷方式。
g->setTitle("&User information");
在上面的示例中,Alt+U 将键盘焦点移动到组框。有关详细信息,请参阅QShortcut文档(要显示实际的省略号,请输入'&&')。
没有默认的标题文本。
访问函数
QString | title() const |
void | setTitle(const QString &title) |
另请参阅 对齐.
成员函数文档
[显式]
QGroupBox::QGroupBox(QWidget *parent = nullptr)
使用给定的 parent 构造一个没有标题的组框小部件。
[显式]
QGroupBox::QGroupBox(const QString &title, QWidget *parent = nullptr)
使用给定的 title 和 parent 构造一个组框。
[虚拟 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。
[重写虚保护]
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公司有限公司的商标。所有其他商标均为其各自所有者的财产。