QStyleOptionToolButton 类

QStyleOptionToolButton 类是用于绘制工具按钮的描述参数。 更多...

头: #include <QStyleOptionToolButton>
CMake: find_package(Qt6 COMPONENTS Widgets REQUIRED)
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 (const QStyleOptionToolButton & other )
  QStyleOptionToolButton ()

公共变量

Qt::ArrowType arrowType
QStyleOptionToolButton::ToolButtonFeatures features
QFont font
QIcon icon
QSize iconSize
QPoint pos
QString text
Qt::ToolButtonStyle toolButtonStyle

详细描述

QStyleOptionToolButton 包含所有信息当 QStyle 函数需要绘制 QToolButton .

出于性能原因,有很少成员函数,且对成员变量的访问是直接的 (即:使用 . or -> 运算符)。这使结构易于使用并强调这些只需通过样式函数使用参数。

对于可以如何使用样式选项的演示范例,见 样式 范例。

另请参阅 QStyleOption , QStyleOptionComplex ,和 QStyleOptionButton .

成员类型文档编制

enum QStyleOptionToolButton:: StyleOptionType

This enum is used to hold information about the type of the style option, and is defined for each QStyleOption 子类。

常量 描述
QStyleOptionToolButton::Type SO_ToolButton 提供样式选项的类型 ( SO_ToolButton 对于此类)。

类型内部使用通过 QStyleOption ,其子类,和 qstyleoption_cast () to determine the type of style option. In general you do not need to worry about this unless you want to create your own QStyleOption subclass and your own styles.

另请参阅 StyleOptionVersion .

enum QStyleOptionToolButton:: StyleOptionVersion

This enum is used to hold information about the version of the style option, and is defined for each QStyleOption 子类。

常量 描述
QStyleOptionToolButton::Version 1 1

版本的使用通过 QStyleOption 子类以实现扩展在不破坏兼容性的情况下。若使用 qstyleoption_cast (),通常不需要校验它。

另请参阅 StyleOptionType .

enum QStyleOptionToolButton:: ToolButtonFeature
flags QStyleOptionToolButton:: ToolButtonFeatures

描述工具按钮可以拥有的各种特征。

常量 描述
QStyleOptionToolButton::None 0x00 A normal tool button.
QStyleOptionToolButton::Arrow 0x01 The tool button is an arrow.
QStyleOptionToolButton::Menu 0x04 The tool button has a menu.
QStyleOptionToolButton::PopupDelay 0x08 There is a delay to showing the menu.
QStyleOptionToolButton::HasMenu 0x10 The button has a popup menu.
QStyleOptionToolButton::MenuButtonPopup Menu The button should display an arrow to indicate that a menu is present.

ToolButtonFeatures 类型是 typedef 对于 QFlags <ToolButtonFeature>. It stores an OR combination of ToolButtonFeature values.

另请参阅 features , QToolButton::toolButtonStyle (),和 QToolButton::popupMode ().

成员函数文档编制

QStyleOptionToolButton:: QStyleOptionToolButton (const QStyleOptionToolButton & other )

构造副本为 other 样式选项。

QStyleOptionToolButton:: QStyleOptionToolButton ()

Constructs a QStyleOptionToolButton, initializing the members variables to their default values.

成员变量文档编制

Qt::ArrowType QStyleOptionToolButton:: arrowType

此变量保持工具按钮的箭头方向

This value is only used if features 包括 Arrow 。默认值为 Qt::DownArrow .

QStyleOptionToolButton::ToolButtonFeatures QStyleOptionToolButton:: features

This variable holds an OR combination of the tool button's features

默认值为 None .

另请参阅 ToolButtonFeature .

QFont QStyleOptionToolButton:: font

This variable holds the font that is used for the text

This value is only used if toolButtonStyle is Qt::ToolButtonTextUnderIcon , Qt::ToolButtonTextBesideIcon ,或 Qt::ToolButtonTextOnly . By default, the application's default font is used.

QIcon QStyleOptionToolButton:: icon

This variable holds the icon for the tool button

默认值为空图标 (即:图标既没有像素图,也没有文件名)。

另请参阅 iconSize .

QSize QStyleOptionToolButton:: iconSize

This variable holds the size of the icon for the tool button

默认值为 QSize (-1, -1),即:无效尺寸。

QPoint QStyleOptionToolButton:: pos

This variable holds the position of the tool button

The default value is a null point, i.e. (0, 0)

QString QStyleOptionToolButton:: text

This variable holds the text of the tool button

This value is only used if toolButtonStyle is Qt::ToolButtonTextUnderIcon , Qt::ToolButtonTextBesideIcon ,或 Qt::ToolButtonTextOnly . The default value is an empty string.

Qt::ToolButtonStyle QStyleOptionToolButton:: toolButtonStyle

This variable holds a Qt::ToolButtonStyle value describing the appearance of the tool button

默认值为 Qt::ToolButtonIconOnly .

另请参阅 QToolButton::toolButtonStyle ().