Класс QStyleOptionMenuItem
Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню. Подробнее...
| Заголовок: | #include <QStyleOptionMenuItem> |
| qmake: | QT += widgets |
| Наследуется от: | QStyleOption |
Типы публичного доступа
| Перечисление | CheckType { NotCheckable, Exclusive, NonExclusive } |
| Перечисление | MenuItemType { Normal, DefaultItem, Separator, SubMenu, ..., EmptyArea } |
| Перечисление | StyleOptionType { Type } |
| Перечисление | StyleOptionVersion { Version } |
Функции публичного доступа
| 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/archives/qt-5.6/qstyleoptionmenuitem.html
