QStyleOptionGroupBox Class
QStyleOptionGroupBox 类描述了绘制组框的参数。更多内容...
| 头文件： | #include <QStyleOptionGroupBox> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 继承自： | QStyleOptionComplex |
公共类型
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
公共函数
| QStyleOptionGroupBox() | |
| QStyleOptionGroupBox(const QStyleOptionGroupBox &other) | |
| QStyleOptionGroupBox & | operator=(const QStyleOptionGroupBox &) |
公共变量
| QStyleOptionFrame::FrameFeatures | features |
| int | lineWidth |
| int | midLineWidth |
| QString | text |
| Qt::Alignment | textAlignment |
| QColor | textColor |
详细描述
QStyleOptionButton 包含QStyle 函数所需的所有信息，用于处理组框的各种图形元素。
它包含用于绘制面板的lineWidth 和midLineWidth 、组框的title 以及标题的alignment 和color 。
出于性能考虑，这些结构体包含的成员函数较少，且可直接访问成员变量（即使用. 或-> 运算符）。这使得这些结构体易于使用，同时也突显了它们仅仅是样式函数所使用的参数这一特点。
另请参阅 QStyleOption 、QStyleOptionComplex 以及QGroupBox 。
成员类型文档
enum QStyleOptionGroupBox::StyleOptionType
该枚举用于存储样式选项类型的相关信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值简体中文（大陆） | 描述 |
|---|---|---|
QStyleOptionGroupBox::Type | SO_GroupBox | 提供的样式选项的类型（对于此类而言为SO_GroupBox ）。 |
该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，以确定样式选项的类型。通常情况下，除非您想创建自己的QStyleOption 子类和自己的样式，否则无需担心这一点。
另请参阅 StyleOptionVersion 。
enum QStyleOptionGroupBox::StyleOptionVersion
该枚举用于存储样式选项的版本信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionGroupBox::Version | 1 | 1 |
QStyleOption 的子类使用该版本号来实现扩展，同时保持兼容性。如果您使用qstyleoption_cast()，通常无需检查该版本号。
另请参阅 StyleOptionType 。
成员函数文档
QStyleOptionGroupBox::QStyleOptionGroupBox()
创建一个 QStyleOptionGroupBox，并将成员变量初始化为默认值。
QStyleOptionGroupBox::QStyleOptionGroupBox(const QStyleOptionGroupBox &other)
创建other 样式选项的副本。
[noexcept default] QStyleOptionGroupBox &QStyleOptionGroupBox::operator=(const QStyleOptionGroupBox &)
将other 复制并赋值给此QStyleOptionGroupBox 实例。
成员变量文档
QStyleOptionFrame::FrameFeatures QStyleOptionGroupBox::features
该变量存储了组框边框的特征
默认情况下，边框为平边框。
另请参阅 QStyleOptionFrame::FrameFeature 。
int QStyleOptionGroupBox::lineWidth
该变量存储绘制面板时的线宽
目前，该变量的值始终为 1。
另请参阅 QFrame::lineWidth 。
int QStyleOptionGroupBox::midLineWidth
该变量存储用于绘制面板的中线宽度
绘制下沉或凸起的组框边框时，通常会使用中线宽度。目前，该变量的值始终为 0。
另请参阅 QFrame::midLineWidth 。
QString QStyleOptionGroupBox::text
该变量存储组框的文本
默认值为空字符串。
另请参阅 QGroupBox::title 。
Qt::Alignment QStyleOptionGroupBox::textAlignment
该变量存储组框标题的对齐方式
默认值为Qt::AlignLeft 。
另请参阅 QGroupBox::alignment 。
QColor QStyleOptionGroupBox::textColor
该变量存储组框标题的颜色
其默认值是一个 RGB 值为 (0, 0, 0) 的无效颜色。无效颜色是指未针对底层窗口系统正确设置的颜色。
© 2026 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.
