Класс QStyleOptionMenuItem
Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню. Подробнее...
| Заголовок: | #include <QStyleOptionMenuItem> |
| 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 | tabWidth |
| QString | text |
Подробное описание
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(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::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.13/qstyleoptionmenuitem.html
