Класс 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.0/qstyleoptionmenuitem.html
