Тип QML MenuItemGroup

Группа для управления элементами нативного меню. Подробнее...

• Список всех членов, включая наследуемые

Свойства

• checkedItem : MenuItem
• enabled : bool
• exclusive : bool
• items : список<MenuItem>
• visible : bool

Сигналы

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

Методы

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

Подробное описание

Класс MenuItemGroup группирует элементы нативного меню вместе.

MenuItemGroup по умолчанию является исключительным. В группе элементов меню с исключением только один элемент может быть выделен в любой момент времени; выделение другого элемента автоматически сбрасывает выделение ранее выделенного. 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.

В группе исключительных элементов меню только один элемент может быть выделен в любой момент времени; выделение другого элемента автоматически сбрасывает выделение ранее выделенного.

items : список<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 из группы.