Класс QStyleOptionMenuItem
Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню. Подробнее...
| Заголовок: | #include <QStyleOptionMenuItem> |
| qmake: | QT += widgets |
| Наследует: | QStyleOption |
Типы публичного доступа
| перечисление | CheckType { НеОтмечаемый, Эксклюзивный, НеЭксклюзивный } |
| перечисление | MenuItemType { Нормальный, СтандартныйПункт, Разделитель, Подменю, ..., ПустаяОбласть } |
| перечисление | StyleOptionType { Тип } |
| перечисление | StyleOptionVersion { Версия } |
Функции публичного доступа
| QStyleOptionMenuItem() | |
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) |
- 2 функции публичного доступа, унаследованные от QStyleOption
Переменные публичного доступа
| CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| MenuItemType | menuItemType |
| QRect | menuRect |
| int | tabWidth |
| QString | text |
- 8 переменных публичного доступа, унаследованных от QStyleOption
Подробное описание
Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню.
QStyleOptionMenuItem содержит всю информацию, необходимую функциям QStyle для отрисовки пунктов меню из QMenu. Он также используется для отрисовки других виджетов, связанных с меню.
В целях производительности доступ к переменным-членам осуществляется напрямую (т.е., с использованием оператора . или ->). Этот низкоуровневый подход делает структуры простыми в использовании и подчеркивает, что это просто параметры, используемые функциями стиля.
Пример использования стилей см. в примере Styles.
См. также QStyleOption.
Документация по типам членов
перечисление QStyleOptionMenuItem::CheckType
Это перечисление используется для указания того, должна ли для пункта быть отрисована галочка или вообще должна ли она быть отрисована.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionMenuItem::NotCheckable |
0 |
Пункт не отмечается. |
QStyleOptionMenuItem::Exclusive |
1 |
Пункт является эксклюзивным пунктом с отметкой (как радиокнопка). |
QStyleOptionMenuItem::NonExclusive |
2 |
Пункт является неэксклюзивным пунктом с отметкой (как флажок). |
См. также checkType, QAction::checkable, QAction::checked и QActionGroup::exclusive.
перечисление QStyleOptionMenuItem::MenuItemType
Это перечисление указывает тип пункта меню, описываемого структурой.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionMenuItem::Normal |
0 |
Обычный пункт меню. |
QStyleOptionMenuItem::DefaultItem |
1 |
Пункт меню, который является действием по умолчанию, как указано в QMenu::defaultAction(). |
QStyleOptionMenuItem::Separator |
2 |
Разделитель меню. |
QStyleOptionMenuItem::SubMenu |
3 |
Указывает, что пункт меню ссылается на подменю. |
QStyleOptionMenuItem::Scroller |
4 |
Прокрутка всплывающего меню (в настоящее время используется только на macOS). |
QStyleOptionMenuItem::TearOff |
5 |
Ручка отрыва для меню. |
QStyleOptionMenuItem::Margin |
6 |
Отступ меню. |
QStyleOptionMenuItem::EmptyArea |
7 |
Пустая область меню. |
См. также menuItemType.
перечисление QStyleOptionMenuItem::StyleOptionType
Это перечисление используется для хранения информации о типе опции стиля и определено для каждого подкласса QStyleOption.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionMenuItem::Type |
SO_MenuItem |
Тип предоставленной опции стиля (SO_MenuItem для этого класса). |
Тип используется внутренне классами QStyleOption, его подклассами и qstyleoption_cast() для определения типа опции стиля. Обычно вам об этом не нужно беспокоиться, если вы не хотите создать свой собственный подкласс QStyleOption и свои собственные стили.
См. также StyleOptionVersion.
перечисление QStyleOptionMenuItem::StyleOptionVersion
Это перечисление используется для хранения информации о версии опции стиля и определено для каждого подкласса QStyleOption.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionMenuItem::Version |
1 |
1 |
Версия используется подклассами QStyleOption для реализации расширений без нарушения совместимости. Если вы используете qstyleoption_cast(), обычно вам не нужно этого проверять.
См. также StyleOptionType.
Документация по функциям членов
QStyleOptionMenuItem::QStyleOptionMenuItem()
Конструирует QStyleOptionMenuItem, инициализируя переменные-члены их значениями по умолчанию.
QStyleOptionMenuItem::QStyleOptionMenuItem(const QStyleOptionMenuItem &other)
Конструирует копию опции стиля other.
Документация по переменным-членам
CheckType QStyleOptionMenuItem::checkType
Эта переменная хранит тип отметки меню
Значение по умолчанию — NotCheckable.
См. также CheckType.
bool QStyleOptionMenuItem::checked
Эта переменная хранит информацию о том, выбрано ли меню или нет
Значение по умолчанию — false.
QFont QStyleOptionMenuItem::font
Эта переменная хранит шрифт, используемый для текста элемента меню
Это шрифт, который должен использоваться для отображения текста меню, минус сочетание клавиш. Сочетание клавиш обычно отображается с помощью шрифта средства рисования. По умолчанию используется шрифт по умолчанию приложения.
QIcon QStyleOptionMenuItem::icon
Эта переменная хранит значок для элемента меню
Значение по умолчанию — пустой значок, т. е. значок без растрового изображения и без имени файла.
int QStyleOptionMenuItem::maxIconWidth
Эта переменная хранит максимальную ширину значка для значка в элементе меню
Это может использоваться для рисования значка в нужное место или правильного выравнивания элементов. Переменная должна быть задана независимо от того, есть ли у элемента меню значок. Значение по умолчанию — 0.
bool QStyleOptionMenuItem::menuHasCheckableItems
Эта переменная хранит информацию о том, имеет ли меню в целом элементы с возможностью выбора или нет
Значение по умолчанию — true.
Если этот параметр установлен в false, то меню не содержит элементов с возможностью выбора. Это позволяет стилям интерфейса сэкономить некоторое горизонтальное пространство, которое обычно используется для колонки выбора.
MenuItemType QStyleOptionMenuItem::menuItemType
Эта переменная хранит тип элемента меню
Значение по умолчанию — Normal.
См. также MenuItemType.
QRect QStyleOptionMenuItem::menuRect
Эта переменная хранит прямоугольник для всего меню
Значение по умолчанию — пустой прямоугольник, т. е. прямоугольник с шириной и высотой, равными 0.
int QStyleOptionMenuItem::tabWidth
Эта переменная хранит ширину отступа для элемента меню
Ширина отступа — это расстояние между текстом элемента меню и сочетанием клавиш. Значение по умолчанию — 0.
QString QStyleOptionMenuItem::text
Эта переменная хранит текст для элемента меню
Обратите внимание, что формат текста — что-то вроде этого: "Текст меню\tСочетание клавиш".
Если у элемента меню нет сочетания клавиш, он будет содержать только текст элемента меню. Значение по умолчанию — пустая строка.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.9/qstyleoptionmenuitem.html
