Тип QML MenuStyle
Обеспечивает настраиваемую стилизацию для элемента Menu. Подробнее...
| Заявление об импорте: | import QtQuick.Controls.Styles 1.4 |
| С момента: | Qt 5.3 |
Свойства
- шрифт : шрифт
- рамка : Компонент
- itemDelegate : Объект
- индикаторПрокрутки : Компонент
- разделитель : Компонент
- перекрытиеПодменю : int
- задержкаПоявленияПодменю : int
Методы
- строка форматироватьМнемонику(строка текст, bool подчеркнуть)
Подробное описание
Объект styleData содержит следующие только для чтения свойства:
| styleData.index : int | Индекс элемента меню в его меню. |
| styleData.type : перечисление | Тип элемента меню. Возможные значения приведены ниже. |
| styleData.selected : bool |
true если элемент меню выбран. |
| styleData.pressed : bool |
true если элемент меню нажат. Доступно начиная с 5.4. |
| styleData.text : строка | Текст элемента меню или заголовок, если это подменю. |
| styleData.underlineMnemonic : bool | Нужно ли подчеркнуть мнемонический символ метки элемента меню. |
| styleData.shortcut : строка | Текст для ярлыка элемента меню. |
| styleData.iconSource : url | URL-адрес источника иконки элемента меню. Не определено, если нет иконки. |
| styleData.enabled : bool |
true если элемент меню активен. |
| styleData.checkable : bool |
true если элемент меню имеет флажок. |
| styleData.exclusive : bool |
true если элемент меню имеет флажок и входит в ExclusiveGroup. |
| styleData.checked : bool |
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 для состояния выбора.
Примечание: Это свойство нельзя перезаписать, хотя все свойства подэлементов можно.
индикаторПрокрутки : Компонент
Компонент для элемента меню индикатора прокрутки.
Используется, когда styleData.type равно MenuItemType.ScrollIndicator. Его внешний вид должен соответствовать styleData.scrollerDirection.
Это элемент, добавляемый в верхнюю и нижнюю часть всплывающего меню, когда его содержимое не помещается на экране, чтобы указать, что больше содержимого доступно в направлении стрелки.
разделитель : Компонент
Компонент для элемента меню-разделителя.
Используется, когда styleData.type равно MenuItemType.Separator.
перекрытиеПодменю : int
Количество пикселей, на которое всплывающее окно подменю перекрывается горизонтально своим родительским меню.
задержкаПоявленияПодменю : int
Количество миллисекунд ожидания перед открытием подменю.
Документация по методам
строка форматироватьМнемонику(строка текст, bool подчеркнуть = false)
Возвращает строку форматированного текста для отображения мнемоники для заданного элемента меню текст.
Мнемонический символ предваряется амперсандом в исходной строке.
Передача true для подчеркнуть подчеркнет мнемонический символ (например, formatMnemonic("&Open...", true) вернет "<u>O</u>pen..."). Передача false для подчеркнуть вернет обычный текст (например, 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.14/qml-qtquick-controls-styles-menustyle.html