MenuBar QML Type

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

Import Statement: import QtQuick.Controls
Inherits:

Container

Propriétés

Méthodes

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

Généralement, les menus sont déclarés statiquement comme enfants de la barre de menus, mais MenuBar fournit également une API pour les menus add, insert, remove, et take dynamiquement. 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 Qt Quick Controls.

Propriété Documentation

contentHeight : real [since QtQuick.Controls 2.3 (Qt 5.10)]

Cette propriété contient la hauteur du contenu. Elle est utilisée pour calculer la hauteur totale implicite de la barre de menus.

Remarque : cette propriété est disponible dans MenuBar depuis QtQuick.Controls 2.3 (Qt 5.10), mais elle a été promue au type de base Container dans QtQuick.Controls 2.5 (Qt 5.12).

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir également Container::contentHeight.


contentWidth : real [since QtQuick.Controls 2.3 (Qt 5.10)]

Cette propriété contient la largeur du contenu. Elle est utilisée pour calculer la largeur totale implicite de la barre de menu.

Remarque : cette propriété est disponible dans MenuBar depuis QtQuick.Controls 2.3 (Qt 5.10), mais elle a été promue au type de base Container dans QtQuick.Controls 2.5 (Qt 5.12).

Cette propriété a été introduite dans QtQuick.Controls 2.3 (Qt 5.10).

Voir également Container::contentWidth.


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.

Voir également MenuBarItem.


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 à l'adresse 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. L'adresse menu sera finalement supprimée par le ramasse-miettes lorsque l'application ne contiendra plus de références QML à cette adresse.


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 à ce menu.


© 2025 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.