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.lab モジュールの型は、将来のバージョンでも互換性が保たれることを保証するものではありません。
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 の状態をその反対の状態に切り替えます。
© 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.