En esta página

QStyleOptionViewItem Class

La clase `QStyleOptionViewItem` se utiliza para describir los parámetros que se emplean para dibujar un elemento en un widget de vista. Más información...

Encabezado: #include <QStyleOptionViewItem>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QStyleOption

Tipos públicos

enum Position { Left, Right, Top, Bottom }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }
enum ViewItemFeature { None, WrapText, Alternate, HasCheckIndicator, HasDisplay, …, IsDecorationForRootColumn }
flags ViewItemFeatures
enum ViewItemPosition { Invalid, Beginning, Middle, End, OnlyOne }

Funciones públicas

QStyleOptionViewItem()
QStyleOptionViewItem(const QStyleOptionViewItem &other)
QStyleOptionViewItem &operator=(const QStyleOptionViewItem &)

Variables públicas

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

Descripción detallada

QStyleOptionViewItem contiene toda la información que necesitan las funciones de « QStyle » para dibujar los elementos de las clases de modelo/vista de Qt.

Por motivos de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, mediante los operadores « . » o « -> »). Esto hace que las estructuras sean fáciles de usar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.

Véase también QStyleOption y Programación de modelo/vista.

Documentación sobre los tipos de miembro

enum QStyleOptionViewItem::Position

Esta enumeración describe la posición de la decoración del elemento.

ConstanteValorDescripción
QStyleOptionViewItem::Left0A la izquierda del texto.
QStyleOptionViewItem::Right1A la derecha del texto.
QStyleOptionViewItem::Top2Por encima del texto.
QStyleOptionViewItem::Bottom3Debajo del texto.

Véase también « decorationPosition ».

enum QStyleOptionViewItem::StyleOptionType

Esta enumeración se utiliza para almacenar información sobre el tipo de la opción de estilo y se define para cada subclase de ` QStyleOption `.

ConstanteValorDescripción
QStyleOptionViewItem::TypeSO_ViewItemEl tipo de opción de estilo proporcionada (SO_ViewItem para esta clase).

El tipo lo utilizan internamente ` QStyleOption`, sus subclases y ` qstyleoption_cast()` para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de ` QStyleOption ` y tus propios estilos.

Véase también StyleOptionVersion.

enum QStyleOptionViewItem::StyleOptionVersion

Esta enumeración se utiliza para almacenar información sobre la versión de la opción de estilo y se define para cada subclase de ` QStyleOption `.

ConstanteValorDescripción
QStyleOptionViewItem::Version14

Las subclases de ` QStyleOption ` utilizan esta versión para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario que la compruebes.

Véase también StyleOptionType.

enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures

Esta enumeración describe los diferentes tipos de características que puede tener un elemento.

ConstanteValorDescripción
QStyleOptionViewItem::None0x00Indica un elemento normal.
QStyleOptionViewItem::WrapText0x01Indica un elemento con texto ajustado.
QStyleOptionViewItem::Alternate0x02Indica que el fondo del elemento se representa utilizando alternateBase.
QStyleOptionViewItem::HasCheckIndicator0x04Indica que el elemento tiene un indicador de estado de selección.
QStyleOptionViewItem::HasDisplay0x08Indica que el elemento tiene una función de visualización.
QStyleOptionViewItem::HasDecoration0x10Indica que el elemento tiene una función de decoración.
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9)0x20Indica que el elemento tiene una parte de rama de la vista de árbol para dibujar.
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9)0x40Indica que el elemento contiene la información necesaria para dibujar la parte de rama de la vista de árbol.

El tipo `ViewItemFeatures` es un `typedef` para ` QFlags<ViewItemFeature>`. Almacena una combinación OR de valores de `ViewItemFeature`.

enum QStyleOptionViewItem::ViewItemPosition

Esta enumeración se utiliza para representar la posición del elemento en una fila. Se puede utilizar para dibujar los elementos de forma diferente según su posición; por ejemplo, colocando bordes redondeados al principio y al final, y bordes rectos en el medio.

ConstanteValorDescripción
QStyleOptionViewItem::Invalid0La posición del elemento (ViewItemPosition) es desconocida y debe ignorarse.
QStyleOptionViewItem::Beginning1El elemento aparece al principio de la fila.
QStyleOptionViewItem::Middle2El elemento aparece en el centro de la fila.
QStyleOptionViewItem::End3El elemento aparece al final de la fila.
QStyleOptionViewItem::OnlyOne4El elemento es el único de la fila y, por lo tanto, se encuentra tanto al principio como al final.

Documentación de funciones de miembro

QStyleOptionViewItem::QStyleOptionViewItem()

Crea un objeto `QStyleOptionViewItem`, inicializando las variables de miembro con sus valores por defecto.

QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)

Crea una copia de la opción de estilo « other ».

[noexcept default] QStyleOptionViewItem &QStyleOptionViewItem::operator=(const QStyleOptionViewItem &)

Asigna por copia ` other ` a esta instancia de ` QStyleOptionViewItem `.

Documentación de variables de miembro

QBrush QStyleOptionViewItem::backgroundBrush

El objeto ` QBrush ` que debe utilizarse para pintar el fondo de los elementos de la vista.

Qt::CheckState QStyleOptionViewItem::checkState

Si este elemento de la vista se puede marcar, es decir, si ` ViewItemFeature::HasCheckIndicator ` es verdadero, ` checkState ` es verdadero si el elemento está marcado; en caso contrario, es falso.

Qt::Alignment QStyleOptionViewItem::decorationAlignment

Esta variable contiene la alineación de la decoración del elemento

El valor por defecto es « Qt::AlignLeft ».

QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition

Esta variable contiene la posición de la decoración del elemento

El valor por defecto es Left.

Véase también Position.

QSize QStyleOptionViewItem::decorationSize

Esta variable contiene el tamaño de la decoración del elemento

El valor por defecto es QSize(-1, -1), es decir, un tamaño no válido.

Véase también decorationAlignment y decorationPosition.

Qt::Alignment QStyleOptionViewItem::displayAlignment

Esta variable contiene la alineación del valor que se muestra para el elemento

El valor por defecto es « Qt::AlignLeft ».

QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features

Esta variable contiene una operación OR bit a bit de las características que describen este elemento de la vista

Véase también ViewItemFeature.

QFont QStyleOptionViewItem::font

Esta variable contiene la fuente utilizada para el elemento

Por defecto, se utiliza la fuente predeterminada de la aplicación.

Véase también QFont.

QIcon QStyleOptionViewItem::icon

El icono (si lo hay) que se va a dibujar en el elemento de la vista.

QModelIndex QStyleOptionViewItem::index

El índice del modelo que se va a trazar.

QLocale QStyleOptionViewItem::locale

Esta variable contiene la configuración regional que se utilizará para mostrar texto, números y fechas.

Esto permite que el estilo muestre, por ejemplo, las fechas en una configuración regional diferente a la predeterminada de la aplicación.

bool QStyleOptionViewItem::showDecorationSelected

Esta variable indica si se debe resaltar la decoración en los elementos seleccionados

Si esta opción es «true», la rama y cualquier decoración de los elementos seleccionados deben resaltarse, indicando que el elemento está seleccionado; de lo contrario, no es necesario resaltarlo. El valor por defecto es «false».

Véase también QStyle::SH_ItemView_ShowDecorationSelected y QAbstractItemView.

QString QStyleOptionViewItem::text

El texto (si lo hay) que se va a dibujar en el elemento de vista.

Qt::TextElideMode QStyleOptionViewItem::textElideMode

donde se debe añadir una elipsis cuando el texto es demasiado largo para caber en una entrada

El valor por defecto es Qt::ElideMiddle, es decir, los puntos suspensivos aparecen en medio del texto.

Véase también Qt::TextElideMode y QStyle::SH_ItemView_EllipsisLocation.

QStyleOptionViewItem::ViewItemPosition QStyleOptionViewItem::viewItemPosition

Indica la posición de este elemento de la vista en relación con otros elementos. Consulta la enumeración « ViewItemPosition » para obtener más detalles.

const QWidget *QStyleOptionViewItem::widget

Esta variable contiene el widget padre del elemento

Este miembro contiene el widget padre (itemview) del elemento para poder, por ejemplo, acceder a algunas propiedades dentro de los métodos QStyledItemDelegate.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.