Тип 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()
• MenuItem insertItem(int before, string title)
• void insertItem(int before, object item)
• 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

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

Это свойство было добавлено в 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(string text)

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

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

Menu addMenu(string title)

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

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

void addSeparator()

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

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

MenuItem insertItem(int before, string title)

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

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

void insertItem(int before, object item)

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

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

MenuItem insertMenu(int before, string title)

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

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

void insertSeparator(int before)

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

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

void popup()

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

void removeItem(item)

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

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