QStyleOptionToolButton Class
QStyleOptionToolButton 类用于描述绘制工具按钮的参数。更多内容...
| 头文件： | #include <QStyleOptionToolButton> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake： | QT += widgets |
| 继承自： | QStyleOptionComplex |
公共类型
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
| enum | ToolButtonFeature { None, Arrow, Menu, PopupDelay, HasMenu, MenuButtonPopup } |
| flags | ToolButtonFeatures |
公共函数
| QStyleOptionToolButton() | |
| QStyleOptionToolButton(const QStyleOptionToolButton &other) | |
| QStyleOptionToolButton & | operator=(const QStyleOptionToolButton &) |
公共变量
| Qt::ArrowType | arrowType |
| QStyleOptionToolButton::ToolButtonFeatures | features |
| QFont | font |
| QIcon | icon |
| QSize | iconSize |
| QPoint | pos |
| QString | text |
| Qt::ToolButtonStyle | toolButtonStyle |
详细说明
QStyleOptionToolButton 包含QStyle 函数绘制QToolButton 所需的所有信息。
出于性能考虑，该结构体包含的成员函数很少，且可直接访问成员变量（即使用. 或-> 运算符）。这使得该结构体的使用非常直观，同时也强调了这些仅仅是样式函数所使用的参数。
另请参阅 QStyleOption 、QStyleOptionComplex 和QStyleOptionButton 。
成员类型文档
enum QStyleOptionToolButton::StyleOptionType
该枚举用于存储样式选项类型的相关信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionToolButton::Type | SO_ToolButton | 提供的样式选项的类型（对于此类而言为SO_ToolButton ）。 |
该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，以确定样式选项的类型。通常情况下，除非你想创建自己的QStyleOption 子类和自己的样式，否则无需担心此问题。
另请参阅 StyleOptionVersion 。
enum QStyleOptionToolButton::StyleOptionVersion
该枚举用于存储样式选项的版本信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionToolButton::Version | 1 | 1 |
QStyleOption 的子类使用该版本号来实现扩展，同时保持向后兼容性。如果您使用qstyleoption_cast()，通常无需检查该值。
另请参阅 StyleOptionType 。
enum QStyleOptionToolButton::ToolButtonFeature
flags QStyleOptionToolButton::ToolButtonFeatures
描述了工具按钮可能具备的各种功能。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionToolButton::None | 0x00 | 一个普通的工具按钮。 |
QStyleOptionToolButton::Arrow | 0x01 | 该工具按钮为箭头形状。 |
QStyleOptionToolButton::Menu | 0x04 | 该工具按钮带有菜单。 |
QStyleOptionToolButton::PopupDelay | 0x08 | 显示菜单时会有延迟。 |
QStyleOptionToolButton::HasMenu | 0x10 | 该按钮带有弹出菜单。 |
QStyleOptionToolButton::MenuButtonPopup | Menu | 该按钮应显示一个箭头，以表明存在菜单。 |
ToolButtonFeatures 类型是QFlags<ToolButtonFeature> 的 typedef。它存储 ToolButtonFeature 值的按“或”运算组合。
另请参阅 features 、QToolButton::toolButtonStyle() 和QToolButton::popupMode()。
成员函数文档
QStyleOptionToolButton::QStyleOptionToolButton()
创建一个 QStyleOptionToolButton，并将成员变量初始化为默认值。
QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)
创建other 样式选项的副本。
[noexcept default] QStyleOptionToolButton &QStyleOptionToolButton::operator=(const QStyleOptionToolButton &)
将 `other ` 通过复制赋值给此 `QStyleOptionToolButton ` 实例。
成员变量文档
Qt::ArrowType QStyleOptionToolButton::arrowType
该变量用于存储工具按钮箭头的方向
仅当features 包含Arrow 时，才会使用此值。默认值为Qt::DownArrow 。
QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features
该变量存储了工具按钮功能的“或”组合
默认值为None 。
另请参阅 ToolButtonFeature 。
QFont QStyleOptionToolButton::font
该变量存储用于文本的字体
仅当toolButtonStyle 的值为Qt::ToolButtonTextUnderIcon 、Qt::ToolButtonTextBesideIcon 或Qt::ToolButtonTextOnly 时，才会使用此值。默认情况下，将使用应用程序的默认字体。
QIcon QStyleOptionToolButton::icon
该变量存储工具按钮的图标
默认值是一个空图标，即既没有位图也没有文件名的图标。
另请参阅 iconSize 。
QSize QStyleOptionToolButton::iconSize
该变量存储工具按钮图标的大小
默认值为QSize （-1, -1），即一个无效的尺寸。
QPoint QStyleOptionToolButton::pos
该变量存储工具按钮的位置
默认值为原点，即 (0, 0)
QString QStyleOptionToolButton::text
该变量存储工具按钮的文本内容
仅当toolButtonStyle 的值为Qt::ToolButtonTextUnderIcon 、Qt::ToolButtonTextBesideIcon 或Qt::ToolButtonTextOnly 时，才会使用此值。默认值为空字符串。
Qt::ToolButtonStyle QStyleOptionToolButton::toolButtonStyle
该变量存储一个Qt::ToolButtonStyle 值，用于描述工具按钮的外观
默认值为Qt::ToolButtonIconOnly 。
另请参阅 QToolButton::toolButtonStyle()。
© 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.
