En esta página

QStyleOptionHeader Class

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

Encabezado: #include <QStyleOptionHeader>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: 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)
QStyleOptionHeader &operator=(const QStyleOptionHeader &)

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 necesitan las funciones de « QStyle » para dibujar el panel de encabezado, la flecha de ordenación del encabezado y la etiqueta del encabezado de las vistas de los elementos.

Por motivos de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, mediante 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 sobre los tipos de miembros

enum QStyleOptionHeader::SectionPosition

Esta enumeración te 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 del encabezado
QStyleOptionHeader::Middle1En el centro de la cabecera
QStyleOptionHeader::End2Al final del encabezado
QStyleOptionHeader::OnlyOneSection3Solo una sección de encabezado

Véase también position.

enum QStyleOptionHeader::SelectedPosition

Esta enumeración te permite saber cuál es la posición de la sección en relación con la sección seleccionada.

ConstanteValorDescripción
QStyleOptionHeader::NotAdjacent0No está adyacente a la sección seleccionada
QStyleOptionHeader::NextIsSelected1La siguiente sección está seleccionada
QStyleOptionHeader::PreviousIsSelected2La sección anterior está seleccionada
QStyleOptionHeader::NextAndPreviousAreSelected3Están seleccionadas 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 ordenación

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

Véase también sortIndicator.

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

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.

Documentación de funciones miembro

QStyleOptionHeader::QStyleOptionHeader()

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

QStyleOptionHeader::QStyleOptionHeader(const QStyleOptionHeader &other)

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

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

Asigna por copia other a esta instancia de QStyleOptionHeader.

Documentación de variables de miembro

QIcon QStyleOptionHeader::icon

Esta variable contiene el icono del encabezado

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

Qt::Alignment QStyleOptionHeader::iconAlignment

Esta variable contiene los indicadores de alineación del icono del encabezado

El valor por defecto es Qt::AlignLeft.

Qt::Orientation QStyleOptionHeader::orientation

Esta variable contiene la orientación del encabezado (horizontal o vertical)

La orientación predeterminada es Qt::Horizontal

QStyleOptionHeader::SectionPosition QStyleOptionHeader::position

Esta variable contiene la posición de la sección con respecto a las demás secciones

El valor por defecto es QStyleOptionHeader::Beginning.

int QStyleOptionHeader::section

Esta variable indica qué sección del encabezado se está dibujando

El valor por defecto es 0.

QStyleOptionHeader::SelectedPosition QStyleOptionHeader::selectedPosition

Esta variable contiene la posición de la sección con respecto a 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 del encabezado

El valor por defecto es una cadena vacía.

Qt::Alignment QStyleOptionHeader::textAlignment

Esta variable contiene los indicadores de alineación del texto del encabezado

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.