MenuItem QML Type

メニュー内の項目を表示します。詳細...

Import Statement: import QtQuick.Controls
Inherits:

AbstractButton

プロパティ

信号

詳細説明

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 [since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティは、サブメニューの矢印アイテムを保持します。

このプロパティは、QtQuick.Controls 2.3 (Qt 5.10) で導入されました。

メニューのカスタマイズ」も参照してください


highlighted : bool

このプロパティは、メニュー項目がユーザーによってハイライトされているかどうかを保持します。

メニュー項目は、マウスホバーやキーボードナビゲーションによってハイライトされます。

デフォルト値はfalse です。

Menu::currentIndexも参照して ください。


implicitTextPadding : bool [since 6.8]

このプロパティは、contentItem の左端からテキストまでに必要な最小スペースを保持します。このプロパティは、Menu 内のすべての MenuItem に共通するtextPadding を計算するために使用されます。

このプロパティは Qt 6.8 で導入されました。

textPaddingも参照してください


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

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。


このプロパティは、このアイテムが親メニューで表示するサブメニューを保持します。このアイテムがサブメニューでない場合は、null

このプロパティは QtQuick.Controls 2.3 (Qt 5.10) で導入されました。


textPadding : bool [read-only, since 6.8]

このプロパティは、同じmenu 内のすべてのメニュー項目の中で見つかった最大のimplicitTextPadding を保持します。

このプロパティをスタイルで使用すると、同じメニュー内のすべての MenuItems がtext に対して整列されます。

Menu 、チェック可能なもの、アイコンを持つもの、テキストを含むものなど、様々なMenuItemから構成されます。そして、スタイルでは、それらのすべてのテキストが左揃え(またはmirrored アイテムについては右揃え)で表示されるようにすることがよくあります。各MenuItemimplicitTextPadding に独自の最小テキスト パディングを割り当て(アイコンとチェックマークを考慮)、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.