QStyleOptionToolButton 类

The QStyleOptionToolButton class is used to describe the parameters for drawing a tool button. 更多...

头: #include <QStyleOptionToolButton>
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

详细描述

The QStyleOptionToolButton class is used to describe the parameters for drawing a tool button.

QStyleOptionToolButton contains all the information that QStyle 函数需要绘制 QToolButton .

For performance reasons, the access to the member variables is direct (i.e., using the . or -> operator). This low-level feel makes the structures straightforward to use and emphasizes that these are simply parameters used by the style functions.

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

另请参阅 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 ()

构造 QStyleOptionToolButton , initializing the members variables to their default values.

QStyleOptionToolButton:: QStyleOptionToolButton (const QStyleOptionToolButton & other )

构造副本为 other 样式选项。

成员变量文档编制

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 ().