MenuItem QML Type

Presenta un elemento dentro de un Menú. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• arrow : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• highlighted : bool
• implicitTextPadding : real (since 6.8)
• menu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
• subMenu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
• textPadding : real (since 6.8)

Señales

• void triggered()

Descripción detallada

MenuItem es un tipo conveniente que implementa la API AbstractButton, proporcionando una forma familiar de responder a los elementos de menú que se triggered, por ejemplo.

MenuItem hereda su API de AbstractButton. Por ejemplo, puede configurar text y el icono utilizando la API AbstractButton.

Button {
    id: fileButton
    text: "File"
    onClicked: menu.open()

    Menu {
        id: menu

        MenuItem {
            text: "New..."
            onTriggered: document.reset()
        }
        MenuItem {
            text: "Open..."
            onTriggered: openDialog.open()
        }
        MenuItem {
            text: "Save"
            onTriggered: saveDialog.open()
        }
    }
}

Véase también Personalización del menú, Menu, y Controles de menú.

Documentación de propiedades

arrow : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad contiene el elemento de la flecha del submenú.

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

Ver también Personalizar Menú.

highlighted : bool

Esta propiedad indica si el elemento de menú está resaltado por el usuario.

Un elemento de menú puede ser resaltado al pasar el ratón por encima o al navegar con el teclado.

El valor por defecto es false.

Véase también Menu::currentIndex.

implicitTextPadding : real [since 6.8]

Esta propiedad contiene el espacio mínimo necesario desde el borde izquierdo de contentItem hasta el texto. Se utiliza para calcular un textPadding común entre todos los MenuItems dentro de un Menu.

Esta propiedad se introdujo en Qt 6.8.

Véase también textPadding.

menu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad contiene el menú que contiene este elemento de menú, o null si el elemento no está en un menú.

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

subMenu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

Esta propiedad contiene el submenú que este ítem presenta en el menú padre, o null si este ítem no es un ítem de submenú.

Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).

textPadding : real [read-only, since 6.8]

Esta propiedad contiene el máximo implicitTextPadding encontrado entre todos los elementos de menú dentro del mismo menu.

Esta propiedad puede ser utilizada por el estilo para asegurar que todos los elementos de menú dentro del mismo menú terminan alineados con respecto a text.

Un Menu puede constar de muchos elementos de menú diferentes, algunos pueden ser comprobables, otros pueden tener un icono y otros sólo contendrán texto. Y muy a menudo, un estilo quiere asegurarse de que el texto dentro de todos ellos termina alineado a la izquierda (o alineado a la derecha para los elementos mirrored ). Dejando que cada MenuItem asigne su propio relleno de texto mínimo a implicitTextPadding (teniendo en cuenta los iconos y las marcas de verificación), pero utilizando textPadding para posicionar realmente el text, todos los MenuItems deberían acabar alineados.

Para que esto funcione, todos los MenuItems deberían establecer implicitTextPadding como el espacio mínimo necesario desde el borde izquierdo de contentItem hasta el texto.

Esta propiedad se introdujo en Qt 6.8.

Véase también implicitTextPadding.

Documentación de señales

void triggered()

Esta señal se emite cuando el elemento de menú es activado por el usuario.