Тип QML MenuStyle
Предоставляет настраиваемую стилизацию для элемента Menu. Подробнее...
| Заявление об импорте: | import QtQuick.Controls.Styles 1.4 |
| С момента: | Qt 5.3 |
Свойства
- font : шрифт
- frame : Компонент
- itemDelegate : Объект
- scrollIndicator : Компонент
- separator : Компонент
- 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.
Документация по свойствам
font : шрифт
Шрифт элемента управления.
Это свойство было добавлено в QtQuick.Controls.Styles 1.3.
frame : Компонент
Рамка фона для всплывающего меню.
Элемент 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.
Это элемент, добавляемый в начало и конец всплывающего меню, когда его содержимое не помещается на экран, чтобы указать, что дополнительное содержимое доступно в направлении стрелки.
separator : Компонент
Компонент для разделителя элемента меню.
Используется, когда 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.11/qml-qtquick-controls-styles-menustyle.html