MenuItem QML Type

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

• 継承されたメンバーを含む、すべてのメンバーのリスト

プロパティ

• arrow : Item (since QtQuick.Controls 2.3 (Qt 5.10))
• highlighted : bool
• implicitTextPadding : real (since 6.8)
• menu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
• subMenu : Menu (since QtQuick.Controls 2.3 (Qt 5.10))
• textPadding : real (since 6.8)

信号

• void triggered()

詳細な説明

MenuItemは、AbstractButton APIを実装する利便性向上のための型であり、例えばメニュー項目がtriggered された際に、使い慣れた方法で対応できるようにします。

MenuItemは、AbstractButton からAPIを継承しています。たとえば、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 」、および「メニュー コントロール」も参照してください 。

プロパティのドキュメント

arrow : Item [since QtQuick.Controls 2.3 (Qt 5.10)]

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

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

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

highlighted : bool

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

メニュー項目は、マウスをホバーさせたり、キーボードで移動したりすることでハイライト表示されることがあります。

デフォルト値は `false` です。

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

implicitTextPadding : real [since 6.8]

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

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

「textPadding」も参照してください 。

menu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティには、このメニュー項目を含むメニューが格納されます。項目がメニューに含まれていない場合は、null が格納されます。

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

subMenu : Menu [read-only, since QtQuick.Controls 2.3 (Qt 5.10)]

このプロパティには、このアイテムが親メニューで表示するサブメニュー、またはこのアイテムがサブメニュー項目でない場合はnull が格納されます。

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

textPadding : real [read-only, since 6.8]

このプロパティには、同じmenu 内のすべてのメニュー項目の中から見つかった最大のimplicitTextPadding が格納されます。

このプロパティをスタイルで使用することで、同じMenu内のすべてのMenuItemが、text を基準に整列されるようにすることができます。

Menu は、さまざまな MenuItem で構成されることがあり、チェック可能なもの、アイコンを持つもの、単にテキストを含むものなどがあります。 そして多くの場合、スタイルでは、それらすべての内部のテキストが左揃え（mirrored 項目については右揃え）になるようにしたいものです。各MenuItem が、implicitTextPadding に対して独自の最小テキストパディングを割り当てる（アイコンやチェックマークを考慮に入れて）一方で、textPaddingを使用してtext を実際に配置することで、すべてのMenuItemsが揃うようになります

これを機能させるためには、すべての MenuItems が、implicitTextPadding を、contentItem の左端からテキストまでの最小必要なスペースに設定する必要があります。

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

「implicitTextPadding」も参照してください 。

シグナルに関するドキュメント

void triggered()

このシグナルは、ユーザーがメニュー項目を操作した際に発生します。