内容

• 公共类型
• 公共函数
• 公共变量
• 详细描述

QStyleOptionMenuItem 类

The QStyleOptionMenuItem class is used to describe the parameter necessary for drawing a menu item. 更多...

头：	#include <QStyleOptionMenuItem>
qmake:	QT += widgets
继承：	QStyleOption

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

公共类型

enum	CheckType { NotCheckable, Exclusive, NonExclusive }
enum	MenuItemType { Normal, DefaultItem, Separator, SubMenu, ..., EmptyArea }
enum	StyleOptionType { Type }
enum	StyleOptionVersion { Version }

公共函数

	QStyleOptionMenuItem ()
	QStyleOptionMenuItem (const QStyleOptionMenuItem & other )

• 2 公共函数继承自 QStyleOption

公共变量

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

• 8 public variables inherited from QStyleOption

详细描述

The QStyleOptionMenuItem class is used to describe the parameter necessary for drawing a menu item.

QStyleOptionMenuItem contains all the information that QStyle 函数需要绘制菜单项从 QMenu 。它还用于绘制其它相关菜单 Widget。

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 .

成员类型文档编制

enum QStyleOptionMenuItem:: CheckType

此枚举用于指示是否应该为项绘制复选标记，或者即使根本不应该绘制复选标记。

常量	值	描述
QStyleOptionMenuItem::NotCheckable	0	项不可复选。
QStyleOptionMenuItem::Exclusive	1	项是独占复选项 (像：单选按钮)。
QStyleOptionMenuItem::NonExclusive	2	项是非独占复选项 (像：复选框)。

另请参阅 checkType , QAction::checkable , QAction::checked ，和 QActionGroup::exclusive .

enum 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 .

enum QStyleOptionMenuItem:: StyleOptionType

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

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

类型内部使用通过 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 QStyleOptionMenuItem:: StyleOptionVersion

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

常量	值	描述
QStyleOptionMenuItem::Version	1	1

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

另请参阅 StyleOptionType .

成员函数文档编制

QStyleOptionMenuItem:: QStyleOptionMenuItem ()

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

QStyleOptionMenuItem:: QStyleOptionMenuItem (const QStyleOptionMenuItem & other )

构造副本为 other 样式选项。

成员变量文档编制

CheckType QStyleOptionMenuItem:: checkType

This variable holds the type of checkmark of the menu item

默认值为 NotCheckable .

另请参阅 CheckType .

bool QStyleOptionMenuItem:: checked

This variable holds whether the menu item is checked or not

默认值为 false。

QFont QStyleOptionMenuItem:: font

This variable holds the font used for the menu item text

This is the font that should be used for drawing the menu text minus the shortcut. The shortcut is usually drawn using the painter's font. By default, the application's default font is used.

QIcon QStyleOptionMenuItem:: icon

This variable holds the icon for the menu item

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

int QStyleOptionMenuItem:: maxIconWidth

This variable holds the maximum icon width for the icon in the menu item

This can be used for drawing the icon into the correct place or properly aligning items. The variable must be set regardless of whether or not the menu item has an icon. The default value is 0.

bool QStyleOptionMenuItem:: menuHasCheckableItems

This variable holds whether the menu as a whole has checkable items or not

默认值为 true。

If this option is set to false, then the menu has no checkable items. This makes it possible for GUI styles to save some horizontal space that would normally be used for the check column.

MenuItemType QStyleOptionMenuItem:: menuItemType

This variable holds the type of menu item

默认值为 Normal .

另请参阅 MenuItemType .

QRect QStyleOptionMenuItem:: menuRect

This variable holds the rectangle for the entire menu

The default value is a null rectangle, i.e. a rectangle with both the width and the height set to 0.

int QStyleOptionMenuItem:: tabWidth

This variable holds the tab width for the menu item

The tab width is the distance between the text of the menu item and the shortcut. The default value is 0.

QString QStyleOptionMenuItem:: text

This variable holds the text for the menu item

Note that the text format is something like this "Menu text \t Shortcut".

If the menu item doesn't have a shortcut, it will just contain the menu item's text. The default value is an empty string.