Тип QML меню

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

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

Свойства

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

Сигналы

• aboutToHide()
• aboutToShow()

Методы

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

[по умолчанию] 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)

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

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

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

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

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

void addSeparator()

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

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

void insertItem(int before, object 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().