MenuBar QML Type

Bietet eine Fenster-Menüleiste. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• delegate : Component
• menus : list<Menu>

Methoden

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

Ausführliche Beschreibung

MenuBar besteht aus Dropdown-Menüs und befindet sich normalerweise am oberen Rand des Fensters.

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

Normalerweise werden Menüs statisch als Kinder der Menüleiste deklariert, aber MenuBar bietet auch eine dynamische API für die Menüs add, insert, remove und take. Auf die Menüs in einer Menüleiste kann mit menuAt() zugegriffen werden.

Native Menüleisten

Seit Qt 6.8 ist eine MenuBar als native Menüleiste unter macOS implementiert. Das hat zur Folge, dass alle Menüs, MenuItems und MenuBarItems innerhalb einer MenuBar auch nativ sein werden. Dies hat zwar den Vorteil, dass alles nativ aussieht, aber auch den Nachteil, dass die Delegaten, die auf den genannten Steuerelementen gesetzt sind, nicht für das Rendering verwendet werden. Wenn eine native MenuBar nicht erwünscht ist, können Sie sie unter QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar) deaktivieren.

Siehe auch Customizing MenuBar, Menu, MenuBarItem, Menu Controls, und Focus Management in Qt Quick Controls.

Eigenschaft Dokumentation

delegate : Component

Diese Eigenschaft enthält die Komponente, die zum Erstellen von Menüleistenelementen verwendet wird, um Menüs in der Menüleiste darzustellen.

MenuBar übernimmt nicht die Verantwortung für den Delegaten.

Siehe auch MenuBarItem.

menus : list<Menu>

Diese Eigenschaft enthält die Liste der Menüs.

Die Liste enthält alle Menüs, die in QML als Kinder der Menüleiste deklariert wurden, sowie Menüs, die mit den Methoden addMenu() und insertMenu() dynamisch hinzugefügt oder eingefügt wurden.

Dokumentation der Methode

void addMenu(Menu menu)

Fügt menu am Ende der Liste der Menüs hinzu.

void insertMenu(int index, Menu menu)

Inserate menu unter index.

Menu menuAt(int index)

Gibt das Menü unter index zurück, oder null, wenn es nicht existiert.

void removeMenu(Menu menu)

Entfernt die angegebene menu. Wenn das Menü open ist, wird es zunächst dismissed. menu wird schließlich vom Garbage Collector gelöscht, wenn die Anwendung keine QML-Verweise mehr darauf enthält.

Menu takeMenu(int index)

Entfernt das Menü und gibt es unter index zurück. Wenn das Menü open ist, wird es zunächst dismissed sein. Das Menü wird schließlich vom Garbage Collector gelöscht, wenn die Anwendung keine QML-Verweise mehr darauf enthält.