本页内容

QStyleOptionTitleBar Class

QStyleOptionTitleBar 类用于描述绘制标题栏的参数。更多内容...

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

公共类型

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

公共函数

QStyleOptionTitleBar()
QStyleOptionTitleBar(const QStyleOptionTitleBar &other)
QStyleOptionTitleBar &operator=(const QStyleOptionTitleBar &)

公共变量

QIcon icon
QString text
Qt::WindowFlags titleBarFlags
int titleBarState

详细说明

QStyleOptionTitleBar 包含QStyle 函数绘制QMdiSubWindow 标题栏所需的所有信息。

出于性能考虑,该结构体包含的成员函数较少,且可直接访问其成员变量(即使用. 或-> 运算符)。这使得该结构体易于使用,同时也强调了这些仅仅是样式函数所使用的参数。

另请参阅 QStyleOption 、QStyleOptionComplex 和QMdiSubWindow 。

成员类型文档

enum QStyleOptionTitleBar::StyleOptionType

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

常量常量值描述
QStyleOptionTitleBar::TypeSO_TitleBar提供的样式选项的类型(对于此类而言为SO_TitleBar )。

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

另请参阅 StyleOptionVersion 。

enum QStyleOptionTitleBar::StyleOptionVersion

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

常量常量值描述
QStyleOptionTitleBar::Version11

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

另请参阅 StyleOptionType 。

成员函数文档

QStyleOptionTitleBar::QStyleOptionTitleBar()

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

QStyleOptionTitleBar::QStyleOptionTitleBar(const QStyleOptionTitleBar &other)

创建other 样式选项的副本。

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

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

成员变量文档

QIcon QStyleOptionTitleBar::icon

该变量存储标题栏的图标

其默认值是一个空图标,即既没有位图也没有文件名的图标。

QString QStyleOptionTitleBar::text

该变量存储标题栏的文本

其默认值为空字符串。

Qt::WindowFlags QStyleOptionTitleBar::titleBarFlags

该变量存储了标题栏的小部件标志

默认值为Qt::Widget 。

另请参阅 Qt::WindowFlags 。

int QStyleOptionTitleBar::titleBarState

该变量保存了标题栏的状态

这基本上就是底层控件的窗口状态。默认值为 0。

另请参阅 QWidget::windowState()。

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