QStyleOptionMenuItem 类

QStyleOptionMenuItem 类用于描述绘制菜单项所需的参数。了解更多...

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

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

公共类型

枚举	CheckType { NotCheckable, Exclusive, NonExclusive }
枚举	MenuItemType { Normal, DefaultItem, Separator, SubMenu, Scroller, …, EmptyArea }
枚举	StyleOptionType { Type }
枚举	StyleOptionVersion { Version }

公共函数

	QStyleOptionMenuItem()
	QStyleOptionMenuItem(const QStyleOptionMenuItem &other)

公共变量

QStyleOptionMenuItem::CheckType	checkType
bool	checked
QFont	font
QIcon	icon
int	maxIconWidth
bool	menuHasCheckableItems
QStyleOptionMenuItem::MenuItemType	menuItemType
QRect	menuRect
int	reservedShortcutWidth
QString	text

详细描述

QStyleOptionMenuItem 包含了 QStyle 函数绘制来自 QMenu 的菜单项所需的所有信息。该类也用于绘制其他与菜单相关的控件。

出于性能考虑，该类中很少有成员函数，对成员变量的访问是直接的（即，使用 . 或 -> 操作符）。这使得这些结构的使用变得简单直接，强调了这些都是仅由样式函数使用的参数。

另请参阅 QStyleOption.

成员类型文档

枚举 QStyleOptionMenuItem::CheckType

此枚举用于指示是否为项绘制复选标记，甚至全部都不绘制。

常量	值	描述
`QStyleOptionMenuItem::NotCheckable`	`0`	项不可选择。
`QStyleOptionMenuItem::Exclusive`	`1`	项是排他性复选项（如单选按钮）。
`QStyleOptionMenuItem::NonExclusive`	`2`	项是非排他性复选项（如复选框）。

另请参阅 checkType、QAction::checkable、QAction::checked 和 QActionGroup::exclusionPolicy。

枚举 QStyleOptionMenuItem::MenuItemType

此枚举表示结构所述菜单项的类型。

常量	值	描述
`QStyleOptionMenuItem::Normal`	`0`	普通菜单项。
`QStyleOptionMenuItem::DefaultItem`	`1`	一个菜单项，它是通过 QMenu::defaultAction() 指定的默认操作。
`QStyleOptionMenuItem::Separator`	`2`	菜单分隔符。
`QStyleOptionMenuItem::SubMenu`	`3`	表示菜单项指向一个子菜单。
`QStyleOptionMenuItem::Scroller`	`4`	弹出菜单滚动条（目前仅在 macOS 上使用）。
`QStyleOptionMenuItem::TearOff`	`5`	菜单的撕裂处理。
`QStyleOptionMenuItem::Margin`	`6`	菜单的边距。
`QStyleOptionMenuItem::EmptyArea`	`7`	菜单的空区域。

另请参阅menuItemType.

枚举 QStyleOptionMenuItem::StyleOptionType

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

常量	值	描述
`QStyleOptionMenuItem::Type`	`SO_MenuItem`	提供的样式选项类型（对本类而言为 SO_MenuItem）。

类型由 QStyleOption、其子类以及 qstyleoption_cast() 内部使用，以确定样式选项的类型。通常，除非您想创建自己的 QStyleOption 子类和自己的样式，否则您不需要担心此类型。

另请参阅StyleOptionVersion.

枚举 QStyleOptionMenuItem::StyleOptionVersion

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

常量	值	描述
`QStyleOptionMenuItem::Version`	`1`	1

版本由 QStyleOption 子类用于在不破坏兼容性的情况下实现扩展。如果您使用 qstyleoption_cast()，通常不需要检查它。

另请参阅StyleOptionType.

成员函数文档

QStyleOptionMenuItem::QStyleOptionMenuItem()

构造一个 QStyleOptionMenuItem，将成员变量初始化为其默认值。

QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)

构造 other 样式选项的副本。

成员变量文档

QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType

此变量包含菜单项勾选框的类型

默认值为 NotCheckable。

另请参阅CheckType.

bool QStyleOptionMenuItem::checked

此变量包含菜单项是否被勾选

默认值为 false。

QFont QStyleOptionMenuItem::font

此变量包含用于菜单项文本的字体

这是用于绘制减去快捷键的菜单文本的字体。快捷键通常使用画笔的字体绘制。默认情况下，使用应用程序的默认字体。

QIcon QStyleOptionMenuItem::icon

此变量保存菜单项的图标

默认值为空图标，即没有图样和文件名的图标。

int QStyleOptionMenuItem::maxIconWidth

此变量保存菜单项中图标的最大宽度

可用此变量将图标绘制到正确的位置或正确对齐项。无论菜单项是否有图标，都必须设置此变量。默认值为0。

bool QStyleOptionMenuItem::menuHasCheckableItems

此变量保存整个菜单是否有可勾选的项

默认值为true。

如果此选项设置为false，则菜单没有可勾选的项。这样可以使得GUI样式节省用于勾选列的正常水平空间。

QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType

此变量保存菜单项的类型

默认值为正常。

另请参阅 MenuItemType。

QRect QStyleOptionMenuItem::menuRect

此变量保存整个菜单的矩形

默认值是一个空矩形，即宽度和高度都设置为0的矩形。

int QStyleOptionMenuItem::reservedShortcutWidth

此变量保存菜单项快捷键的预留宽度

QMenu 将其设置为菜单中所有可见项中最宽快捷键占用的宽度。

默认值为0。

QString QStyleOptionMenuItem::text

此变量保存菜单项的文本

请注意，文本格式类似于这样 "菜单文本\t快捷键"。

如果菜单项没有快捷键，它将只包含菜单项的文本。默认值是一个空字符串。