Тип QML MenuStyle
Обеспечивает пользовательскую стилизацию для Menu. Подробнее...
| Заявление об импорте: | import QtQuick.Controls.Styles 1.4 |
| С момента: | Qt 5.3 |
Свойства
- font : шрифт
- frame : Компонент
- itemDelegate : Объект
- scrollIndicator : Компонент
- separator : Компонент
- submenuOverlap : int
- submenuPopupDelay : int
Методы
- строка formatMnemonic(строка text, bool underline)
Подробное описание
Объект 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.
Документация по свойствам
font : font
Шрифт управления.
Это свойство было введено в QtQuick.Controls.Styles 1.3.
frame : Component
Фрейм фона для всплывающего окна меню.
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 : Component
Компонент для пункта меню-индикатора прокрутки.
Будет использоваться, когда styleData.type равно MenuItemType.ScrollIndicator. Его внешний вид должен следовать styleData.scrollerDirection.
Это элемент, добавленный вверху и внизу всплывающего меню, когда его содержимое не помещается на экран, чтобы указать, что большее содержимое доступно в направлении стрелки.
separator : Component
Компонент для пункта меню-разделителя.
Будет использоваться, когда styleData.type равно MenuItemType.Separator.
submenuOverlap : int
Количество пикселей, на которые всплывающее подменю перекрывает горизонтально родительское меню.
submenuPopupDelay : int
Количество миллисекунд ожидания перед открытием подменю.
Документация по методам
строка formatMnemonic(строка text, bool underline = false)
Возвращает строку форматированного текста для отображения мнемоники для заданного пункта меню 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.15/qml-qtquick-controls-styles-menustyle.html