MenuItemGroup QML Type

ネイティブメニュー項目を管理するためのグループ。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

プロパティ

• checkedItem : MenuItem
• enabled : bool
• exclusive : bool
• items : list<MenuItem>
• visible : bool

信号

• hovered(MenuItem item)
• triggered(MenuItem item)

方法

• void addItem(MenuItem item)
• void clear()
• void removeItem(MenuItem item)

詳細説明

MenuItemGroup は、ネイティブのメニュー項目をグループ化します。

MenuItemGroupは、デフォルトで排他的です。排他的なメニュー項目グループでは、一度にチェックできる項目は1つだけです。別の項目をチェックすると、以前にチェックされていた項目のチェックが自動的に外れます。MenuItemGroupは非排他的に設定することもでき、これは項目をグループとしてまとめて表示、非表示、有効化、無効化する場合に特に便利です。

MenuItemGroup を使用する最も簡単な方法は、項目のリストを割り当てることです。

Menu {
    id: verticalMenu
    title: qsTr("Vertical")

    MenuItemGroup {
        id: verticalGroup
        items: verticalMenu.items
    }

    MenuItem { text: qsTr("Top"); checkable: true }
    MenuItem { text: qsTr("Center"); checked: true }
    MenuItem { text: qsTr("Bottom"); checkable: true }
}

同じメニューに、同じ排他的なグループに含めるべきではない項目が含まれている場合があります。そのような場合は、group プロパティを使用するのが最適です。

Menu {
    id: horizontalMenu
    title: qsTr("Horizontal")

    MenuItemGroup {
        id: horizontalGroup
    }

    MenuItem {
        checked: true
        text: qsTr("Left")
        group: horizontalGroup
    }
    MenuItem {
        checkable: true
        text: qsTr("Center")
        group: horizontalGroup
    }
    MenuItem {
        text: qsTr("Right")
        checkable: true
        group: horizontalGroup
    }

    MenuItem { separator: true }
    MenuItem { text: qsTr("Justify"); checkable: true }
    MenuItem { text: qsTr("Absolute"); checkable: true }
}

より高度なユースケースについては、addItem() およびremoveItem() メソッドを使用して処理できます。

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

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

checkedItem : MenuItem

このプロパティには、グループ内で現在チェックされている項目が格納されます。項目がチェックされていない場合は、null が返されます。

enabled : bool

このプロパティは、グループが有効になっているかどうかを指定します。デフォルト値はtrue です。

グループの有効状態は、グループ内の各項目の有効状態に影響しますが、明示的に無効に設定された項目については、グループが有効であっても有効にはなりません。

exclusive : bool

このプロパティは、グループが排他的であるかどうかを指定します。デフォルト値は「true 」です。

排他的なメニュー項目グループでは、一度にチェックできる項目は1つだけです。別の項目をチェックすると、以前にチェックされていた項目のチェックが自動的に外れます。

items : list<MenuItem>

このプロパティには、グループ内の項目のリストが格納されています。

visible : bool

このプロパティは、グループが表示されるかどうかを指定します。デフォルト値はtrue です。

グループの表示状態は、グループ内の各項目の表示状態に影響しますが、明示的に非表示に設定された項目は、グループが表示されている場合でも表示されません。

Signal ドキュメント

hovered(MenuItem item)

このシグナルは、グループ内のitem にユーザーがカーソルを合わせると発火します。

MenuItem::hovered()も参照してください 。

triggered(MenuItem item)

このシグナルは、グループ内のitem がユーザーによってトリガーされたときに発信されます。

MenuItem::triggered()も参照してください 。

メソッドのドキュメント

void addItem(MenuItem item)

グループにitem を追加します。

void clear()

グループからすべてのアイテムを削除します。

void removeItem(MenuItem item)

グループからitem を削除します。