MenuBar QML Type

Stellt eine Fenster-Menüleiste bereit. 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

Die Menüleiste 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") }
        }
    }
}

In der Regel werden Menüs statisch als untergeordnete Elemente der Menüleiste deklariert, aber MenuBar bietet auch eine API, um Menüs dynamisch zu „ add “, „ insert “, „ remove “ und „ take “ zu erstellen. Auf die Menüs in einer Menüleiste kann mit der Funktion „ menuAt()“ zugegriffen werden.

Native Menüleisten

Seit Qt 6.8 wird eine MenuBar unter macOS als native Menüleiste implementiert. Daher sind auch alle Menüs, MenuItems und MenuBarItems innerhalb einer MenuBar nativ. Dies hat zwar den Vorteil, dass alles nativ aussieht, birgt jedoch auch den Nachteil, dass die für die genannten Steuerelemente festgelegten Delegaten nicht für die Darstellung verwendet werden. Wenn eine native MenuBar nicht gewünscht ist, können Sie „ QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar) “ setzen, um sie zu deaktivieren.

Siehe auch „Anpassen der Menüleiste“, „ Menu “, „ MenuBarItem “, „Menüsteuerelemente“ und „Fokusverwaltung“ unter Qt Quick Controls.

Dokumentation zu den Eigenschaften

delegate : Component

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

MenuBar Übernimmt nicht die Eigentümerschaft des 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 untergeordnete Elemente der Menüleiste deklariert wurden, sowie Menüs, die dynamisch hinzugefügt bzw. eingefügt wurden, und zwar mithilfe der Methoden „ addMenu()“ und „ insertMenu()“.

Methodendokumentation

void addMenu(Menu menu)

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

void insertMenu(int index, Menu menu)

Fügt menu unter index ein.

Menu menuAt(int index)

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

void removeMenu(Menu menu)

Entfernt das angegebene „ menu “. Wenn das Menü „ open “ lautet, wird zunächst „ dismissed “ erstellt. Das „ menu “ wird schließlich vom Garbage Collector gelöscht, sobald die Anwendung keine QML-Referenzen mehr darauf hält.

Menu takeMenu(int index)

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