MenuBar QML Type
Muestra una barra de menús en la ventana. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
Métodos
- void addMenu(Menu menu)
- void insertMenu(int index, Menu menu)
- Menu menuAt(int index)
- void removeMenu(Menu menu)
- Menu takeMenu(int index)
Descripción detallada

MenuBar está formada por menús desplegables y suele situarse en el borde superior de la ventana.
ApplicationWindow {
id: window
width: 320
height: 260
visible: true
menuBar: MenuBar {
Menu {
title: qsTr("&File")
Action { text: qsTr("&New...") }
Action { text: qsTr("&Open...") }
Action { text: qsTr("&Save") }
Action { text: qsTr("Save &As...") }
MenuSeparator { }
Action { text: qsTr("&Quit") }
}
Menu {
title: qsTr("&Edit")
Action { text: qsTr("Cu&t") }
Action { text: qsTr("&Copy") }
Action { text: qsTr("&Paste") }
}
Menu {
title: qsTr("&Help")
Action { text: qsTr("&About") }
}
}
}Por lo general, los menús se declaran de forma estática como elementos secundarios de la barra de menús, pero MenuBar también proporciona una API para « add », « insert », « remove » y « take » menús de forma dinámica. Se puede acceder a los menús de una barra de menús mediante « menuAt()».
Barras de menús nativas
Desde Qt 6.8, una MenuBar se implementa como una barra de menús nativa en macOS. Como resultado, todos los Menus, MenuItems y MenuBarItems dentro de una MenuBar también serán nativos. Aunque esto tiene la ventaja de que todo tendrá un aspecto nativo, también presenta el inconveniente de que los delegados establecidos en los controles mencionados no se utilizarán para la representación. Si no se desea una MenuBar nativa, se puede establecer QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar) para desactivarla.
Véase también «Personalización de la barra de menús», « Menu », « MenuBarItem », «Controles de menú» y «Gestión del foco en los controles de Qt Quick ».
Documentación de la propiedad
delegate : Component
Esta propiedad contiene el componente que se utiliza para crear elementos de la barra de menús con el fin de mostrar los menús en dicha barra.
MenuBar No asume la propiedad del delegado.
Véase también MenuBarItem.
menus : list<Menu>
Esta propiedad contiene la lista de menús.
La lista contiene todos los menús que se han declarado en QML como elementos secundarios de la barra de menús, así como los menús que se han añadido o insertado dinámicamente mediante los métodos addMenu() y insertMenu(), respectivamente.
Documentación de métodos
void addMenu(Menu menu)
Añade « menu » al final de la lista de menús.
void insertMenu(int index, Menu menu)
Incluye « menu » en index.
Menu menuAt(int index)
Devuelve el menú de index o, si no existe, el de null.
void removeMenu(Menu menu)
Elimina el objeto ` menu` especificado. Si el menú es ` open`, primero se convertirá en ` dismissed`. El objeto ` menu ` acabará siendo eliminado por el recolector de basura cuando la aplicación ya no mantenga ninguna referencia QML a él.
Menu takeMenu(int index)
Elimina y devuelve el menú en index. Si el menú está en open, primero pasará a estar en dismissed. El menú acabará siendo eliminado por el recolector de basura cuando la aplicación ya no mantenga ninguna referencia QML al mismo.
© 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.