MenuItemGroup QML Type

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

Import Statement:	`import Qt.labs.platform`
Inherits:	QtObject

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

プロパティ

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() メソッドを使用して処理することができます。

注意: Qt.labsモジュールの型は、将来のバージョンでも互換性が保たれることを保証するものではありません。

MenuItemも参照してください。

プロパティの説明

checkedItem : MenuItem

このプロパティは、グループ内の現在チェックされている項目を保持します。チェックされている項目がない場合は、null 。

enabled : bool

このプロパティは、グループが有効かどうかを保持します。デフォルト値はtrue である。

グループの有効状態は、グループ内の各項目の有効状態に影響する。ただし、グループが有効であっても、明示的に無効化された項目は有効化されない。

exclusive : bool

このプロパティは、グループが排他的であるかどうかを保持する。デフォルト値はtrue である。

排他的なメニュー項目グループでは、いつでもチェックできる項目は1つだけであり、別の項目をチェックすると、前にチェックした項目のチェックは自動的に解除される。

items : list<MenuItem>

このプロパティは、グループ内の項目のリストを保持する。

visible : bool

このプロパティは、グループが可視であるかどうかを保持する。デフォルト値はtrue です。

ただし、明示的に非表示にされた項目は、グループが表示されていても表示されない。

シグナル・ドキュメント

hovered(MenuItem item)

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

注：対応するハンドラはonHovered 。

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

triggered(MenuItem item)

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

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

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

メソッドの説明

void addItem(MenuItem item)

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

void clear()

グループからすべての項目を削除します。

void removeItem(MenuItem item)

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

© 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.