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 を削除します。

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