Класс QStyleOptionMenuItem
Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню. Подробнее...
| Заголовок: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Наследует: | QStyleOption |
Типы
| перечисление | CheckType { Немаркируемый, Эксклюзивный, Неэксклюзивный } |
| перечисление | MenuItemType { Обычный, По умолчанию, Разделитель, Подменю, Прокрутка, …, Пустая область } |
| перечисление | StyleOptionType { Тип } |
| перечисление | StyleOptionVersion { Версия } |
Открытые функции
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) | |
| QStyleOptionMenuItem() |
Открытые переменные
| QStyleOptionMenuItem::CheckType | checkType |
| bool | checked |
| QFont | font |
| QIcon | icon |
| int | maxIconWidth |
| bool | menuHasCheckableItems |
| QStyleOptionMenuItem::MenuItemType | menuItemType |
| QRect | menuRect |
| int | reservedShortcutWidth |
| QString | text |
Подробное описание
QStyleOptionMenuItem содержит всю информацию, необходимую функциям QStyle для отрисовки пунктов меню из QMenu. Также используется для отрисовки других связанных с меню виджетов.
Из соображений производительности, в классе мало функций-членов, и доступ к переменным-членам осуществляется напрямую (т.е., с использованием оператора . или ->). Это делает структуры простыми в использовании и подчеркивает, что это просто параметры, используемые функциями стиля.
Пример использования опций стиля см. в примере Styles.
См. также QStyleOption.
Документация по типам членов
перечисление QStyleOptionMenuItem::CheckType
Это перечисление используется для указания того, нужно ли рисовать галочку для пункта или вообще нужно ли ее рисовать.
| Константа | Значение | Описание |
|---|---|---|
QStyleOptionMenuItem::NotCheckable |
0 |
Пункт не маркируется. |
QStyleOptionMenuItem::Exclusive |
1 |
Пункт является эксклюзивным пунктом маркировки (как радиокнопка). |
QStyleOptionMenuItem::NonExclusive |
2 |
Пункт является неэксклюзивным пунктом маркировки (как флажок). |
См. также checkType, QAction::checkable, QAction::checked и QActionGroup::exclusionPolicy.
перечисление 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(const QStyleOptionMenuItem &other)
Создает копию опции стиля other.
QStyleOptionMenuItem::QStyleOptionMenuItem()
Создает QStyleOptionMenuItem, инициализируя переменные-члены их значениями по умолчанию.
Документация переменных-членов
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::reservedShortcutWidth
Эта переменная содержит зарезервированную ширину для сочетания клавиш пункта меню.
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-6.1/qstyleoptionmenuitem.html
