Тип QML Menu

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

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

Свойства

• enabled : bool
• iconName : строка
• iconSource : url
• items : список<Объект>
• style : Компонент
• title : строка
• type : перечисление
• visible : bool

Сигналы

• aboutToHide()
• aboutToShow()

Методы

• Элемент меню addItem(text)
• Меню addMenu(title)
• void addSeparator()
• void insertItem(before, object item)
• Элемент меню insertItem(before, строка title)
• Элемент меню insertMenu(before, строка title)
• void insertSeparator(before)
• void popup()
• void removeItem(item)

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

Menu {
    title: "Edit"

    MenuItem {
        text: "Cut"
        shortcut: "Ctrl+X"
        onTriggered: ...
    }

    MenuItem {
        text: "Copy"
        shortcut: "Ctrl+C"
        onTriggered: ...
    }

    MenuItem {
        text: "Paste"
        shortcut: "Ctrl+V"
        onTriggered: ...
    }

    MenuSeparator { }

    Menu {
        title: "More Stuff"

        MenuItem {
            text: "Do Nothing"
        }
    }
}

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

• в качестве главного меню в Панели меню
• в качестве подменю внутри другого меню
• в качестве автономного или контекстного меню

Обратите внимание, что некоторые свойства, такие как enabled, text, или iconSource, имеют смысл только в определённом случае использования меню.

См. также Панель меню, Элемент меню и Разделитель меню.

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

enabled : bool

Включено ли меню и реагирует ли оно на взаимодействие пользователя в качестве подменю. Его значение по умолчанию равно true.

iconName : строка

Устанавливает имя значка для значка меню. Это позволит выбрать значок с заданным именем из текущей темы. Работает только в качестве подменю.

Его значение по умолчанию — пустая строка.

См. также iconSource.

iconSource : url

Устанавливает URL файла или ресурса значка для значка меню в виде подменю. По умолчанию — пустой URL.

См. также iconName.

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

Список элементов в меню.

Меню принимает только объекты типа Меню, Элемент меню и Разделитель меню в качестве дочерних элементов. Оно также поддерживает объекты Instantiator, при условии, что вставка выполняется вручную с помощью insertItem().

Menu {
    id: recentFilesMenu

    Instantiator {
        model: recentFilesModel
        MenuItem {
            text: model.fileName
        }
        onObjectAdded: recentFilesMenu.insertItem(index, object)
        onObjectRemoved: recentFilesMenu.removeItem(object)
    }

    MenuSeparator {
        visible: recentFilesModel.count > 0
    }

    MenuItem {
        text: "Clear menu"
        enabled: recentFilesModel.count > 0
        onTriggered: recentFilesModel.clear()
    }
}

Обратите внимание, что в этом случае параметр index , переданный в insertItem(), относится к положению Instantiator в меню, а не к абсолютному положению в меню.

См. также Элемент меню и Разделитель меню.

style : Компонент

Компонент стиля для данного элемента управления.

Это свойство было добавлено в QtQuick.Controls.Styles 1.2.

См. также MenuStyle.

title : строка

Заголовок меню в качестве подменю или в панели меню.

Мемоники поддерживаются путём добавления символа быстрого вызова перед символом сочетания клавиш (&). Например, "\&File" будет связывать сочетание клавиш Alt-F с меню "File". Обратите внимание, что не все платформы поддерживают мемоники.

Его значение по умолчанию — пустая строка.

type : перечисление

Это свойство является только для чтения и постоянным, и его значение равно type.

visible : bool

Должен ли быть виден элемент меню в качестве подменю другого меню или в качестве меню на Панели меню. Его значение по умолчанию равно true.

Примечание: Это не имеет отношения к фактической видимости всплывающего окна меню. Используйте aboutToShow() и aboutToHide(), если вам нужно знать, когда всплывающее окно будет отображено или скрыто.

Документация по сигналам

aboutToHide()

Этот сигнал испускается непосредственно перед скрытием меню от пользователя.

Этот сигнал был добавлен в QtQuick.Controls 1.4.

См. также aboutToShow().

aboutToShow()

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

Этот сигнал был добавлен в QtQuick.Controls 1.4.

См. также aboutToHide().

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

Элемент меню addItem(text)

Добавляет элемент text в меню. Возвращает созданный Элемент меню.

См. также insertItem().

Меню addMenu(title)

Добавляет подменю с заголовком title в меню. Возвращает созданное Меню.

См. также insertMenu().

void addSeparator()

Добавляет разделитель в меню.

См. также insertSeparator().

void insertItem(before, object item)

Вставляет элемент item на индексе before в текущем меню. В этом случае, item может быть Элемент меню, Разделитель меню или Меню.

См. также removeItem().

Элемент меню insertItem(before, строка title)

Создаёт и вставляет элемент с заголовком title на индексе before в текущем меню. Возвращает созданный Элемент меню.

См. также addItem().

Элемент меню insertMenu(before, строка title)

Создаёт и вставляет подменю с заголовком title на индексе before в текущем меню. Возвращает созданное Меню.

См. также addMenu().

void insertSeparator(before)

Создаёт и вставляет разделитель на индексе before в текущем меню.

См. также addSeparator().

void popup()

Открывает это меню под курсором мыши. Может блокировать некоторые платформы, поэтому протестируйте его соответственно.

void removeItem(item)

Удаляет элемент item из меню. В этом случае, item может быть Элемент меню, Разделитель меню или Меню.

См. такжеinsertItem().