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