MenuItem QML Type

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

Import Statement:	`import QtQuick.Controls`
Inherits:	AbstractButton

継承されたメンバーを含む全メンバーのリスト

プロパティ

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()
        }
    }
}

プロパティ 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も参照してください。

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 : bool [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()

このシグナルは、メニューアイテムがユーザーによってトリガーされたときに発せられます。

注: 対応するハンドラはonTriggered です。

本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の商標です。その他すべての商標は、それぞれの所有者に帰属します。