MenuItem QML Type
メニュー内の項目を表示します。詳細...
Import Statement: | import QtQuick.Controls |
Inherits: |
プロパティ
- arrow : Item
(since QtQuick.Controls 2.3 (Qt 5.10))
- highlighted : bool
- implicitTextPadding : bool
(since 6.8)
- menu : Menu
(since QtQuick.Controls 2.3 (Qt 5.10))
- subMenu : Menu
(since QtQuick.Controls 2.3 (Qt 5.10))
- textPadding : bool
(since 6.8)
信号
- void triggered()
詳細説明
MenuItem はAbstractButton API を実装した便利な型であり、例えばメニューアイテムがtriggered になったときに対応するための使い慣れた方法を提供する。
MenuItem はその API をAbstractButton から継承しています。例えば、AbstractButton API を使ってtext やアイコンを設定することができます。
Button { id: fileButton text: "File" onClicked: menu.open() Menu { id: menu MenuItem { text: "New..." onTriggered: document.reset() } MenuItem { text: "Open..." onTriggered: openDialog.open() } MenuItem { text: "Save" onTriggered: saveDialog.open() } } }
関連項目: メニューのカスタマイズ、Menu 、メニュー・コントロール。
プロパティ Documentation
arrow : Item |
このプロパティは、サブメニューの矢印アイテムを保持します。
このプロパティは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。
メニューのカスタマイズ」も参照してください 。
highlighted : bool |
このプロパティは、メニュー項目がユーザーによってハイライトされているかどうかを保持します。
メニュー項目は、マウスホバーやキーボードナビゲーションによってハイライトされます。
デフォルト値はfalse
です。
Menu::currentIndexも参照して ください。
implicitTextPadding : bool |
このプロパティは、contentItem の左端からテキストまでに必要な最小スペースを保持します。このプロパティは、Menu 内のすべての MenuItem に共通するtextPadding を計算するために使用されます。
このプロパティは Qt 6.8 で導入されました。
textPaddingも参照してください 。
menu : Menu |
このプロパティは、このメニュー項目を含むメニューを保持し、項目がメニューにない場合はnull
を保持する。
このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。
subMenu : Menu |
このプロパティは、このアイテムが親メニューで表示するサブメニューを保持します。このアイテムがサブメニューでない場合は、null
。
このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。
textPadding : bool |
このプロパティは、同じmenu 内のすべてのメニュー項目の中で見つかった最大のimplicitTextPadding を保持します。
このプロパティをスタイルで使用すると、同じメニュー内のすべての MenuItems がtext に対して整列されます。
Menu 、チェック可能なもの、アイコンを持つもの、テキストを含むものなど、様々なMenuItemから構成されます。そして、スタイルでは、それらのすべてのテキストが左揃え(またはmirrored アイテムについては右揃え)で表示されるようにすることがよくあります。各MenuItem がimplicitTextPadding に独自の最小テキスト パディングを割り当て(アイコンとチェックマークを考慮)、textPadding を使用して実際にtext を配置することで、すべての MenuItems が揃うようになります。
これが機能するためには、すべての MenuItems はcontentItem の左端からテキストまで必要な最小スペースをimplicitTextPadding に設定する必要があります。
このプロパティは Qt 6.8 で導入されました。
implicitTextPaddingも参照してください 。
シグナル・ドキュメント
void triggered() |
このシグナルは、メニューアイテムがユーザーによってトリガーされたときに発せられます。
注: 対応するハンドラはonTriggered
です。
© 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.