MenuItem QML Type
Muestra un elemento dentro de un menú. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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 de conveniencia que implementa la API de AbstractButton, lo que ofrece una forma familiar de responder a elementos de menú que están en triggered, por ejemplo.
MenuItem hereda su API de AbstractButton. Por ejemplo, se puede establecer text e icon 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 flecha del submenú.
Esta propiedad se introdujo en QtQuick.Controls 2.3 (Qt 5.10).
Véase también Personalización del menú.
highlighted : bool
Esta propiedad indica si el usuario ha resaltado la opción del menú.
Un elemento del menú puede resaltarse al pasar el ratón por encima o mediante la navegación con el teclado.
El valor por defecto es « false ».
Véase también « Menu::currentIndex ».
implicitTextPadding : real [since 6.8]
Esta propiedad establece el espacio mínimo necesario desde el borde izquierdo del « 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 incluye este elemento de menú, o bien ` null ` si el elemento no se encuentra en ningún 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 elemento muestra en el menú principal, o bien null si este elemento no es un elemento 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 valor máximo de « implicitTextPadding » encontrado entre todos los elementos del menú dentro del mismo « menu ».
Esta propiedad puede utilizarse en el estilo para garantizar que todos los elementos de menú (MenuItems) dentro del mismo menú (Menu) queden alineados con respecto al valor de « text ».
Un « Menu » puede estar formado por muchos elementos de menú diferentes; algunos pueden ser marcables, otros pueden tener un icono y otros solo contendrán texto. Y, muy a menudo, un estilo quiere asegurarse de que el texto de todos ellos quede alineado a la izquierda (o a la derecha, en el caso de los elementos « mirrored »). Al permitir que cada elemento « MenuItem » asigne su propio relleno de texto mínimo a « implicitTextPadding » (teniendo en cuenta los iconos y las marcas de selección), pero utilizando «textPadding» para posicionar realmente el « text », todos los elementos «MenuItems» deberían quedar alineados
Para que esto funcione, todos los MenuItems deben 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 sobre señales
void triggered()
Esta señal se emite cuando el usuario activa la opción del menú.
Nota: El controlador correspondiente es onTriggered.
© 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.