Тип QML Menu

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

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

Свойства

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

Сигналы

• aboutToHide()
• aboutToShow()

Методы

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

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

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

См. также MenuStyle.

title : string

Название меню как подменю или в строке меню.

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

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

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

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

visible : bool

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

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

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

aboutToHide()

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

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

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

aboutToShow()

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

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

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

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

MenuItem addItem(string text)

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

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

Menu addMenu(string title)

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

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

void addSeparator()

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

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

void insertItem(int before, object item)

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

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

MenuItem insertItem(int before, string title)

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

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

MenuItem insertMenu(int before, string title)

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

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

void insertSeparator(int before)

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

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

void popup()

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

void removeItem(item)

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

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