Spec-Zone.ru › Qt 5.11

Класс QStyleOptionMenuItem

Класс QStyleOptionMenuItem используется для описания параметров, необходимых для отрисовки пункта меню. Подробнее...

Заголовок: #include <QStyleOptionMenuItem>
qmake: QT += widgets
Наследует: QStyleOption
  • Список всех членов, включая унаследованные

Типы публичного доступа

перечисление CheckType { NotCheckable, Exclusive, NonExclusive }
перечисление MenuItemType { Normal, DefaultItem, Separator, SubMenu, ..., EmptyArea }
перечисление StyleOptionType { Type }
перечисление StyleOptionVersion { Version }

Функции публичного доступа

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
  • 8 переменных публичного доступа, унаследованных от QStyleOption

Подробное описание

Класс 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

Эта переменная содержит ширину табуляции для пункта меню.

Ширина табуляции — это расстояние между текстом пункта меню и быстрого вызова. Значение по умолчанию — 0.

QString QStyleOptionMenuItem::text

Эта переменная содержит текст для пункта меню.

Обратите внимание, что формат текста похож на это: "Текст меню\tБыстрый вызов".

Если у пункта меню нет быстрого вызова, он будет содержать только текст пункта меню. Значение по умолчанию — пустая строка.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.11/qstyleoptionmenuitem.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API