MenuBar QML Type

Proporciona una barra de menú de ventana. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• delegate : Component
• menus : list<Menu>

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 se compone de menús desplegables, y normalmente se encuentra 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") }
        }
    }
}

Normalmente, los menús se declaran estáticamente como hijos de la barra de menús, pero MenuBar también proporciona API a los menús add, insert, remove, y take dinámicamente. Se puede acceder a los menús de una barra de menús mediante menuAt().

Barras de menú nativas

Desde Qt 6.8, una MenuBar se implementa como una barra de menú nativa en macOS. Como resultado, todos los Menús, 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 tiene la desventaja de que los delegados establecidos en los controles mencionados no se utilizarán para el renderizado. Si no se desea una MenuBar nativa, se puede configurar QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar) para desactivarla.

Ver también Personalizar MenuBar, Menu, MenuBarItem, Controles de Menú, y Gestión de Foco en Qt Quick Controls.

Documentación de Propiedades

delegate : Component

Esta propiedad contiene el componente que se utiliza para crear los elementos de la barra de menús para presentar los menús en la barra de menús.

MenuBar no toma 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 han sido declarados en QML como hijos de la barra de menús, y también los menús que han sido añadidos o insertados dinámicamente utilizando los métodos addMenu() y insertMenu(), respectivamente.

Documentación del método

void addMenu(Menu menu)

Añade menu al final de la lista de menús.

void insertMenu(int index, Menu menu)

Inserta menu en index.

Menu menuAt(int index)

Devuelve el menú en index, o null si no existe.

void removeMenu(Menu menu)

Elimina la dirección menu especificada. Si el menú es open, primero será dismissed. El menu será eventualmente eliminado por el recolector de basura cuando la aplicación ya no mantenga ninguna referencia QML al mismo.

Menu takeMenu(int index)

Elimina y devuelve el menú en index. Si el menú es open, primero será dismissed. El menú será finalmente eliminado por el recolector de basura cuando la aplicación ya no contenga referencias QML al mismo.