En esta página

QStyleOptionHeader Class

La clase QStyleOptionHeader se utiliza para describir los parámetros para dibujar un encabezado. Más...

Cabecera: #include <QStyleOptionHeader>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: QStyleOption
Heredado por:

QStyleOptionHeaderV2

Tipos Públicos

enum SectionPosition { Beginning, Middle, End, OnlyOneSection }
enum SelectedPosition { NotAdjacent, NextIsSelected, PreviousIsSelected, NextAndPreviousAreSelected }
enum SortIndicator { None, SortUp, SortDown }
enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Funciones Públicas

QStyleOptionHeader()
QStyleOptionHeader(const QStyleOptionHeader &other)

Variables públicas

QIcon icon
Qt::Alignment iconAlignment
Qt::Orientation orientation
QStyleOptionHeader::SectionPosition position
int section
QStyleOptionHeader::SelectedPosition selectedPosition
QStyleOptionHeader::SortIndicator sortIndicator
QString text
Qt::Alignment textAlignment

Descripción Detallada

QStyleOptionHeader contiene toda la información que las funciones de QStyle necesitan para dibujar el panel de cabecera de las vistas de elementos, la flecha de ordenación de cabecera y la etiqueta de cabecera.

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 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.

Documentación de los tipos miembros

enum QStyleOptionHeader::SectionPosition

Este enum le permite saber cuál es la posición de la sección en relación con las demás secciones.

ConstanteValorDescripción
QStyleOptionHeader::Beginning0Al principio de la cabecera
QStyleOptionHeader::Middle1En medio de la cabecera
QStyleOptionHeader::End2Al final de la cabecera
QStyleOptionHeader::OnlyOneSection3Sólo una sección de cabecera

Véase también position.

enum QStyleOptionHeader::SelectedPosition

Este enum le permite saber cuál es la posición de la sección en relación con la sección seleccionada.

ConstanteValorDescripción
QStyleOptionHeader::NotAdjacent0No adyacente a la sección seleccionada
QStyleOptionHeader::NextIsSelected1Se selecciona la sección siguiente
QStyleOptionHeader::PreviousIsSelected2Se selecciona la sección anterior
QStyleOptionHeader::NextAndPreviousAreSelected3Se seleccionan tanto la sección siguiente como la anterior

Véase también selectedPosition.

enum QStyleOptionHeader::SortIndicator

Indica en qué dirección debe dibujarse el indicador de clasificación

ConstanteValorDescripción
QStyleOptionHeader::None0No se necesita indicador de ordenación
QStyleOptionHeader::SortUp1Dibujar un indicador hacia arriba
QStyleOptionHeader::SortDown2Dibujar un indicador descendente

Véase también sortIndicator.

enum QStyleOptionHeader::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.

ConstanteValorDescripción
QStyleOptionHeader::TypeSO_HeaderEl tipo de opción de estilo proporcionada (SO_Header 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 QStyleOptionHeader::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.

ConstanteValorDescripción
QStyleOptionHeader::Version11

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.

Véase también StyleOptionType.

Documentación de funciones miembro

QStyleOptionHeader::QStyleOptionHeader()

Construye un QStyleOptionHeader, inicializando las variables miembros a sus valores por defecto.

QStyleOptionHeader::QStyleOptionHeader(const QStyleOptionHeader &other)

Construye una copia de la opción de estilo other.

Documentación de la variable miembro

QIcon QStyleOptionHeader::icon

Esta variable contiene el icono de la cabecera

El valor por defecto es un icono vacío, es decir, un icono sin mapa de píxeles ni nombre de archivo.

Qt::Alignment QStyleOptionHeader::iconAlignment

Esta variable contiene las banderas de alineación para el icono de la cabecera

El valor por defecto es Qt::AlignLeft.

Qt::Orientation QStyleOptionHeader::orientation

Esta variable contiene la orientación de la cabecera (horizontal o vertical)

La orientación por defecto es Qt::Horizontal

QStyleOptionHeader::SectionPosition QStyleOptionHeader::position

Esta variable mantiene la posición de la sección en relación con las demás secciones

El valor por defecto es QStyleOptionHeader::Beginning.

int QStyleOptionHeader::section

Esta variable indica qué sección de la cabecera se está pintando.

El valor por defecto es 0.

QStyleOptionHeader::SelectedPosition QStyleOptionHeader::selectedPosition

Esta variable contiene la posición de la sección en relación con la sección seleccionada.

El valor por defecto es QStyleOptionHeader::NotAdjacent

QStyleOptionHeader::SortIndicator QStyleOptionHeader::sortIndicator

Esta variable contiene la dirección en la que debe dibujarse el indicador de ordenación

El valor por defecto es QStyleOptionHeader::None.

QString QStyleOptionHeader::text

Esta variable contiene el texto de la cabecera

El valor por defecto es una cadena vacía.

Qt::Alignment QStyleOptionHeader::textAlignment

Esta variable contiene las banderas de alineación para el texto de la cabecera

El valor por defecto es Qt::AlignLeft.

© 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.