Тип QML Меню

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

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

Свойства

• enabled : bool
• iconName : string
• iconSource : url
• items : list<Object>
• style : Component
• title : string
• type : перечисление
• visible : bool

Сигналы

• aboutToHide()
• aboutToShow()

Методы

• MenuItem addItem(text)
• Menu addMenu(title)
• void addSeparator()
• void insertItem(before, object item)
• MenuItem insertItem(before, string title)
• MenuItem insertMenu(before, string 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"
        }
    }
}

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

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

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

См. также MenuBar, MenuItem и MenuSeparator.

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

enabled : bool

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

iconName : string

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

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

См. также iconSource.

iconSource : url

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

См. также iconName.

[default] items : list<Object>

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

Menu принимает только объекты типа Menu, MenuItem и MenuSeparator в качестве дочерних элементов. Также поддерживает объекты 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 в меню, а не к абсолютному положению в меню.

См. также MenuItem и MenuSeparator.

style : Component

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

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

См. также MenuStyle.

title : string

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

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

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

type : enumeration

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

visible : bool

Указывает, должно ли меню отображаться в качестве подменю другого меню или как меню в MenuBar. Значение по умолчанию — true.

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

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

aboutToHide()

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

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

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

aboutToShow()

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

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

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

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

MenuItem addItem(text)

Добавляет элемент в меню. Возвращает только что созданный MenuItem.

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

Menu addMenu(title)

Добавляет подменю в меню. Возвращает только что созданное Menu.

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

void addSeparator()

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

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

void insertItem(before, object item)

Вставляет item на индекс before в текущем меню. В этом случае item может быть либо MenuItem, либо MenuSeparator, либо Menu.

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

MenuItem insertItem(before, string title)

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

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

MenuItem insertMenu(before, string title)

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

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

void insertSeparator(before)

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

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

void popup()

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

void removeItem(item)

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

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