QStyleOptionMenuItem Class
La clase QStyleOptionMenuItem se utiliza para describir los parámetros necesarios para dibujar un elemento de menú. Más...
| Cabecera: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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) |
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 las funciones QStyle necesitan para dibujar los elementos de menú de QMenu. También se utiliza para dibujar otros widgets relacionados con el menú.
Por razones de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, utilizando el operador . o -> ). Esto hace que las estructuras sean sencillas de utilizar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.
Véase también QStyleOption.
Documentación de los tipos miembros
enum QStyleOptionMenuItem::CheckType
Este enum se utiliza para indicar si debe dibujarse o no una marca de verificación para el elemento, o incluso si debe dibujarse en absoluto.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionMenuItem::NotCheckable | 0 | El elemento no se puede marcar. |
QStyleOptionMenuItem::Exclusive | 1 | El elemento es un elemento de verificación exclusiva (como un botón de radio). |
QStyleOptionMenuItem::NonExclusive | 2 | El elemento es no exclusivo (como una casilla de verificación). |
Véase también checkType, QAction::checkable, QAction::checked, y QActionGroup::exclusionPolicy.
enum QStyleOptionMenuItem::MenuItemType
Este enum indica el tipo de elemento de menú que describe la estructura.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionMenuItem::Normal | 0 | Un elemento de menú normal. |
QStyleOptionMenuItem::DefaultItem | 1 | Un elemento de menú que es la acción por defecto especificada 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 desplazador de menú emergente (actualmente sólo se utiliza en macOS). |
QStyleOptionMenuItem::TearOff | 5 | Un asa de corte para el menú. |
QStyleOptionMenuItem::Margin | 6 | Obsoleto y no utilizado. El margen del menú. |
QStyleOptionMenuItem::EmptyArea | 7 | El área vacía del menú. |
Véase también menuItemType.
enum QStyleOptionMenuItem::StyleOptionType
Este enum se utiliza para guardar 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 es utilizado internamente por QStyleOption, sus subclases y qstyleoption_cast() para determinar el tipo de opción de estilo. En general no necesitas preocuparte por esto a menos que quieras crear tu propia subclase QStyleOption y tus propios estilos.
Véase también StyleOptionVersion.
enum QStyleOptionMenuItem::StyleOptionVersion
Este enum se utiliza para guardar 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 |
La versión es utilizada por las subclases de QStyleOption para implementar extensiones sin romper la compatibilidad. Si utiliza qstyleoption_cast(), normalmente no necesita comprobarla.
Véase también StyleOptionType.
Documentación de funciones miembro
QStyleOptionMenuItem::QStyleOptionMenuItem()
Construye un QStyleOptionMenuItem, inicializando las variables miembros a sus valores por defecto.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
Construye una copia de la opción de estilo other.
Documentación de la variable miembro
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
Esta variable contiene el tipo de marca de verificación del elemento de menú
El valor por defecto es NotCheckable.
Véase también CheckType.
bool QStyleOptionMenuItem::checked
Esta variable indica si el elemento del menú está marcado o no.
El valor por defecto es false.
QFont QStyleOptionMenuItem::font
Esta variable contiene la fuente utilizada para el texto del elemento de menú
Esta es la fuente que se debe utilizar para dibujar el texto del menú menos el acceso directo. El acceso directo se suele dibujar utilizando la fuente del pintor. Por defecto, se utiliza la fuente por defecto de la aplicación.
QIcon QStyleOptionMenuItem::icon
Esta variable contiene el icono del elemento de menú
El valor por defecto es un icono vacío, es decir, un icono sin mapa de píxeles ni nombre de archivo.
int QStyleOptionMenuItem::maxIconWidth
Esta variable contiene la anchura máxima del icono en el elemento de menú.
Puede utilizarse para dibujar el icono en el lugar correcto o para alinear correctamente los elementos. La variable debe estar definida independientemente de si el elemento de menú tiene o no un icono. El valor por defecto es 0.
bool QStyleOptionMenuItem::menuHasCheckableItems
Esta variable mantiene si el menú en su conjunto tiene elementos comprobables o no.
El valor por defecto es true.
Si esta opción es falsa, entonces el menú no tiene elementos seleccionables. Esto hace posible que los estilos GUI ahorren algo de espacio horizontal que normalmente se utilizaría para la columna de comprobación.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
Esta variable contiene el tipo de elemento de menú
El valor por defecto es Normal.
Véase también MenuItemType.
QRect QStyleOptionMenuItem::menuRect
Esta variable contiene el rectángulo de todo el menú.
El valor por defecto es un rectángulo nulo, es decir, un rectángulo con la anchura y la altura fijadas en 0.
int QStyleOptionMenuItem::reservedShortcutWidth
Esta variable contiene la anchura reservada para el acceso directo del elemento de menú
QMenu la establece en la anchura ocupada por el acceso directo más ancho entre todos los elementos visibles del menú.
El valor por defecto es 0.
QString QStyleOptionMenuItem::text
Esta variable contiene el texto del elemento de menú
Tenga en cuenta que el formato del texto es algo así "Texto del menú\tAcceso directo".
Si el elemento de menú no tiene un acceso directo, sólo contendrá el texto del elemento 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.
