QStyleOptionButton Class
QStyleOptionButton 类用于描述绘制按钮时的参数。更多内容...
| 头文件： | #include <QStyleOptionButton> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 继承自： | QStyleOption |
公共类型
| enum | ButtonFeature { None, Flat, HasMenu, DefaultButton, AutoDefaultButton, CommandLinkButton } |
| flags | ButtonFeatures |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
公共函数
| QStyleOptionButton() | |
| QStyleOptionButton(const QStyleOptionButton &other) | |
| QStyleOptionButton & | operator=(const QStyleOptionButton &) |
公共变量
详细说明
QStyleOptionButton 包含QStyle 函数绘制图形元素（如QPushButton 、QCheckBox 和QRadioButton ）所需的所有信息。
出于性能考虑，该结构体包含的成员函数较少，且可直接访问成员变量（即使用. 或-> 运算符）。这使得该结构体易于使用，同时也强调了这些仅仅是样式函数所使用的参数。
另请参阅 QStyleOption 和QStyleOptionToolButton 。
成员类型文档
enum QStyleOptionButton::ButtonFeature
flags QStyleOptionButton::ButtonFeatures
此枚举描述了按钮可能具有的不同类型。
| 常量 | 值 | 描述 |
|---|---|---|
QStyleOptionButton::None | 0x00 | 表示普通按钮。 |
QStyleOptionButton::Flat | 0x01 | 表示一个平按钮。 |
QStyleOptionButton::HasMenu | 0x02 | 表示该按钮带有下拉菜单。 |
QStyleOptionButton::DefaultButton | 0x04 | 表示该按钮是下拉菜单按钮。 |
QStyleOptionButton::AutoDefaultButton | 0x08 | 表示该按钮是自动默认按钮。 |
QStyleOptionButton::CommandLinkButton | 0x10 | 表示该按钮是 Windows Vista 类型的命令链接。 |
ButtonFeatures 类型是QFlags<ButtonFeature> 的 typedef 定义。它存储 ButtonFeature 值的按“或”运算组合。
另请参阅 features 。
enum QStyleOptionButton::StyleOptionType
该枚举用于存储样式选项类型的相关信息，并针对每个QStyleOption 子类分别进行定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionButton::Type | SO_Button | 提供的样式选项的类型（对于此类而言为SO_Button ）。 |
该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，以确定样式选项的类型。通常情况下，除非您想创建自己的QStyleOption 子类和自己的样式，否则无需担心这一点。
另请参阅 StyleOptionVersion 。
enum QStyleOptionButton::StyleOptionVersion
该枚举用于存储样式选项的版本信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionButton::Version | 1 | 1 |
QStyleOption 的子类使用该版本号来实现扩展，同时保持向后兼容性。如果您使用qstyleoption_cast()，通常无需检查该值。
另请参阅 StyleOptionType 。
成员函数文档
QStyleOptionButton::QStyleOptionButton()
创建一个 QStyleOptionButton 对象，并将成员变量初始化为默认值。
QStyleOptionButton::QStyleOptionButton(const QStyleOptionButton &other)
创建other 样式选项的副本。
[noexcept default] QStyleOptionButton &QStyleOptionButton::operator=(const QStyleOptionButton &)
将 `other ` 通过复制赋值给此 `QStyleOptionButton ` 实例。
成员变量文档
QStyleOptionButton::ButtonFeatures QStyleOptionButton::features
该变量存储了描述此按钮的特征的按位或（OR）结果
另请参阅 ButtonFeature 。
QIcon QStyleOptionButton::icon
该变量存储按钮的图标
默认值是一个空图标，即既没有位图也没有文件名的图标。
另请参阅 iconSize 。
QSize QStyleOptionButton::iconSize
该变量存储按钮图标的大小
默认值为QSize （-1, -1），即一个无效的尺寸。
QString QStyleOptionButton::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.
