QStyleOptionToolButton Class
QStyleOptionToolButton 类用于描述绘制工具按钮的参数。更多
| 头文件 | #include <QStyleOptionToolButton> |
| CMake.QStyleOptionToolButton 类 | 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) |
公共变量
| 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 。
枚举 QStyleOptionToolButton::ToolButtonFeature
标志 QStyleOptionToolButton::ToolButtonFeatures
描述工具按钮可能具有的各种特性。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionToolButton::None | 0x00 | 一个普通的工具按钮。 |
QStyleOptionToolButton::Arrow | 0x01 | 工具按钮是一个箭头。 |
QStyleOptionToolButton::Menu | 0x04 | 工具按钮带有菜单。 |
QStyleOptionToolButton::PopupDelay | 0x08 | 显示菜单时有延迟。 |
QStyleOptionToolButton::HasMenu | 0x10 | 按钮有一个弹出菜单。 |
QStyleOptionToolButton::MenuButtonPopup | Menu | 按钮应显示一个箭头，以指示菜单已存在。 |
ToolButtonFeatures 类型是QFlags<ToolButtonFeature> 的类型定义。它存储 ToolButtonFeature 值的 OR 组合。
另请参阅 features,QToolButton::toolButtonStyle() 和QToolButton::popupMode() 。
成员函数文档
QStyleOptionToolButton::QStyleOptionToolButton()
构造一个 QStyleOptionToolButton，将成员变量初始化为默认值。
QStyleOptionToolButton::QStyleOptionToolButton(const QStyleOptionToolButton &other)
构建other 样式选项的副本。
成员变量文档
Qt::ArrowType QStyleOptionToolButton::arrowType
该变量表示工具按钮的箭头方向。
该值仅在features 包括Arrow 时使用。默认值为Qt::DownArrow 。
QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton::features
该变量包含工具按钮功能的 OR 组合
默认值为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() 。
© 2025 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.
