本页内容

QStyleOptionFrame Class

QStyleOptionFrame 类用于描述绘制边框的参数。更多内容...

头文件: #include <QStyleOptionFrame>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
继承自: QStyleOption

公共类型

enum FrameFeature { None, Flat, Rounded }
flags FrameFeatures
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

公共函数

QStyleOptionFrame()
QStyleOptionFrame(const QStyleOptionFrame &other)
QStyleOptionFrame &operator=(const QStyleOptionFrame &)

公共变量

QStyleOptionFrame::FrameFeatures features
QFrame::Shape frameShape
int lineWidth
int midLineWidth

详细说明

QStyleOptionFrame 用于绘制几个内置的 Qt Widgets,包括QFrame 、QGroupBox 、QLineEdit 和QMenu 。

出于性能考虑,该类成员函数较少,且可直接访问成员变量(即使用. 或-> 运算符)。这使得结构体的使用非常直观,并强调了这些只是样式函数所使用的参数。

QStyleOptionFrame 类的实例具有type SO_Frame 和version 3。

该类型由QStyleOption 、其子类以及qstyleoption_cast() 在内部使用,以确定样式选项的类型。 通常情况下,除非您想创建自己的QStyleOption 子类和自定义样式,否则无需担心这一点。QStyleOption 子类使用该版本来实现扩展,同时保持兼容性。如果您使用qstyleoption_cast(),通常无需检查它。

另请参阅 QStyleOption 。

成员类型文档

enum QStyleOptionFrame::FrameFeature
flags QStyleOptionFrame::FrameFeatures

此枚举描述了帧可能具有的不同类型特征。

常量值描述
QStyleOptionFrame::None0x00表示普通框架。
QStyleOptionFrame::Flat0x01表示扁平边框。
QStyleOptionFrame::Rounded0x02表示圆角边框。

FrameFeatures 类型是QFlags<FrameFeature> 的 typedef 定义。它存储 FrameFeature 值的按“或”运算组合。

enum QStyleOptionFrame::StyleOptionType

该枚举用于存储样式选项类型的相关信息,并针对每个QStyleOption 子类分别定义。

常量常量值简体中文(大陆)描述
QStyleOptionFrame::TypeSO_Frame提供的样式选项的类型(对于此类而言为SO_Frame )。

该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用,以确定样式选项的类型。通常情况下,除非你想创建自己的QStyleOption 子类和自己的样式,否则无需担心这一点。

另请参阅 StyleOptionVersion 。

enum QStyleOptionFrame::StyleOptionVersion

该枚举用于存储样式选项的版本信息,并针对每个QStyleOption 子类分别定义。

常量常量值描述
QStyleOptionFrame::Version13

QStyleOption 的子类使用该版本号来实现扩展,同时保持兼容性。如果您使用qstyleoption_cast(),通常无需检查该值。

另请参阅 StyleOptionType 。

成员函数文档

QStyleOptionFrame::QStyleOptionFrame()

创建一个 QStyleOptionFrame,并将成员变量初始化为默认值。

QStyleOptionFrame::QStyleOptionFrame(const QStyleOptionFrame &other)

创建other 样式选项的副本。

[noexcept default] QStyleOptionFrame &QStyleOptionFrame::operator=(const QStyleOptionFrame &)

将other 复制并赋值给此QStyleOptionFrame 实例。

成员变量文档

QStyleOptionFrame::FrameFeatures QStyleOptionFrame::features

该变量存储了描述该帧的特征的按位或运算结果。

另请参阅 FrameFeature 。

QFrame::Shape QStyleOptionFrame::frameShape

该属性保存了帧的形状值。

另请参阅 QFrame::frameShape 。

int QStyleOptionFrame::lineWidth

该变量用于存储绘制边框时的线宽

默认值为 0。

另请参阅 QFrame::lineWidth 。

int QStyleOptionFrame::midLineWidth

该变量用于存储绘制边框时的中线宽度

这通常用于绘制内嵌或凸出的边框。

默认值为 0。

另请参阅 QFrame::midLineWidth 。

© 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.