QStyleOptionToolButton 类

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

头文件	#include <QStyleOptionToolButton>
CMake	find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake	QT += widgets
继承	QStyleOptionComplex

所有成员列表，包括继承成员

公共类型

枚举	StyleOptionType { Type }
枚举	StyleOptionVersion { Version }
枚举	ToolButtonFeature { None, Arrow, Menu, PopupDelay, HasMenu, MenuButtonPopup }
标志	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。

成员类型文档

枚举 QStyleOptionToolButton::StyleOptionType

此枚举用于保存有关样式选项类型的信息，并为每个 QStyleOption 子类定义。

常量	值	描述
`QStyleOptionToolButton::Type`	`SO_ToolButton`	提供的样式选项类型（此类的 SO_ToolButton）。

该类型在 QStyleOption、其子类和 qstyleoption_cast() 中内部使用，以确定样式选项的类型。通常，除非您想创建自己的 QStyleOption 子类和样式，否则您不必担心这一点。

参阅以下内容 StyleOptionVersion.

枚举 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`	`菜单`	按钮应显示一个箭头以表明存在菜单。

ToolButtonFeatures 类型是对 QFlags<ToolButtonFeature> 的 typedef。它存储 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。