MenuItem QML Type
ネイティブメニュー。もっと見る...
Import Statement: | import Qt.labs.platform |
Inherits: | |
Inherited By: |
プロパティ
- 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))
- icon.mask : bool
- menu : Menu
- role : enumeration
- separator : bool
- shortcut : keysequence
- subMenu : Menu
- text : string
- visible : bool
シグナル
メソッド
- 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() } }
注意: Qt.labs モジュールに含まれる型は、将来のバージョンでも互換性が保たれることを保証するものではありません。
Menu およびMenuItemGroupも参照して ください。
プロパティ Documentation
checkable : bool |
このプロパティは、アイテムがチェック可能かどうかを保持します。
チェック可能なメニュー項目には、オン/オフの状態があります。例えば、ワープロでは、"Bold "メニュー項目はオンかオフのどちらかである。チェック可能でないメニュー項目は、単純に実行されるコマンド項目である。
デフォルト値はfalse
です。
checked およびMenuItemGroupも参照のこと 。
checked : bool |
このプロパティは、項目がチェックされているか(オン)、チェックされていないか(オフ)を保持します。デフォルト値はfalse
です。
checkable およびMenuItemGroup も参照して ください。
enabled : bool |
このプロパティは、項目が有効かどうかを保持します。デフォルト値はtrue
です。
無効なアイテムは、ユーザーによってトリガーされることはありません。メニューから消えることはありませんが、利用できないことを示す方法で表示されます。例えば、灰色の濃淡のみで表示される。
項目が無効になっている場合、shortcut を使ってトリガーすることはできない。
group : MenuItemGroup |
このプロパティは、項目が属しているグループを保持し、項目がグループに属していない場合はnull
を保持する。
このプロパティはメニュー項目のアイコンを保持する。
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()も参照して下さい 。
menu : Menu |
このプロパティは、アイテムが属するメニューを保持します。アイテムがメニューにない場合は、null
。
role : enumeration |
このプロパティは、項目の役割を保持する。roleは、macOSのアプリケーションメニューに項目を配置するかどうかを決定します。
利用可能な値
定数 | 説明 |
---|---|
MenuItem.NoRole | 項目はアプリケーションメニューに置かれるべきではありません。 |
MenuItem.TextHeuristicRole | 項目は、アクションのテキストに基づいてアプリケーションメニューに配置されるべきである(デフォルト) |
MenuItem.ApplicationSpecificRole | 項目は、アプリケーション固有の役割を持ってアプリケーションメニューに置かれるべきです。 |
MenuItem.AboutQtRole | Qt について」メニュー項目を扱います。 |
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 }
subMenu : Menu |
このプロパティは、項目が含むサブメニューを保持し、項目がサブメニュー項目でない場合は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.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。