En esta página

MenuBar QML Type

Muestra una barra de menús en la ventana. Más...

Import Statement: import QtQuick.Controls
Inherits:

Container

Propiedades

Métodos

Descripción detallada

Barra de menús con los menús «Archivo», «Edición» y «Ver»

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.

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.

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.