MenuBar QML Type
Fournit une barre de menu pour la fenêtre. Plus d'informations...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propriétés
- contentHeight : real
(since QtQuick.Controls 2.3 (Qt 5.10)) - contentWidth : real
(since QtQuick.Controls 2.3 (Qt 5.10)) - 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") } } } }
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 |
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 |
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 removeMenu(Menu 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.