QStyleOptionMenuItem Class
La clase QStyleOptionMenuItem se utiliza para describir los parámetros necesarios para dibujar un elemento de menú. Más información...
| Encabezado: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredado de: | QStyleOption |
| Heredado por: |
Tipos públicos
| enum | CheckType { NotCheckable, Exclusive, NonExclusive } |
| enum | MenuItemType { Normal, DefaultItem, Separator, SubMenu, Scroller, …, EmptyArea } |
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
Funciones públicas
| QStyleOptionMenuItem() | |
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) | |
| QStyleOptionMenuItem & | operator=(const QStyleOptionMenuItem &) |
Variables públicas
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | reservedShortcutWidth |
| QString | text |
Descripción detallada
QStyleOptionMenuItem contiene toda la información que necesitan las funciones « QStyle » para dibujar los elementos del menú de « QMenu ». También se utiliza para dibujar otros widgets relacionados con el menú.
Por motivos de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, mediante el operador . o -> ). Esto hace que las estructuras sean fáciles de usar y subraya que se trata simplemente de parámetros utilizados por las funciones de estilo.
Véase también QStyleOption.
Documentación sobre tipos miembros
enum QStyleOptionMenuItem::CheckType
Esta enumeración se utiliza para indicar si se debe dibujar o no una marca de verificación para el elemento, o incluso si se debe dibujar en absoluto.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | El elemento no se puede marcar. |
QStyleOptionMenuItem::Exclusive | 1 | El elemento es un elemento de selección exclusiva (como un botón de opción). |
QStyleOptionMenuItem::NonExclusive | 2 | El elemento es un elemento de selección no exclusiva (como una casilla de selección). |
Véase también checkType, QAction::checkable, QAction::checked y QActionGroup::exclusionPolicy.
enum QStyleOptionMenuItem::MenuItemType
Esta enumeración indica el tipo de elemento de menú que describe la estructura.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | Una opción de menú normal. |
QStyleOptionMenuItem::DefaultItem | 1 | Un elemento de menú que es la acción predeterminada, tal y como se especifica con ` QMenu::defaultAction()`. |
QStyleOptionMenuItem::Separator | 2 | Un separador de menú. |
QStyleOptionMenuItem::SubMenu | 3 | Indica que el elemento de menú apunta a un submenú. |
QStyleOptionMenuItem::Scroller | 4 | Un control de desplazamiento del menú emergente (actualmente solo se utiliza en macOS). |
QStyleOptionMenuItem::TearOff | 5 | Un controlador de separación para el menú. |
QStyleOptionMenuItem::Margin | 6 | Obsoleto y sin uso. El margen del menú. |
QStyleOptionMenuItem::EmptyArea | TearOff + 2 | El área vacía del menú. |
Véase también menuItemType.
enum QStyleOptionMenuItem::StyleOptionType
Esta enumeración se utiliza para almacenar información sobre el tipo de la opción de estilo y se define para cada subclase de ` QStyleOption `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionMenuItem::Type | SO_MenuItem | El tipo de opción de estilo proporcionada (SO_MenuItem para esta clase). |
El tipo lo utilizan internamente ` QStyleOption`, sus subclases y ` qstyleoption_cast()` para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de ` QStyleOption ` y tus propios estilos.
Véase también StyleOptionVersion.
enum QStyleOptionMenuItem::StyleOptionVersion
Esta enumeración se utiliza para almacenar información sobre la versión de la opción de estilo y se define para cada subclase de ` QStyleOption `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionMenuItem::Version | 1 | 1 |
Las subclases de ` QStyleOption ` utilizan esta versión para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario que la compruebes.
Véase también StyleOptionType.
Documentación de funciones miembro
QStyleOptionMenuItem::QStyleOptionMenuItem()
Crea un objeto `QStyleOptionMenuItem` e inicializa las variables de miembro con sus valores por defecto.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
Crea una copia de la opción de estilo « other ».
[noexcept default] QStyleOptionMenuItem &QStyleOptionMenuItem::operator=(const QStyleOptionMenuItem &)
Asigna por copia other a esta instancia de QStyleOptionMenuItem.
Documentación de las variables de miembro
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
Esta variable contiene el tipo de marca de selección del elemento del menú
El valor por defecto es « NotCheckable ».
Véase también « CheckType ».
bool QStyleOptionMenuItem::checked
Esta variable indica si la opción del menú está marcada o no
El valor por defecto es «false».
QFont QStyleOptionMenuItem::font
Esta variable contiene la fuente utilizada para el texto de las opciones del menú
Esta es la fuente que debe utilizarse para dibujar el texto del menú, sin incluir el atajo. El atajo suele dibujarse utilizando la fuente del pintor. Por defecto, se utiliza la fuente predeterminada de la aplicación.
QIcon QStyleOptionMenuItem::icon
Esta variable contiene el icono de la opción de menú
El valor por defecto es un icono vacío, es decir, un icono que no tiene ni mapa de píxeles ni nombre de archivo.
int QStyleOptionMenuItem::maxIconWidth
Esta variable contiene el ancho máximo del icono de la opción de menú
Se puede utilizar para dibujar el icono en el lugar correcto o para alinear adecuadamente los elementos. La variable debe establecerse independientemente de si el elemento del menú tiene o no un icono. El valor por defecto es 0.
bool QStyleOptionMenuItem::menuHasCheckableItems
Esta variable indica si el menú en su conjunto contiene elementos que se pueden marcar o no
El valor por defecto es «true».
Si esta opción se establece en «false», el menú no tendrá elementos que se puedan marcar. Esto permite que los estilos de la interfaz gráfica de usuario ahorren algo de espacio horizontal que, normalmente, se utilizaría para la columna de marcación.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
Esta variable contiene el tipo de elemento del menú
El valor por defecto es Normal.
Véase también « MenuItemType ».
QRect QStyleOptionMenuItem::menuRect
Esta variable contiene el rectángulo que abarca todo el menú
El valor por defecto es un rectángulo nulo, es decir, un rectángulo con el ancho y la altura establecidos en 0.
int QStyleOptionMenuItem::reservedShortcutWidth
Esta variable contiene el ancho reservado para el acceso directo del elemento del menú
QMenu y lo establece en el ancho que ocupa el acceso directo más ancho de entre todos los elementos visibles del menú.
El valor por defecto es 0.
QString QStyleOptionMenuItem::text
Esta variable contiene el texto de la opción del menú
Ten en cuenta que el formato del texto es similar a este: «Texto del menú\tAtajo».
Si la opción de menú no tiene atajo, solo contendrá el texto de la opción de menú. El valor por defecto es una cadena vacía.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.