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.labs モジュールに含まれる型は、将来のバージョンでも互換性が保たれることを保証するものではありません。

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 の状態を反対の状態に切り替えます。


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