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.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionViewItem::Left | 0 | A la izquierda del texto. |
QStyleOptionViewItem::Right | 1 | A la derecha del texto. |
QStyleOptionViewItem::Top | 2 | Por encima del texto. |
QStyleOptionViewItem::Bottom | 3 | Debajo 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 `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionViewItem::Type | SO_ViewItem | El 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 `.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionViewItem::Version | 1 | 4 |
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.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | Indica un elemento normal. |
QStyleOptionViewItem::WrapText | 0x01 | Indica un elemento con texto ajustado. |
QStyleOptionViewItem::Alternate | 0x02 | Indica que el fondo del elemento se representa utilizando alternateBase. |
QStyleOptionViewItem::HasCheckIndicator | 0x04 | Indica que el elemento tiene un indicador de estado de selección. |
QStyleOptionViewItem::HasDisplay | 0x08 | Indica que el elemento tiene una función de visualización. |
QStyleOptionViewItem::HasDecoration | 0x10 | Indica que el elemento tiene una función de decoración. |
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9) | 0x20 | Indica que el elemento tiene una parte de rama de la vista de árbol para dibujar. |
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9) | 0x40 | Indica 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.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | La posición del elemento (ViewItemPosition) es desconocida y debe ignorarse. |
QStyleOptionViewItem::Beginning | 1 | El elemento aparece al principio de la fila. |
QStyleOptionViewItem::Middle | 2 | El elemento aparece en el centro de la fila. |
QStyleOptionViewItem::End | 3 | El elemento aparece al final de la fila. |
QStyleOptionViewItem::OnlyOne | 4 | El 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.