QStyleOptionViewItem Class
La clase QStyleOptionViewItem se utiliza para describir los parámetros utilizados para dibujar un elemento en un widget de vista. Más...
| Cabecera: | #include <QStyleOptionViewItem> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Hereda: | 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) |
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 las funciones de QStyle necesitan para dibujar los elementos de las clases modelo/vista de Qt.
Por razones de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, utilizando el operador . o -> ). Esto hace que las estructuras sean sencillas de utilizar 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 Modelo/Vista.
Documentación de los tipos de miembros
enum QStyleOptionViewItem::Position
Este enum 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 | Encima del texto. |
QStyleOptionViewItem::Bottom | 3 | Debajo del texto. |
Véase también decorationPosition.
enum QStyleOptionViewItem::StyleOptionType
Este enum se utiliza para guardar 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 es utilizado internamente por QStyleOption, sus subclases y qstyleoption_cast() para determinar el tipo de opción de estilo. En general no necesitas preocuparte por esto a menos que quieras crear tu propia subclase QStyleOption y tus propios estilos.
Véase también StyleOptionVersion.
enum QStyleOptionViewItem::StyleOptionVersion
Este enum se utiliza para guardar 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 |
La versión es utilizada por las subclases de QStyleOption para implementar extensiones sin romper la compatibilidad. Si utiliza qstyleoption_cast(), normalmente no necesita comprobarla.
Ver también StyleOptionType.
enum QStyleOptionViewItem::ViewItemFeature
flags QStyleOptionViewItem::ViewItemFeatures
Este enum describe los diferentes tipos de características que puede tener un ítem.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionViewItem::None | 0x00 | Indica un elemento normal. |
QStyleOptionViewItem::WrapText | 0x01 | Indica un elemento con texto envuelto. |
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 comprobación. |
QStyleOptionViewItem::HasDisplay | 0x08 | Indica que el elemento tiene una función de visualización. |
QStyleOptionViewItem::HasDecoration | 0x10 | Indica que el elemento tiene un rol de decoración. |
QStyleOptionViewItem::IsDecoratedRootColumn (since Qt 6.9) | 0x20 | Indica que el elemento tiene una parte de rama de vista de árbol para pintar. |
QStyleOptionViewItem::IsDecorationForRootColumn (since Qt 6.9) | 0x40 | Indica que el elemento contiene la información para dibujar la parte de la rama de la vista en árbol. |
El tipo ViewItemFeatures es un typedef para QFlags<ViewItemFeature>. Almacena una combinación OR de valores ViewItemFeature.
enum QStyleOptionViewItem::ViewItemPosition
Este enum se utiliza para representar la colocación del elemento en una fila. Se puede utilizar para dibujar elementos de forma diferente dependiendo de su colocación, por ejemplo poniendo bordes redondeados al principio y al final, y bordes rectos en medio.
| Constante | Valor | Descripción |
|---|---|---|
QStyleOptionViewItem::Invalid | 0 | ViewItemPosition es desconocida y no debe tenerse en cuenta. |
QStyleOptionViewItem::Beginning | 1 | El elemento aparece al principio de la fila. |
QStyleOptionViewItem::Middle | 2 | El elemento aparece en medio 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, está tanto al principio como al final. |
Documentación de las funciones miembro
QStyleOptionViewItem::QStyleOptionViewItem()
Construye un QStyleOptionViewItem, inicializando las variables miembros a sus valores por defecto.
QStyleOptionViewItem::QStyleOptionViewItem(const QStyleOptionViewItem &other)
Construye una copia de la opción de estilo other.
Documentación de la variable miembro
QBrush QStyleOptionViewItem::backgroundBrush
El QBrush que debe utilizarse para pintar el fondo de los elementos de la vista.
Qt::CheckState QStyleOptionViewItem::checkState
Si este elemento de la vista es comprobable, es decir, ViewItemFeature::HasCheckIndicator es verdadero, checkState es verdadero si se comprueba el elemento; de lo contrario, es falso.
Qt::Alignment QStyleOptionViewItem::decorationAlignment
Esta variable contiene la alineación de la decoración para el elemento
El valor por defecto es Qt::AlignLeft.
QStyleOptionViewItem::Position QStyleOptionViewItem::decorationPosition
Esta variable contiene la posición de la decoración para el 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 para el 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 de visualización del elemento
El valor por defecto es Qt::AlignLeft.
QStyleOptionViewItem::ViewItemFeatures QStyleOptionViewItem::features
Esta variable contiene un bitwise OR 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 por defecto de la aplicación.
Véase también QFont.
QIcon QStyleOptionViewItem::icon
El icono (si lo hay) que se dibujará en el elemento de la vista.
QModelIndex QStyleOptionViewItem::index
El índice del modelo que se va a dibujar.
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 configuración regional predeterminada de la aplicación.
bool QStyleOptionViewItem::showDecorationSelected
Esta variable indica si la decoración debe resaltarse en los elementos seleccionados.
Si esta opción es verdadera, 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 dibujará en el elemento de la vista.
Qt::TextElideMode QStyleOptionViewItem::textElideMode
dónde debe añadirse la elipsis para el texto demasiado largo para caber en un artículo.
El valor por defecto es Qt::ElideMiddle, es decir, la elipsis aparece 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. Consulte el enum ViewItemPosition para más detalles.
const QWidget *QStyleOptionViewItem::widget
Esta variable contiene el widget padre del ítem
Este miembro contiene el widget padre (itemview) del elemento para poder, por ejemplo, acceder a algunas propiedades dentro de los métodos de 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.
