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