MenuItem QML Type

ネイティブメニュー。もっと見る...

Import Statement: import Qt.labs.platform
Inherits:

QtObject

Inherited By:

MenuSeparator

プロパティ

信号

方法

詳細な説明

MenuItem型はネイティブプラットフォームのメニュー項目のためのQML APIを提供する。

メニューアイテムはicontextshortcut から構成されます。

Menu {
    id: zoomMenu

    MenuItem {
        text: qsTr("Zoom In")
        shortcut: StandardKey.ZoomIn
        onTriggered: zoomIn()
    }

    MenuItem {
        text: qsTr("Zoom Out")
        shortcut: StandardKey.ZoomOut
        onTriggered: zoomOut()
    }
}

注意: Qt.lab モジュールの型は、将来のバージョンでも互換性が保たれることを保証するものではありません。

Menu およびMenuItemGroupも参照して ください。

プロパティ Documentation

checkable : bool

このプロパティは、アイテムがチェック可能かどうかを保持します。

チェック可能なメニュー項目には、オン/オフの状態があります。例えば、ワープロでは、"Bold "メニュー項目はオンかオフのどちらかである。チェック可能でないメニュー項目は、単純に実行されるコマンド項目である。

デフォルト値はfalse です。

checked およびMenuItemGroupも参照のこと


checked : bool

このプロパティは、項目がチェックされているか(オン)、チェックされていないか(オフ)を保持します。デフ ォル ト 値はfalse です。

checkable およびMenuItemGroup参照して ください。


enabled : bool

このプロパティは、項目が有効かどうかを保持します。デフォルト値はtrue です。

無効なアイテムは、ユーザーによってトリガーされることはありません。メニューから消えることはありませんが、利用できないことを示す方法で表示されます。例えば、灰色の濃淡のみで表示される。

項目が無効になっている場合、shortcut を使ってトリガーすることはできない。


font : font

このプロパティはメニュー項目のフォントを保持する。

textも参照


group : MenuItemGroup

このプロパティは、その項目が属するグループを保持し、その項目がグループに属していない場合はnull を保持する。


icon group

icon.mask : bool [since Qt.labs.platform 1.1 (Qt 5.12)]

icon.name : string [since Qt.labs.platform 1.1 (Qt 5.12)]

icon.source : url [since Qt.labs.platform 1.1 (Qt 5.12)]

このプロパティはメニュー項目のアイコンを保持する。

MenuItem {
    icon.mask: true
    icon.name: "edit-undo"
    icon.source: "qrc:/images/undo.png"
}

この QML プロパティは、Qt.labs.platform 1.1 (Qt 5.12) で導入されました。

QIcon::fromTheme()も参照して下さい


このプロパティは、アイテムが属するメニューを保持します。アイテムがメニューにない場合は、null


role : enumeration

このプロパティは、項目の役割を保持する。roleは、macOSのアプリケーションメニューに項目を配置するかどうかを決定します。

利用可能な値

定数説明
MenuItem.NoRole項目はアプリケーションメニューに置かれるべきではありません。
MenuItem.TextHeuristicRole項目は、アクションのテキストに基づいてアプリケーションメニューに配置されるべきである(デフォルト)
MenuItem.ApplicationSpecificRole項目は、アプリケーション固有の役割を持つアプリケーションメニューに置かれるべきです。
MenuItem.AboutQtRoleQt について」メニュー項目を扱います。
MenuItem.AboutRoleこの項目は、アプリケーションメニューの "About "メニュー項目がある場所に置かれるべきです。メニュー項目のテキストは "About <アプリケーション名>"に設定されます。アプリケーション名は、アプリケーションのバンドルにあるInfo.plist ファイルから取得します(Qt for macOS - Deployment を参照してください)。
MenuItem.PreferencesRoleこの項目は、アプリケーションメニューの "Preferences..." メニュー項目に配置します。
MenuItem.QuitRoleアプリケーションメニューの "Quit "メニュー項目のある場所に配置します。

ロールの指定は、メニューバーのサブメニューではなく、メニューバーの直接のメニューにある項目に対してのみ有効です。例えば、メニューバーに「ファイル」メニューがあり、「ファイル」メニューにサブメニューがある場合、そのサブメニューの項目にロールを指定しても効果はありません。それらは決してアプリケーションメニューに移動されることはない。


separator : bool

このプロパティは、項目が区切り線であるかどうかを保持します。デフォルト値はfalse です。

MenuSeparatorも参照のこと


shortcut : keysequence

このプロパティはメニュー項目のショートカットを保持する。

ショートカットキーシーケンスは、standard keyboard shortcuts のいずれかに設定するか、またはtrigger に必要な最大4つのキー押下シーケンスを含む文字列で指定することができる。

デフォルト値は空のキー配列である。

MenuItem {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

このプロパティは、項目が含むサブメニューを保持し、項目がサブメニュー項目でない場合はnull を保持する。


text : string

このプロパティは、メニュー項目のテキストを保持する。


visible : bool

このプロパティは、項目が表示可能かどうかを保持する。デフォルト値はtrue である。


シグナル

hovered()

このシグナルは、メニュー項目がユーザーによってホバーされたときに発せられる。

注: 対応するハンドラはonHovered です。


triggered()

このシグナルはメニュー項目がユーザーによってトリガーされたときに発せられる。

注: 対応するハンドラはonTriggered です。


メソッドの説明

void toggle()

checked の状態をその反対の状態に切り替えます。


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