Тип QML Меню

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

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

Свойства

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

Сигналы

• aboutToHide()
• aboutToShow()

Методы

• ЭлементМеню addItem(строка text)
• Меню addMenu(строка title)
• void addSeparator()
• void insertItem(int before, объект item)
• ЭлементМеню insertItem(int before, строка title)
• ЭлементМеню insertMenu(int before, строка 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"
        }
    }
}

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

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

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

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

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

enabled : bool

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

iconName : строка

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

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

См. также iconSource.

iconSource : url

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

См. также iconName.

[default] 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 : Компонент

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

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

См. также СтильМеню.

title : строка

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

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

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

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

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

visible : bool

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

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

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

aboutToHide()

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

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

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

aboutToShow()

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

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

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

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

ЭлементМеню addItem(строка text)

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

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

Меню addMenu(строка title)

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

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

void addSeparator()

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

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

void insertItem(int before, объект item)

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

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

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

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

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

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

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

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

void insertSeparator(int before)

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

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

void popup()

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

void removeItem(item)

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

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