Тип QML MenuStyle
Предоставляет пользовательскую стилизацию для меню Подробнее...
| Заявление об импорте: | import QtQuick.Controls.Styles 1.4 |
| С момента: | Qt 5.3 |
Свойства
- шрифт : шрифт
- рамка : Компонент
- itemDelegate : Объект
- scrollIndicator : Компонент
- разделитель : Компонент
- submenuOverlap : целое число
- submenuPopupDelay : целое число
Методы
- строка formatMnemonic(строка text, bool underline)
Подробное описание
Объект styleData содержит следующие только для чтения свойства:
| styleData.index : целое число | Индекс элемента меню в его меню. |
| styleData.type : перечисление | Тип элемента меню. Возможные значения см. ниже. |
| styleData.selected : логическое значение | true если элемент меню выбран. |
| styleData.pressed : логическое значение | true если элемент меню нажат. Доступно начиная с 5.4. |
| styleData.text : строка | Текст элемента меню или заголовок, если это подменю. |
| styleData.underlineMnemonic : логическое значение | Нужно ли подчеркнуть мнемонический символ метки элемента меню. |
| styleData.shortcut : строка | Текст ярлыка элемента меню. |
| styleData.iconSource : url | URL-адрес источника иконки элемента меню. Не определено, если иконки нет. |
| styleData.enabled : логическое значение | true если элемент меню активен. |
| styleData.checkable : логическое значение | true если элемент меню может быть помечен. |
| styleData.exclusive : логическое значение | true если элемент меню может быть помечен, и он является частью ExclusiveGroup. |
| styleData.checked : логическое значение | true если элемент меню может быть помечен и в настоящее время помечен. |
| styleData.scrollerDirection : перечисление | Если элемент меню — элемент прокрутки, его направление. Допустимые значения: Qt.UpArrow, Qt.DownArrow, и Qt.NoArrow. |
Допустимые значения для styleData.type:
- MenuItemType.Item
- MenuItemType.Menu
- MenuItemType.Separator
- MenuItemType.ScrollIndicator
Примечание: Стиль меню может быть не поддерживается на платформах, использующих встроенные меню через плагин QPA.
Документация по свойствам
шрифт : шрифт
Шрифт элемента управления.
Это свойство QML было введено в QtQuick.Controls.Styles 1.3.
рамка : Компонент
Рамка фона для всплывающего подменю.
Меню Menu будет изменять размер рамки в соответствии с его содержимым и отступами.
itemDelegate : Объект
Объект, содержащий компоненты подэлементов элемента меню. Эти подэлементы используются только для обычных элементов меню, а не для разделителей или указателей прокрутки.
Подэлементы:
-
itemDelegate.background : Компонент
Компонент фона элемента меню.
Его вид обычно изменяется при styleData.selected и styleData.enabled.
По умолчанию отображается только когда элемент активен и выбран. В противном случае он остается невидимым.
-
itemDelegate.label : Компонент
Компонент для фактической метки текста.
Текст извлекается из styleData.text, и его внешний вид должен зависеть от styleData.enabled и styleData.selected.
Если styleData.underlineMnemonic имеет значение true, метка должна подчеркивать свой мнемонический символ. formatMnemonic предоставляет стандартную форматирование.
-
itemDelegate.submenuIndicator : Компонент
Указывает, что текущий элемент меню является подменю.
Используется только тогда, когда styleData.type равно
MenuItemType.Menu. -
itemDelegate.shortcut : Компонент
Отображает ярлык, прикрепленный к элементу меню.
Используется только когда styleData.shortcut не пусто.
-
itemDelegate.checkmarkIndicator : Компонент
Будет использоваться, когда styleData.checkable имеет значение
true, и его внешний вид может зависеть от styleData.exclusive, т. е. от того, будет ли он вести себя как флажок или переключатель. Используйте styleData.checked для состояния выделения.
Примечание: Это свойство нельзя перезаписать, но все свойства подэлементов можно.
scrollIndicator : Компонент
Компонент для элемента меню указателя прокрутки.
Будет использоваться, когда styleData.type равно MenuItemType.ScrollIndicator. Его вид должен соответствовать styleData.scrollerDirection.
Это элемент, добавляемый в верхнюю и нижнюю часть всплывающего меню, когда его содержимое не помещается на экран, для указания наличия большего количества содержимого в направлении стрелки.
разделитель : Компонент
Компонент для элемента меню разделителя.
Будет использоваться, когда styleData.type равно MenuItemType.Separator.
submenuOverlap : целое число
Количество пикселей, на которое всплывающее подменю перекрывает горизонтально свое родительское меню.
submenuPopupDelay : целое число
Количество миллисекунд, которые нужно подождать перед открытием подменю.
Документация по методам
строка formatMnemonic(строка text, логическое значение underline = false)
Возвращает строку форматированного текста для отображения мнемонических символов для данного элемента меню.
Мнемонический символ в исходной строке предваряется амперсандом.
Передача true для underline подчеркнет мнемонический символ (например, formatMnemonic("&Open...", true) вернёт "<u>O</u>pen..."). Передача false для underline вернёт обычный текст (например, formatMnemonic("&Open...", false) вернёт "Open...").
См. также Метка.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qml-qtquick-controls-styles-menustyle.html