MenuBar QML Type

ウィンドウ・メニュー・バーを提供します。詳細...

Import Statement: import QtQuick.Controls
Inherits:

Container

プロパティ

メソッド

詳細説明

MenuBarはドロップダウンメニューで構成され、通常ウィンドウの上端に配置される。

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

通常、メニューはメニューバーの子として静的に宣言されますが、MenuBar はaddinsertremovetake メニューへの API も動的に提供します。メニュー・バーのメニューにはmenuAt() を使ってアクセスできる。

ネイティブメニューバー

Qt 6.8以降、MenuBarはmacOSのネイティブメニューバーとして実装されています。その結果、MenuBar 内のすべての Menu、MenuItems、MenuBarItems もネイティブになります。これには、すべてがネイティブに見えるという利点がありますが、前述のコントロールに設定されたデリゲートがレンダリングに使用されないという欠点もあります。ネイティブのMenuBarが不要な場合は、QGuiApplication::setAttribute(Qt::AA_DontUseNativeMenuBar)

Qt Quick Controls のMenuBar のカスタマイズMenuMenuBarItemメニューコントロールフォーカス管理も参照してください

プロパティ Documentation

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

このプロパティは、コンテンツの高さを保持します。メニュー・バーの暗黙的な高さの合計を計算するために使用されます。

注: このプロパティは、QtQuick.Controls 2.3 (Qt 5.10) 以降MenuBar で利用可能ですが、QtQuick.Controls 2.5 (Qt 5.12) で Container 基本型に昇格しました。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

Container::contentHeightも参照してください


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

このプロパティは、コンテンツの幅を保持します。メニュー・バーの暗黙的な幅の合計を計算するために使用されます。

注: このプロパティは、QtQuick.Controls 2.3 (Qt 5.10) 以降、MenuBar で使用できますが、QtQuick.Controls 2.5 (Qt 5.12) で Container 基本型に昇格しました。

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

Container::contentWidthも参照してください


delegate : Component

このプロパティは、メニューバーにメニューを表示するためのメニューバーアイテムを作成するために使用されるコンポーネントを保持します。

MenuBarItem参照して ください。


このプロパティは、メニューのリストを保持します。

このリストには、メニューバーの子メニューとして QML で宣言されたすべてのメニューと、addMenu() メソッドおよびinsertMenu() メソッドをそれぞれ使用して動的に追加または挿入されたメニューが含まれます。


メソッドの説明

void addMenu(Menu menu)

menu をメニューリストの最後に追加します。


void insertMenu(int index, Menu menu)

indexmenu を挿入します。


index 、または存在しない場合はnull にメニューを返します。


void removeMenu(Menu menu)

指定されたmenu を削除する。メニューがopen の場合、最初にdismissed になる。menu は、アプリケーションから QML への参照がなくなると、ガベージコレクタによって削除されます。


Menu takeMenu(int index)

index のメニューを削除して返す。メニューがopen の場合、まずdismissed になります。メニューは最終的にガベージコレクタによって削除されます。


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。