MenuItemGroup QML Type
Un grupo para gestionar los elementos del menú nativo. Más...
| Import Statement: | import Qt.labs.platform |
| Inherits: |
Propiedades
- checkedItem : MenuItem
- enabled : bool
- exclusive : bool
- items : list<MenuItem>
- visible : bool
Señales
Métodos
- void addItem(MenuItem item)
- void clear()
- void removeItem(MenuItem item)
Descripción detallada
MenuItemGroup agrupa elementos de menú nativos.
MenuItemGroup es exclusivo por defecto. En un grupo de elementos de menú exclusivo, solo se puede marcar un elemento a la vez; al marcar otro elemento, el que estaba marcado anteriormente se desmarca automáticamente. MenuItemGroup se puede configurar como no exclusivo, lo cual resulta especialmente útil para mostrar, ocultar, activar y desactivar elementos de forma conjunta como un grupo.
La forma más sencilla de utilizar MenuItemGroup es asignarle una lista de elementos.
Menu {
id: verticalMenu
title: qsTr("Vertical")
MenuItemGroup {
id: verticalGroup
items: verticalMenu.items
}
MenuItem { text: qsTr("Top"); checkable: true }
MenuItem { text: qsTr("Center"); checked: true }
MenuItem { text: qsTr("Bottom"); checkable: true }
}En ocasiones, un mismo menú puede contener elementos que no deben incluirse en el mismo grupo exclusivo. Estos casos se gestionan mejor utilizando la propiedad ` group `.
Menu {
id: horizontalMenu
title: qsTr("Horizontal")
MenuItemGroup {
id: horizontalGroup
}
MenuItem {
checked: true
text: qsTr("Left")
group: horizontalGroup
}
MenuItem {
checkable: true
text: qsTr("Center")
group: horizontalGroup
}
MenuItem {
text: qsTr("Right")
checkable: true
group: horizontalGroup
}
MenuItem { separator: true }
MenuItem { text: qsTr("Justify"); checkable: true }
MenuItem { text: qsTr("Absolute"); checkable: true }
}Los casos de uso más avanzados pueden gestionarse mediante los métodos ` addItem()` y ` removeItem()`.
Nota: No se garantiza que los tipos de los módulos Qt.labs sigan siendo compatibles en futuras versiones.
Véase también ` MenuItem`.
Documentación de la propiedad
checkedItem : MenuItem
Esta propiedad contiene el elemento seleccionado actualmente en el grupo, o ` null ` si no hay ningún elemento seleccionado.
enabled : bool
Esta propiedad indica si el grupo está activado. El valor por defecto es « true ».
El estado de activación del grupo afecta al estado de activación de cada elemento del grupo, salvo en el caso de los elementos desactivados explícitamente, que no se activan aunque el grupo esté activado.
exclusive : bool
Esta propiedad indica si el grupo es exclusivo. El valor por defecto es « true ».
En un grupo de elementos de menú exclusivo, solo se puede marcar un elemento a la vez; al marcar otro elemento, el que estaba marcado anteriormente se desmarca automáticamente.
items : list<MenuItem>
Esta propiedad contiene la lista de elementos del grupo.
visible : bool
Esta propiedad indica si el grupo está visible. El valor por defecto es « true ».
La visibilidad del grupo afecta a la visibilidad de cada elemento del grupo, salvo en el caso de los elementos ocultos explícitamente, que no son visibles aunque el grupo sea visible.
Documentación de Signal
hovered(MenuItem item)
Esta señal se emite cuando el usuario pasa el cursor por encima de un item del grupo.
Nota: El controlador correspondiente es onHovered.
Véase también MenuItem::hovered().
triggered(MenuItem item)
Esta señal se emite cuando el usuario activa un « item » del grupo.
Nota: El controlador correspondiente es onTriggered.
Véase también MenuItem::triggered().
Documentación del método
void addItem(MenuItem item)
Añade un « item » al grupo.
void clear()
Elimina todos los elementos del grupo.
void removeItem(MenuItem item)
Elimina un « item » del grupo.
© 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.