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 はその 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 、メニュー・コントロール。

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

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 内のすべての MenuItems に共通する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 を保持する。

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

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

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

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

implicitTextPaddingも参照してください 。

シグナルのドキュメント

void triggered()

このシグナルは、メニュー項目がユーザーによってトリガーされたときに発せられる。