本页内容

QStyleOptionToolBox Class

QStyleOptionToolBox 类用于描述绘制工具箱所需的参数。更多内容...

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

公共类型

enum SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }
enum TabPosition { Beginning, Middle, End, OnlyOneTab }

公共函数

QStyleOptionToolBox()
QStyleOptionToolBox(const QStyleOptionToolBox &other)
QStyleOptionToolBox &operator=(const QStyleOptionToolBox &)

公共变量

QIcon icon
QStyleOptionToolBox::SelectedPosition selectedPosition
QString text

详细说明

QStyleOptionToolBox 包含QStyle 函数绘制QToolBox 所需的所有信息。

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

另请参阅 QStyleOption 和QToolBox 。

成员类型文档

enum QStyleOptionToolBox::SelectedPosition

此枚举描述了所选标签的位置。某些样式需要根据标签是否与所选标签相邻,以不同的方式绘制该标签。

常量值描述
QStyleOptionToolBox::NotAdjacent0该选项卡不与选中选项卡相邻(或本身就是选中选项卡)。
QStyleOptionToolBox::NextIsSelected1下一个选项卡(通常是右侧的选项卡)被选中。
QStyleOptionToolBox::PreviousIsSelected2选中了前一个选项卡(通常是左侧的选项卡)。

另请参阅 selectedPosition 。

enum QStyleOptionToolBox::StyleOptionType

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

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

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

另请参阅 StyleOptionVersion 。

enum QStyleOptionToolBox::StyleOptionVersion

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

常量常量值描述
QStyleOptionToolBox::Version12

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

另请参阅 StyleOptionType 。

enum QStyleOptionToolBox::TabPosition

此枚举描述了标签相对于其他标签的位置。

常量值描述
QStyleOptionToolBox::Beginning0该选项卡是工具箱中的第一个(即最上面的)选项卡。
QStyleOptionToolBox::Middle1该选项卡位于工具箱中间。
QStyleOptionToolBox::End2该选项卡位于工具箱的底部。
QStyleOptionToolBox::OnlyOneTab3工具箱中只有一个选项卡。

成员函数文档

QStyleOptionToolBox::QStyleOptionToolBox()

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

QStyleOptionToolBox::QStyleOptionToolBox(const QStyleOptionToolBox &other)

创建other 样式选项的副本。

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

将other 复制并赋值给该QStyleOptionToolBox 实例。

成员变量文档

QIcon QStyleOptionToolBox::icon

该变量存储工具箱选项卡的图标

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

QStyleOptionToolBox::SelectedPosition QStyleOptionToolBox::selectedPosition

该变量存储选中标签页相对于当前标签页的位置

默认值为NotAdjacent ,即该标签页既不与选中的标签页相邻,也不是选中的标签页。

QString QStyleOptionToolBox::text

该变量存储工具箱选项卡的文本

默认值为空字符串。

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