MenuBar QML Type

Fournit une barre de menu pour la fenêtre. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• delegate : Component
• menus : list<Menu>

Méthodes

• void addMenu(Menu menu)
• void insertMenu(int index, Menu menu)
• Menu menuAt(int index)
• void removeMenu(Menu menu)
• Menu takeMenu(int index)

Description détaillée

MenuBar se compose de menus déroulants et se trouve normalement sur le bord supérieur de la fenêtre.

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") }
        }
    }
}

En règle générale, les menus sont déclarés de manière statique en tant qu'enfants de la barre de menus, mais MenuBar fournit également une API pour les menus add, insert, remove, et take de manière dynamique. Les menus d'une barre de menus sont accessibles à l'aide de menuAt().

Barres de menu natives

Depuis Qt 6.8, une MenuBar est implémentée comme une barre de menu native sur macOS. Par conséquent, tous les menus, éléments de menu et éléments de barre de menu d'une barre de menu seront également natifs. Si cela présente l'avantage de donner un aspect natif à l'ensemble, cela présente également l'inconvénient que les délégués définis sur les contrôles mentionnés ne seront pas utilisés pour le rendu. Si vous ne voulez pas d'une barre de menu native, vous pouvez définir QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar) pour la désactiver.

Voir aussi Personnaliser la barre de menu, Menu, MenuBarItem, Contrôles de menu, et Gestion du focus dans les contrôles Qt Quick .

Documentation sur les propriétés

delegate : Component

Cette propriété contient le composant utilisé pour créer des éléments de barre de menu afin de présenter des menus dans la barre de menu.

MenuBar n'est pas propriétaire du délégué.

Voir aussi MenuBarItem.

menus : list<Menu>

Cette propriété contient la liste des menus.

La liste contient tous les menus qui ont été déclarés en QML comme enfants de la barre de menus, ainsi que les menus qui ont été ajoutés ou insérés dynamiquement à l'aide des méthodes addMenu() et insertMenu(), respectivement.

Documentation de la méthode

void addMenu(Menu menu)

Ajoute menu à la fin de la liste des menus.

void insertMenu(int index, Menu menu)

Insère menu à index.

Menu menuAt(int index)

Renvoie le menu à index, ou null s'il n'existe pas.

void removeMenu(Menu menu)

Supprime le menu spécifié menu. Si le menu est open, il sera d'abord dismissed. Le site menu sera finalement supprimé par le ramasse-miettes lorsque l'application ne contiendra plus de références QML à ce site.

Menu takeMenu(int index)

Supprime et renvoie le menu à index. Si le menu est open, il sera d'abord dismissed. Le menu sera finalement supprimé par le ramasse-miettes lorsque l'application ne contiendra plus de références QML vers lui.