Класс QStyleOptionViewItem
Класс QStyleOptionViewItem используется для описания параметров, используемых для отрисовки элемента в виджете представления. Подробнее...
| Заголовок: | #include <QStyleOptionViewItem> |
| qmake: | QT += widgets |
| Наследует: | QStyleOption |
Открытые типы
| перечисление | Position { Left, Right, Top, Bottom } |
| перечисление | StyleOptionType { Type } |
| перечисление | StyleOptionVersion { Version } |
| перечисление | ViewItemFeature { None, WrapText, Alternate, HasCheckIndicator, HasDisplay, HasDecoration } |
| флаги | ViewItemFeatures |
| перечисление | ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne } |
Открытые функции
| QStyleOptionViewItem() | |
| QStyleOptionViewItem(const QStyleOptionViewItem &other) |
- 2 открытых функции унаследованы от QStyleOption
Открытые переменные
| QBrush | backgroundBrush |
| Qt::CheckState | checkState |
| Qt::Alignment | decorationAlignment |
| QStyleOptionViewItem::Position | decorationPosition |
| QSize | decorationSize |
| Qt::Alignment | displayAlignment |
| QStyleOptionViewItem::ViewItemFeatures | features |
| QFont | font |
| QIcon | icon |
| QModelIndex | index |
| QLocale | locale |
| bool | showDecorationSelected |
| QString | text |
| Qt::TextElideMode | textElideMode |
| QStyleOptionViewItem::ViewItemPosition | viewItemPosition |
| const QWidget * | widget |
Подробное описание
Класс QStyleOptionViewItem используется для описания параметров, используемых для отрисовки элемента в виджете представления.
QStyleOptionViewItem содержит всю информацию, необходимую функциям QStyle для отрисовки элементов для классов модели/представления Qt.
В целях производительности доступ к переменным-членам осуществляется напрямую (т. е. с использованием оператора . или ->). Этот низкоуровневый подход делает структуры простыми в использовании и подчеркивает, что это просто параметры, используемые функциями стиля.
Пример использования параметров стиля см. в примере Styles.
См. также QStyleOption и Программирование модели/представления.
Документация по типам членов
перечисление QStyleOptionViewItem::Position
Это перечисление описывает положение декорации элемента.
| Постоянная | Значение | Описание |
|---|---|---|
QStyleOptionViewItem::Left |
0 |
Слева от текста. |
QStyleOptionViewItem::Right |
1 |
Справа от текста. |
QStyleOptionViewItem::Top |
2 |
Над текстом. |
QStyleOptionViewItem::Bottom |
3 |
Под текстом. |
См. также decorationPosition.
перечисление QStyleOptionViewItem::StyleOptionType
Это перечисление используется для хранения информации о типе параметра стиля и определено для каждого подкласса QStyleOption.
| Постоянная | Значение | Описание |
|---|---|---|
QStyleOptionViewItem::Type |
SO_ViewItem |
Тип предоставляемого параметра стиля (SO_ViewItem для этого класса). |
Тип используется внутри QStyleOption, его подклассами и qstyleoption_cast() для определения типа параметра стиля. Как правило, вам об этом не нужно беспокоиться, если вы не хотите создать свой собственный подкласс QStyleOption и свой собственный стиль.
См. также StyleOptionVersion.
перечисление QStyleOptionViewItem::StyleOptionVersion
Это перечисление используется для хранения информации о версии параметра стиля, и определено для каждого подкласса QStyleOption.
| Постоянная | Значение | Описание |
|---|---|---|
QStyleOptionViewItem::Version |
4 |
4 |
Версия используется подклассами QStyleOption для реализации расширений без нарушения совместимости. Если вы используете qstyleoption_cast(), обычно проверять её не нужно.
См. также StyleOptionType.
перечисление QStyleOptionViewItem::ViewItemFeatureфлаги QStyleOptionViewItem::ViewItemFeatures
Это перечисление описывает различные типы функций, которыми может обладать элемент.
| Постоянная | Значение | Описание |
|---|---|---|
QStyleOptionViewItem::None |
0x00 |
Указывает на обычный элемент. |
QStyleOptionViewItem::WrapText |
0x01 |
Указывает на элемент с переносным текстом. |
QStyleOptionViewItem::Alternate |
0x02 |
Указывает, что фон элемента отрисовывается с использованием alternateBase. |
QStyleOptionViewItem::HasCheckIndicator |
0x04 |
Указывает, что элемент имеет индикатор состояния выбора. |
QStyleOptionViewItem::HasDisplay |
0x08 |
Указывает, что элемент имеет роль отображения. |
QStyleOptionViewItem::HasDecoration |
0x10 |
Указывает, что элемент имеет роль декорации. |
Тип ViewItemFeatures является псевдонимом для QFlags<ViewItemFeature>. Он хранит логическое ИЛИ комбинацию значений ViewItemFeature.
enum QStyleOptionViewItem::ViewItemPosition
Этот перечисление используется для представления расположения элемента в строке. Это можно использовать для отображения элементов по-разному в зависимости от их расположения, например, путем добавления закруглённых краёв в начале и конце, и прямых краёв между ними.
| Постоянная | Значение | Описание |
|---|---|---|
QStyleOptionViewItem::Invalid |
0 |
Положение ViewItemPosition неизвестно и должно быть проигнорировано. |
QStyleOptionViewItem::Beginning |
1 |
Элемент находится в начале строки. |
QStyleOptionViewItem::Middle |
2 |
Элемент находится посередине строки. |
QStyleOptionViewItem::End |
3 |
Элемент находится в конце строки. |
QStyleOptionViewItem::OnlyOne |
4 |
Элемент является единственным в строке и, следовательно, находится как в начале, так и в конце. |
Документация по функциям-членам
QStyleOptionViewItem::QStyleOptionViewItem()
Создает QStyleOptionViewItem, инициализируя переменные-члены их значениями по умолчанию.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
Создает копию опции стиля other.
Документация по переменным-членам
QBrush QStyleOptionViewItem::backgroundBrush
Щётка QBrush, которая должна использоваться для рисования фона элементов представления.
Qt::CheckState QStyleOptionViewItem::checkState
Если элемент представления можно выбрать, т.е. ViewItemFeature::HasCheckIndicator равен true, checkState равен true, если элемент выбран; в противном случае он равен false.
Qt::Alignment QStyleOptionViewItem::decorationAlignment
Эта переменная хранит выравнивание декорации для элемента.
Значение по умолчанию — Qt::AlignLeft.
QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
Эта переменная хранит положение декорации для элемента.
Значение по умолчанию — Left.
См. также Position.
QSize QStyleOptionViewItem::decorationSize
Эта переменная хранит размер декорации для элемента.
Значение по умолчанию — QSize(-1, -1), т.е. недействительный размер.
См. также decorationAlignment и decorationPosition.
Qt::Alignment QStyleOptionViewItem::displayAlignment
Эта переменная хранит выравнивание отображаемого значения для элемента.
Значение по умолчанию — Qt::AlignLeft.
QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
Эта переменная хранит битовую ИЛИ комбинацию признаков, которые описывают этот элемент представления.
См. также ViewItemFeature.
QFont QStyleOptionViewItem::font
Эта переменная хранит шрифт, используемый для элемента.
По умолчанию используется шрифт по умолчанию приложения.
См. также QFont.
QIcon QStyleOptionViewItem::icon
Иконка (если есть) для отображения в элементе представления.
QModelIndex QStyleOptionViewItem::index
Индекс модели, который должен быть нарисован.
bool QStyleOptionViewItem::showDecorationSelected
Эта переменная указывает, следует ли выделять декорацию для выделенных элементов.
Если этот параметр равен true, ветвь и любые декорации выделенных элементов должны быть выделены, указывая, что элемент выбран; в противном случае выделение не требуется. Значение по умолчанию — false.
См. также QStyle::SH_ItemView_ShowDecorationSelected и QAbstractItemView.
QString QStyleOptionViewItem::text
Текст (если есть) для отображения в элементе представления.
Qt::TextElideMode QStyleOptionViewItem::textElideMode
место, куда должна быть добавлена многоточие для текста, который слишком длинный, чтобы поместиться в элемент
Значение по умолчанию — Qt::ElideMiddle, т.е. многоточие появляется посередине текста.
См. также Qt::TextElideMode и QStyle::SH_ItemView_EllipsisLocation.
QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition
Указывает положение этого элемента представления относительно других элементов. Подробнее см. перечисление ViewItemPosition.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.12/qstyleoptionviewitem.html
