Класс QStyleOptionMenuItem

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

Заголовок:	#include <QStyleOptionMenuItem>
qmake:	QT += widgets
Наследуется от:	QStyleOption

Список всех членов, включая унаследованные

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

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

Публичные функции

	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::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::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.15/qstyleoptionmenuitem.html