Класс QStyleOptionMenuItem
Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню. Подробнее...
| Заголовок: | #include <QStyleOptionMenuItem> |
| qmake: | QT += widgets |
| Наследуется от: | QStyleOption |
Типы
| перечисление | CheckType { Незначащий, Исключительный, Неисключительный } |
| перечисление | MenuItemType { Обычный, Стандартный, Разделитель, Подменю, ..., Пустая область } |
| перечисление | StyleOptionType { Тип } |
| перечисление | StyleOptionVersion { Версия } |
Открытые функции
| QStyleOptionMenuItem() | |
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) |
- 2 открытых функции унаследованы от QStyleOption
Открытые переменные
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | tabWidth |
| QString | text |
Подробное описание
Класс 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.
Документация переменных-членов
QStyleOptionMenuItem::CheckType QStyleOptionMenuItem::checkType
Эта переменная содержит тип галочки пункта меню
Значение по умолчанию — NotCheckable.
См. такжеCheckType.
bool QStyleOptionMenuItem::checked
Эта переменная указывает, выбран ли пункт меню
Значение по умолчанию — false.
QFont QStyleOptionMenuItem::font
Эта переменная содержит шрифт, используемый для текста пункта меню
Это шрифт, который должен использоваться для отрисовки текста пункта меню минус сочетание клавиш. Сочетание клавиш обычно рисуется с использованием шрифта отрисовщика. По умолчанию используется шрифт по умолчанию приложения.
QIcon QStyleOptionMenuItem::icon
Эта переменная содержит значок для пункта меню
Значение по умолчанию — пустой значок, т. е. значок без пиксельного изображения и без имени файла.
int QStyleOptionMenuItem::maxIconWidth
Эта переменная содержит максимальную ширину значка для значка в пункте меню
Это можно использовать для рисования значка в правильном месте или правильного выравнивания элементов. Переменная должна быть установлена независимо от того, есть ли у пункта меню значок. Значение по умолчанию — 0.
bool QStyleOptionMenuItem::menuHasCheckableItems
Эта переменная содержит информацию о наличии пунктов меню с возможностью выбора
Значение по умолчанию — true.
Если этот параметр установлен в false, то меню не содержит пунктов с возможностью выбора. Это позволяет стилям пользовательского интерфейса экономить некоторое горизонтальное пространство, которое обычно используется для столбца выбора.
QStyleOptionMenuItem::MenuItemType QStyleOptionMenuItem::menuItemType
Эта переменная содержит тип пункта меню
Значение по умолчанию — Normal.
См. такжеMenuItemType.
QRect QStyleOptionMenuItem::menuRect
Эта переменная содержит прямоугольник для всего меню
Значение по умолчанию — пустой прямоугольник, т. е. прямоугольник с шириной и высотой, равными 0.
int QStyleOptionMenuItem::tabWidth
Эта переменная содержит зарезервированную ширину для сочетания клавиш пункта меню
QMenu устанавливает её в ширину, занимаемую самым широким сочетанием клавиш среди всех видимых элементов в меню.
Значение по умолчанию — 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.12/qstyleoptionmenuitem.html
