Тип QML MenuStyle
Предоставляет пользовательскую стилизацию для меню Подробнее...
| Оператор импорта: | import QtQuick.Controls.Styles 1.4 |
| С: | Qt 5.3 |
Свойства
- шрифт : шрифт
- рамка : Компонент
- itemDelegate : Объект
- scrollIndicator : Компонент
- разделитель : Компонент
- перекрытиеПодменю : int
- задержкаПопАпаПодменю : int
Методы
- строка formatMnemonic(строка текст, логическое подчеркнуть)
Подробное описание
Объект styleData содержит следующие только для чтения свойства:
| styleData.index : int | Индекс пункта меню в его меню. |
| 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 истинно, метка должна подчеркивать мнемоник символа. 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.
перекрытиеПодменю : int
Количество пикселей, на которые всплывающее окно подменю перекрывается горизонтально своим родительским меню.
задержкаПопАпаПодменю : int
Число миллисекунд, ожидаемых перед открытием подменю.
Документация по методам
строка formatMnemonic(строка текст, логическое подчеркнуть = ложь)
Возвращает строку форматирования Rich Text для отображения мнемоники для данного пункта меню.
Символ мнемоники предваряется амперсандом в исходной строке.
Передача true для underline подчеркнёт символ мнемоники (например, formatMnemonic("&Open...", true) вернёт "<u>O</u>pen..."). Передача false для underline вернёт обычный текстовый вид (например, formatMnemonic("&Open...", false) вернёт "Open...").
См. также Label.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qml-qtquick-controls-styles-menustyle.html