Home · All Classes · Main Classes · Annotated · Grouped Classes · Functions

QStyleOptionMenuItem Class Reference

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

#include <QStyleOptionMenuItem>

Part of the QtGui module.

Inherits QStyleOption.

Public Types

Properties

Public Functions


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.

ConstantValueDescription
QStyleOptionMenuItem::NotCheckable0The item is not checkable.
QStyleOptionMenuItem::Exclusive1The item is an exclusive check item (like a radio button).
QStyleOptionMenuItem::NonExclusive2The item is a non-exclusive check item (like a check box).

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

enum QStyleOptionMenuItem::MenuItemType

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

ConstantValueDescription
QStyleOptionMenuItem::Normal0A normal menu item.
QStyleOptionMenuItem::DefaultItem1A menu item that is the default action
QStyleOptionMenuItem::Separator2A menu separator.
QStyleOptionMenuItem::SubMenu3Indicates the menu item points to a sub-menu.
QStyleOptionMenuItem::Scroller4A popup menu scroller (currently only used on Mac OS X).
QStyleOptionMenuItem::TearOff5A tear-off handle for the menu.
QStyleOptionMenuItem::Margin6The margin of the menu.
QStyleOptionMenuItem::EmptyArea7The empty area of the menu.

See also QMenu::defaultAction() and ..


Property Documentation

checkType : const CheckType

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

See also CheckType.

checked : const bool

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

font : const QFont

This property 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.

icon : const QIcon

This property holds the icon for the menu item.

maxIconWidth : const int

This property 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.

menuHasCheckableItems : const bool

This property 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 : const MenuItemType

This property holds the type of menu item.

See also MenuItemType.

menuRect : const QRect

This property holds the rectangle for the entire menu.

tabWidth : const int

This property holds the tab width for the menu item.

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

text : const QString

This property 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.


Member Function Documentation

QStyleOptionMenuItem::QStyleOptionMenuItem ()

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

QStyleOptionMenuItem::QStyleOptionMenuItem ( const QStyleOptionMenuItem & other )


Copyright © 2005 Trolltech Trademarks
Qt 4.0.0-b2