Back to Qt.io
Contact Us Blog Download Qt

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はadd 、insert 、remove 、take メニューへのAPIも動的に提供する。メニュー・バーのメニューにはmenuAt() を使ってアクセスできる。

ネイティブメニューバー

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

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

プロパティ 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)

index にmenu を挿入します。


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


void removeMenu(Menu menu)

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


Menu takeMenu(int index)

index のメニューを削除して返す。メニューがopen の場合、まずdismissed になります。このメニューは、アプリケーションが QML の参照を保持しなくなった時点で、ガベージコレクタによって削除されます。


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