QStyleOptionMenuItem Class Reference
^{[QtGui module]}

Detailed Description

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

The QStyleOptionMenuItem is used for drawing menu items from QMenu. It is also used for drawing other menu-related widgets.

Member Type Documentation

enum QStyleOptionMenuItem::CheckType

These enums are used to indicate whether or not a check mark should be drawn for the item, or even if it should be drawn at all.

See also QAction::checkable, QAction::checked, and QActionGroup::exclusive.

enum QStyleOptionMenuItem::MenuItemType

These values indicate the type of menu item that the structure describes.

Member Function Documentation

QStyleOptionMenuItem::QStyleOptionMenuItem ()

Constructs a QStyleOptionMenuItem. The members variables are initialized to default values.

QStyleOptionMenuItem::QStyleOptionMenuItem ( const QStyleOptionMenuItem & other )

Constructs a copy of the other style option.

Member Variable Documentation

const int QStyleOptionMenuItem::Type

Equals SO_MenuItem.

const int QStyleOptionMenuItem::Version

Equals 1.

CheckType QStyleOptionMenuItem::checkType

This variable holds the type of checkmark of the menu item.

See also CheckType.

bool QStyleOptionMenuItem::checked

This variable holds whether the menu item is checked or not.

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.

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.

bool QStyleOptionMenuItem::menuHasCheckableItems

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

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.

See also MenuItemType.

QRect QStyleOptionMenuItem::menuRect

This variable holds the rectangle for the entire menu.

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.

QString QStyleOptionMenuItem::text

This variable holds the text for the menu item.

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

If the menu item doesn't have a shortcut, it will just contain the menu item's text.