Тип QML меню

Поп-меню, которое может использоваться в качестве контекстного меню или всплывающего меню. Подробнее...

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

Свойства

• contentData : список<Объект>
• contentModel : модель
• title : строка

Методы

• void addItem(Элемент item)
• void insertItem(int index, Элемент item)
• Элемент itemAt(int index)
• void moveItem(int from, int to)
• void removeItem(int index)

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

Меню имеет два основных варианта использования:

• Контекстные меню; например, меню, которое отображается после щелчка правой кнопкой мыши
• Всплывающие меню; например, меню, которое отображается после щелчка по кнопке

Button {
    id: fileButton
    text: "File"
    onClicked: menu.open()

    Menu {
        id: menu
        y: fileButton.height

        MenuItem {
            text: "New..."
        }
        MenuItem {
            text: "Open..."
        }
        MenuItem {
            text: "Save"
        }
    }
}

Обычно элементы меню статически объявляются в качестве дочерних элементов меню, но Menu также предоставляет API для добавления, вставки, перемещения и удаления элементов динамически. К элементам меню можно получить доступ, используя itemAt() или contentChildren.

Хотя Элементы меню чаще всего используются с Menu, он может содержать любой тип элемента.

См. также Настройка меню, Элементы управления меню и Элементы управления всплывающими окнами.

Документация по свойствам

[по умолчанию] contentData : список<Объект>

Это свойство содержит список данных содержимого.

Список содержит все объекты, которые были объявлены в QML как дочерние элементы меню, а также элементы, которые были динамически добавлены или вставлены с помощью методов addItem() и insertItem() соответственно.

Примечание: В отличие от contentChildren, contentData включает невизуальные объекты QML. Он не переупорядочивается при вставке или перемещении элементов.

См. также Item::data и contentChildren.

[только для чтения] contentModel : модель

Это свойство содержит модель, используемую для отображения элементов меню.

Модель содержимого предоставляется для целей визуализации. Её можно назначить в качестве модели элементу содержимого, который представляет содержимое меню.

Menu {
    id: menu
    contentItem: ListView {
        model: menu.contentModel
    }
}

Модель позволяет статически объявлять элементы меню в качестве дочерних элементов меню.

title : строка

Это свойство содержит заголовок меню.

Заголовок меню часто отображается в тексте элемента меню, когда меню является подменю, и в тексте кнопки инструмента, когда она находится в строке меню.

Документация по методам

void addItem(Элемент item)

Добавляет item в конец списка элементов.

void insertItem(int index, Элемент item)

Вставляет item в index.

Элемент itemAt(int index)

Возвращает элемент в index или null если его нет.

void moveItem(int from, int to)

Перемещает элемент from в другое to.

void removeItem(int index)

Удаляет элемент в index.

Примечание: Владение элементом передается вызывающей стороне.