Тип QML MenuStyle
Обеспечивает настраиваемое форматирование для элемента Menu. Подробнее...
| Заявление об импорте: | import QtQuick.Controls.Styles 1.4 |
| С момента: | Qt 5.3 |
Свойства
- шрифт : шрифт
- рамка : Компонент
- itemDelegate : Объект
- scrollIndicator : Компонент
- разделитель : Компонент
- submenuOverlap : целое число
- submenuPopupDelay : целое число
Методы
- строка formatMnemonic(строка text, логическое значение 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.
Документация по свойствам
шрифт : шрифт
Шрифт элемента управления.
Это свойство было добавлено в 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/qt-5.12/qml-qtquick-controls-styles-menustyle.html