Класс QStyleOptionMenuItem
Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню. Подробнее...
| Заголовок: | #include <QStyleOptionMenuItem> |
| CMake: | find_package(Qt6 COMPONENTS Widgets REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Наследует: | QStyleOption |
Типы public
| Перечисление | CheckType { Недоступно, Эксклюзивный, Неэксклюзивный } |
| Перечисление | MenuItemType { Обычный, ПунктПоУмолчанию, Разделитель, Подменю, Скроллер, …, ПустаяОбласть } |
| Перечисление | StyleOptionType { Тип } |
| Перечисление | StyleOptionVersion { Версия } |
Функции public
| QStyleOptionMenuItem(const QStyleOptionMenuItem &other) | |
| QStyleOptionMenuItem() |
Переменные public
| 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.2/qstyleoptionmenuitem.html
