# QStyleOptionMenuItem Class Reference ## [[QtGui](index.htm) module] 該QStyleOptionMenuItem類是用來描述所必需的繪制的菜單項的參數。[More...](#details) 繼承[QStyleOption](qstyleoption.html)。 ### Types * `enum CheckType { NotCheckable, Exclusive, NonExclusive }` * `enum MenuItemType { Normal, DefaultItem, Separator, SubMenu, ..., EmptyArea }` * `enum StyleOptionType { Type }` * `enum StyleOptionVersion { Version }` ### Methods * `__init__ (self)` * `__init__ (self, QStyleOptionMenuItem?other)` ### Members * `bool **[checked](qstyleoptionmenuitem.html#checked-var)**` * `CheckType **[checkType](qstyleoptionmenuitem.html#checkType-var)**` * `QFont **[font](qstyleoptionmenuitem.html#font-var)**` * `QIcon **[icon](qstyleoptionmenuitem.html#icon-var)**` * `int **[maxIconWidth](qstyleoptionmenuitem.html#maxIconWidth-var)**` * `bool **[menuHasCheckableItems](qstyleoptionmenuitem.html#menuHasCheckableItems-var)**` * `MenuItemType **[menuItemType](qstyleoptionmenuitem.html#menuItemType-var)**` * `QRect **[menuRect](qstyleoptionmenuitem.html#menuRect-var)**` * `int **[tabWidth](qstyleoptionmenuitem.html#tabWidth-var)**` * `QString **[text](qstyleoptionmenuitem.html#text-var)**` * * * ## Detailed Description 該QStyleOptionMenuItem類是用來描述所必需的繪制的菜單項的參數。 QStyleOptionMenuItem包含的所有信息，[QStyle](qstyle.html)功能需要從繪制菜單項[QMenu](qmenu.html)。它也被用于繪制其他菜單相關的部件。 出于性能方面的原因，訪問成員變量是直接的（即使用`.` or `->`操作符）。這種低層次的感覺，使結構簡單的使用，并強調這些只是所用的樣式函數的參數。 舉一個例子展示風格選擇如何使用，請參閱[Styles](index.htm)例子。 * * * ## Type Documentation ``` QStyleOptionMenuItem.CheckType ``` 此枚舉是用來表示一個復選標記是否應該被繪制的項目，或者即使它應該在所有繪制。 | Constant | Value | Description | | --- | --- | --- | | `QStyleOptionMenuItem.NotCheckable` | `0` | 該項目是不是可復。 | | `QStyleOptionMenuItem.Exclusive` | `1` | 該項目是獨家檢查項目（如單選按鈕） 。 | | `QStyleOptionMenuItem.NonExclusive` | `2` | 該項目是一個非排他性的檢查項目（如復選框） 。 | **See also** [checkType](qstyleoptionmenuitem.html#checkType-var)，[QAction.checkable](qaction.html#checkable-prop)，[QAction.checked](qaction.html#checked-prop)和[QActionGroup.exclusive](qactiongroup.html#exclusive-prop)。 ``` QStyleOptionMenuItem.MenuItemType ``` 這個枚舉表示該結構描述了菜單項的類型。 | Constant | Value | Description | | --- | --- | --- | | `QStyleOptionMenuItem.Normal` | `0` | 一個正常的菜單項。 | | `QStyleOptionMenuItem.DefaultItem` | `1` | 菜單項是默認操作與指定的[QMenu.defaultAction](qmenu.html#defaultAction)（ ） 。 | | `QStyleOptionMenuItem.Separator` | `2` | 一個菜單分隔符。 | | `QStyleOptionMenuItem.SubMenu` | `3` | 表示該菜單項指向一個子菜單。 | | `QStyleOptionMenuItem.Scroller` | `4` | 一個彈出式菜單滾動條（目前只用于在Mac OS X ） 。 | | `QStyleOptionMenuItem.TearOff` | `5` | 為菜單可撕式手柄。 | | `QStyleOptionMenuItem.Margin` | `6` | 菜單的利潤率。 | | `QStyleOptionMenuItem.EmptyArea` | `7` | 菜單的空白區域。 | **See also** [menuItemType](qstyleoptionmenuitem.html#menuItemType-var)。 ``` QStyleOptionMenuItem.StyleOptionType ``` 此枚舉是用來保存有關樣式選項的類型信息，并定義每個[QStyleOption](qstyleoption.html)子類。 | Constant | Value | Description | | --- | --- | --- | | `QStyleOptionMenuItem.Type` | `SO_MenuItem` | 風格選擇該類型提供（[SO_MenuItem](qstyleoption.html#OptionType-enum)這個類） 。 | 該類型在內部使用[QStyleOption](qstyleoption.html)，它的子類，并[qstyleoption_cast](qstyleoption.html#qstyleoption_cast)（）來確定的樣式選項的類型。一般來說，你不需要擔心這個，除非你想創建自己的[QStyleOption](qstyleoption.html)子類和你自己的風格。 **See also** [StyleOptionVersion](qstyleoptionmenuitem.html#StyleOptionVersion-enum)。 ``` QStyleOptionMenuItem.StyleOptionVersion ``` 此枚舉是用來保存有關樣式選項的版本信息，并定義每個[QStyleOption](qstyleoption.html)子類。 | Constant | Value | Description | | --- | --- | --- | | `QStyleOptionMenuItem.Version` | `1` | 1 | 的版本是由[QStyleOption](qstyleoption.html)子類實現不破壞兼容性擴展。如果你使用[qstyleoption_cast](qstyleoption.html#qstyleoption_cast)（ ） ，你通常并不需要檢查它。 **See also** [StyleOptionType](qstyleoptionmenuitem.html#StyleOptionType-enum)。 * * * ## Method Documentation ``` QStyleOptionMenuItem.__init__ (self) ``` 構造一個[QStyleOptionMenuItem](qstyleoptionmenuitem.html)，初始化成員變量，它們的默認值。 ``` QStyleOptionMenuItem.__init__ (self, QStyleOptionMenuItem?other) ``` 構造的一個副本_other_樣式選項。 * * * ## Member Documentation ``` bool checked ``` 這個變量保存是否在菜單項被選中與否。 默認值是False 。 ``` CheckType checkType ``` [ 這個變量保存菜單項的選中標記的類型。 ](qstyleoptionmenuitem.html#CheckType-enum) [缺省值是](qstyleoptionmenuitem.html#CheckType-enum)[NotCheckable](qstyleoptionmenuitem.html#CheckType-enum)。 **See also** [CheckType](qstyleoptionmenuitem.html#CheckType-enum)。 ``` QFont font ``` [ 這個變量保存用于菜單項文本的字體。 這是應該用于繪制文本菜單減去快捷的字體。快捷方式是使用畫家的字體通常被繪制。默認情況下，應用程序的默認字體。 ](qfont.html) ``` QIcon icon ``` [ 這個變量保存為菜單項的圖標。 默認值是一個空的圖標，即與既不是像素圖，也不是一個文件名的圖標。 ``` int maxIconWidth ``` 這個變量保存的最大寬度圖標在菜單項的圖標。 這可以被用于繪制圖標到正確的位置或適當的對準件。該變量必須設置無論菜單項是否有一個圖標。默認值是0。 ``` bool menuHasCheckableItems ``` 這個變量保存菜單是否作為一個整體具有辨認的物品或沒有。 默認值是True 。 如果此選項設置為False ，然后在菜單沒有辨認的項目。這使得它可以用于圖形用戶界面風格，以節省一些橫向空間，通常會被用于檢查列。 ](qicon.html) ``` MenuItemType menuItemType ``` [ 這個變量保存菜單項的類型。 ](qstyleoptionmenuitem.html#MenuItemType-enum) [缺省值是](qstyleoptionmenuitem.html#MenuItemType-enum)[Normal](qstyleoptionmenuitem.html#MenuItemType-enum)。 **See also** [MenuItemType](qstyleoptionmenuitem.html#MenuItemType-enum)。 ``` QRect menuRect ``` [ 這個變量保存了整個菜單的矩形。 默認值是空的矩形，即用寬度和高度設置為0的矩形。 ``` int tabWidth ``` 這個變量保存的標籤寬度為菜單項。 該選項卡的寬度是菜單項的文本和快捷之間的距離。默認值是0。 ``` QString text ``` 這個變量保存的文本菜單項。 需要注意的是文本格式是這樣的“菜單文本**\t**快捷方式“ 。 如果菜單項沒有一個快捷方式，它只會包含菜單項的文本。默認值是一個空字符串。 ](qrect.html)