MenuItem QML Type

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

• 継承されたメンバーを含む全メンバーのリスト

プロパティ

• checkable : bool
• checked : bool
• enabled : bool
• font : font
• group : MenuItemGroup
• icon (since Qt.labs.platform 1.1 (Qt 5.12))
  • 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))
• menu : Menu
• role : enumeration
• separator : bool
• shortcut : keysequence
• subMenu : Menu
• text : string
• visible : bool

信号

• hovered()
• triggered()

方法

• void toggle()

詳細な説明

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

メニューアイテムはicon 、text 、shortcut から構成されます。

Menu {
    id: zoomMenu

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

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

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

プロパティのドキュメント

checkable : bool

このプロパティは、項目がチェック可能かどうかを保持する。

チェック可能なメニュー項目は、オン／オフの状態を持つ。例えば、ワープロの「太字」メニュー項目はオンかオフのどちらかである。チェック可能でないメニュー項目は、単純に実行されるコマンド項目である。

デフォルト値はfalse です。

checked およびMenuItemGroupも参照のこと 。

checked : bool

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

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

enabled : bool

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

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

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

font : font

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

textも参照 。

group : MenuItemGroup

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

icon group

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

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

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

QIcon::fromTheme()も参照してください 。

menu : Menu [read-only]

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

role : enumeration

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

利用可能な値

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

separator : bool

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

MenuSeparatorも参照してください 。

shortcut : keysequence

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

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

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

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

subMenu : Menu [read-only]

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

text : string

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

visible : bool

このプロパティは、アイテムが可視であるかどうかを保持する。デフォルト値はtrue です。

シグナル・ドキュメント

hovered()

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

triggered()

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

メソッドのドキュメント

void toggle()

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