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