En esta página

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:

QStyleOptionMenuItemV2

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.

ConstanteValorDescripción
QStyleOptionMenuItem::NotCheckable0El elemento no se puede marcar.
QStyleOptionMenuItem::Exclusive1El elemento es un elemento de selección exclusiva (como un botón de opción).
QStyleOptionMenuItem::NonExclusive2El 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.

Esta enumeración indica el tipo de elemento de menú que describe la estructura.

ConstanteValorDescripción
QStyleOptionMenuItem::Normal0Una opción de menú normal.
QStyleOptionMenuItem::DefaultItem1Un elemento de menú que es la acción predeterminada, tal y como se especifica con ` QMenu::defaultAction()`.
QStyleOptionMenuItem::Separator2Un separador de menú.
QStyleOptionMenuItem::SubMenu3Indica que el elemento de menú apunta a un submenú.
QStyleOptionMenuItem::Scroller4Un control de desplazamiento del menú emergente (actualmente solo se utiliza en macOS).
QStyleOptionMenuItem::TearOff5Un controlador de separación para el menú.
QStyleOptionMenuItem::Margin6Obsoleto y sin uso. El margen del menú.
QStyleOptionMenuItem::EmptyAreaTearOff + 2El á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 `.

ConstanteValorDescripción
QStyleOptionMenuItem::TypeSO_MenuItemEl 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 `.

ConstanteValorDescripción
QStyleOptionMenuItem::Version11

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.

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.

Esta variable contiene el tipo de elemento del menú

El valor por defecto es Normal.

Véase también « MenuItemType ».

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.