En esta página

QHeaderView Class

La clase QHeaderView proporciona una fila o columna de encabezado para las vistas de elementos. Más información...

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

Tipos públicos

enum ResizeMode { Interactive, Fixed, Stretch, ResizeToContents, Custom }

Propiedades

Funciones públicas

QHeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)
virtual ~QHeaderView()
bool cascadingSectionResizes() const
int count() const
Qt::Alignment defaultAlignment() const
int defaultSectionSize() const
int hiddenSectionCount() const
void hideSection(int logicalIndex)
bool highlightSections() const
bool isFirstSectionMovable() const
bool isSectionHidden(int logicalIndex) const
bool isSortIndicatorClearable() const
bool isSortIndicatorShown() const
int length() const
int logicalIndex(int visualIndex) const
int logicalIndexAt(const QPoint &pos) const
int logicalIndexAt(int position) const
int logicalIndexAt(int x, int y) const
int maximumSectionSize() const
int minimumSectionSize() const
void moveSection(int from, int to)
int offset() const
Qt::Orientation orientation() const
void resetDefaultSectionSize()
int resizeContentsPrecision() const
void resizeSection(int logicalIndex, int size)
void resizeSections(QHeaderView::ResizeMode mode)
bool restoreState(const QByteArray &state)
QByteArray saveState() const
int sectionPosition(int logicalIndex) const
QHeaderView::ResizeMode sectionResizeMode(int logicalIndex) const
int sectionSize(int logicalIndex) const
int sectionSizeHint(int logicalIndex) const
int sectionViewportPosition(int logicalIndex) const
bool sectionsClickable() const
bool sectionsHidden() const
bool sectionsMovable() const
bool sectionsMoved() const
void setCascadingSectionResizes(bool enable)
void setDefaultAlignment(Qt::Alignment alignment)
void setDefaultSectionSize(int size)
void setFirstSectionMovable(bool movable)
void setHighlightSections(bool highlight)
void setMaximumSectionSize(int size)
void setMinimumSectionSize(int size)
void setResizeContentsPrecision(int precision)
void setSectionHidden(int logicalIndex, bool hide)
void setSectionResizeMode(QHeaderView::ResizeMode mode)
void setSectionResizeMode(int logicalIndex, QHeaderView::ResizeMode mode)
void setSectionsClickable(bool clickable)
void setSectionsMovable(bool movable)
void setSortIndicator(int logicalIndex, Qt::SortOrder order)
void setSortIndicatorClearable(bool clearable)
void setSortIndicatorShown(bool show)
void setStretchLastSection(bool stretch)
void showSection(int logicalIndex)
Qt::SortOrder sortIndicatorOrder() const
int sortIndicatorSection() const
bool stretchLastSection() const
int stretchSectionCount() const
void swapSections(int first, int second)
int visualIndex(int logicalIndex) const
int visualIndexAt(int position) const

Funciones públicas reimplementadas

virtual void reset() override
virtual void setModel(QAbstractItemModel *model) override
virtual void setVisible(bool v) override
virtual QSize sizeHint() const override

Ranuras públicas

void headerDataChanged(Qt::Orientation orientation, int logicalFirst, int logicalLast)
void setOffset(int offset)
void setOffsetToLastSection()
void setOffsetToSectionPosition(int visualSectionNumber)

Señales

void geometriesChanged()
void sectionClicked(int logicalIndex)
void sectionCountChanged(int oldCount, int newCount)
void sectionDoubleClicked(int logicalIndex)
void sectionEntered(int logicalIndex)
void sectionHandleDoubleClicked(int logicalIndex)
void sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex)
void sectionPressed(int logicalIndex)
void sectionResized(int logicalIndex, int oldSize, int newSize)
void sortIndicatorChanged(int logicalIndex, Qt::SortOrder order)
void sortIndicatorClearableChanged(bool clearable)

Funciones protegidas

virtual void initStyleOption(QStyleOptionHeader *option) const
(since 6.0) virtual void initStyleOptionForIndex(QStyleOptionHeader *option, int logicalIndex) const
virtual void paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const
virtual QSize sectionSizeFromContents(int logicalIndex) const

Funciones protegidas reimplementadas

virtual void currentChanged(const QModelIndex &current, const QModelIndex &old) override
virtual bool event(QEvent *e) override
virtual int horizontalOffset() const override
virtual void mouseDoubleClickEvent(QMouseEvent *e) override
virtual void mouseMoveEvent(QMouseEvent *e) override
virtual void mousePressEvent(QMouseEvent *e) override
virtual void mouseReleaseEvent(QMouseEvent *e) override
virtual void paintEvent(QPaintEvent *e) override
virtual void setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags) override
virtual int verticalOffset() const override
virtual bool viewportEvent(QEvent *e) override

Ranuras protegidas

void resizeSections()
void sectionsAboutToBeRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast)
void sectionsInserted(const QModelIndex &parent, int logicalFirst, int logicalLast)

Descripción detallada

Una clase `QHeaderView` muestra los encabezados utilizados en vistas de elementos, como las clases ` QTableView ` y ` QTreeView `. Sustituye a la clase ` QHeader ` de Qt3, que se utilizaba anteriormente con el mismo fin, pero emplea la arquitectura modelo/vista de Qt para garantizar la coherencia con las clases de vista de elementos.

La clase QHeaderView es una de las clases de modelo/vista y forma parte del marco de trabajo de modelo/vista de Qt.

El encabezado obtiene los datos de cada sección del modelo mediante la función QAbstractItemModel::headerData(). Los datos se pueden establecer utilizando QAbstractItemModel::setHeaderData().

Cada encabezado tiene un ` orientation()` y varias secciones, definidas mediante la función ` count()`. Una sección hace referencia a una parte del encabezado: una fila o una columna, dependiendo de la orientación.

Las secciones se pueden mover y redimensionar mediante ` moveSection()` y ` resizeSection()`; también se pueden ocultar y mostrar con ` hideSection()` y ` showSection()`.

Cada sección de un encabezado se describe mediante un identificador de sección, especificado por su función section(), y puede ubicarse en un visualIndex() concreto del encabezado. A una sección se le puede asignar un indicador de ordenación mediante setSortIndicator(); esto indica si los elementos de la vista de elementos asociada se ordenarán según el orden establecido por la sección.

En el caso de un encabezado horizontal, la sección equivale a una columna del modelo, y en el caso de un encabezado vertical, la sección equivale a una fila del modelo.

Desplazamiento de secciones de cabecera

Un encabezado puede fijarse en su posición o hacerse desplazable con ` setSectionsMovable()` (). Se puede hacer clicable con ` setSectionsClickable()`, y su comportamiento de redimensionamiento se ajusta a lo establecido en ` setSectionResizeMode()` ().

Nota: Hacer doble clic en un encabezado para cambiar el tamaño de una sección solo se aplica a las filas visibles.

Un encabezado emitirá sectionMoved() si el usuario mueve una sección, sectionResized() si el usuario cambia el tamaño de una sección, y sectionClicked() así como sectionHandleDoubleClicked() en respuesta a los clics del ratón. Un encabezado también emitirá sectionCountChanged().

Puedes identificar una sección utilizando las funciones logicalIndex() y logicalIndexAt(), o bien por su posición en el índice, utilizando las funciones visualIndex() y visualIndexAt(). El índice visual cambiará si se mueve una sección, pero el índice lógico no variará.

Apariencia

QTableWidget y ` QTableView ` crean encabezados por defecto. Si desea que los encabezados sean visibles, puede utilizar ` setVisible()`.

No todos los « ItemDataRole» tendrán efecto en un QHeaderView. Si necesitas dibujar otros roles, puedes crear una subclase de QHeaderView y reimplementar paintEvent(). QHeaderView respeta los siguientes roles de datos de los elementos, a menos que entren en conflicto con el estilo (lo cual puede ocurrir con los estilos que siguen el tema del escritorio):

TextAlignmentRole, DisplayRole, FontRole, DecorationRole, ForegroundRole y BackgroundRole.

Nota: Cada encabezado representa los datos de cada sección por sí mismo y no depende de un delegado. Por lo tanto, llamar a la función setItemDelegate() de un encabezado no tendrá ningún efecto.

Consideraciones especiales para modelos de gran tamaño

La vista de encabezados utiliza entre 8 y 16 bytes de memoria por sección. Sin embargo, a partir de Qt 6.9, esta memoria por sección solo se utiliza si se cambia el tamaño o se reordena una o más secciones. Esto significa que es posible que un modelo tenga millones de secciones sin que QHeaderView consuma una cantidad proporcional —y, por lo tanto, enorme— de memoria, siempre y cuando no se realicen llamadas a swapSections, resizeSection, hideSection, moveSection y stretchLastSection (que lo habilitan). Para evitar que el usuario realice dichas llamadas, se debe establecer el valor de « resize mode » en « Fixed » (sin especificarlo para ningún índice, ya que eso tendría el efecto contrario). También se debe impedir que el usuario mueva secciones manteniendo desactivada la opción « sectionsMovable ».

Consideraciones de seguridad

La función restoreState() deserializa un blob binario versionado que describe el orden de las columnas, los tamaños de las secciones, el indicador de ordenación y el estado de la vista relacionada. Se validan el número mágico del formato, la versión y la longitud total indicada, pero los índices visuales y lógicos deserializados, así como la sección del indicador de ordenación, no se comparan con el recuento real de secciones del encabezado antes de utilizarse para indexar estructuras de datos internas.

Solo se debe pasar a ` restoreState()` un ` QByteArray ` que haya sido generado previamente por ` saveState()` y persistido por la misma versión —o una compatible— de la aplicación, normalmente mediante un proceso de ida y vuelta a través de ` QSettings`. No llames a restoreState() con datos de origen desconocido o no fiable, como un archivo descargado de la red, un archivo de configuración sincronizado o compartido, o datos proporcionados por otra aplicación que pueda estar comprometida.

Véase también Programación Modelo/Vista, QListView, QTableView, QTreeView, saveState() y restoreState().

Documentación sobre los tipos de miembros

enum QHeaderView::ResizeMode

El modo de redimensionamiento especifica el comportamiento de las secciones del encabezado. Se puede configurar para toda la vista del encabezado o para secciones individuales mediante la función ` setSectionResizeMode()`.

ConstanteValorDescripción
QHeaderView::Interactive0El usuario puede cambiar el tamaño de la sección. El tamaño de la sección también se puede modificar mediante programación utilizando resizeSection(). El tamaño predeterminado de la sección es defaultSectionSize. (Véase también cascadingSectionResizes.)
QHeaderView::Fixed2El usuario no puede cambiar el tamaño de la sección. El tamaño de la sección solo se puede modificar mediante programación utilizando resizeSection(). El tamaño predeterminado de la sección es defaultSectionSize.
QHeaderView::Stretch1QHeaderView ajustará automáticamente el tamaño de la sección para ocupar todo el espacio disponible. El usuario no puede modificar el tamaño ni mediante programación.
QHeaderView::ResizeToContents3QHeaderView ajustará automáticamente el tamaño de la sección a su tamaño óptimo en función del contenido de toda la columna o fila. El usuario no puede cambiar el tamaño, ni tampoco mediante programación. (Este valor se introdujo en la versión 4.2)

Los siguientes valores han quedado obsoletos:

ConstanteValorDescripción
QHeaderView::CustomFixedUtiliza «Fixed» en su lugar.

Véase también setSectionResizeMode(), stretchLastSection y minimumSectionSize.

Documentación de la propiedad

cascadingSectionResizes : bool

Esta propiedad determina si el cambio de tamaño interactivo se aplicará en cascada a las secciones siguientes una vez que la sección cuyo tamaño está modificando el usuario haya alcanzado su tamaño mínimo

Esta propiedad solo afecta a las secciones cuyo modo de redimensionamiento sea « Interactive ».

El valor por defecto es «false».

Funciones de acceso:

bool cascadingSectionResizes() const
void setCascadingSectionResizes(bool enable)

Véase también ` setSectionResizeMode()`.

defaultAlignment : Qt::Alignment

Esta propiedad establece la alineación predeterminada del texto en cada sección de encabezado

Funciones de Access:

Qt::Alignment defaultAlignment() const
void setDefaultAlignment(Qt::Alignment alignment)

defaultSectionSize : int

Esta propiedad almacena el tamaño predeterminado de las secciones del encabezado antes de cambiar su tamaño.

Esta propiedad solo afecta a las secciones cuyo modo de redimensionamiento sea « Interactive » o « Fixed ».

Por defecto, el valor de esta propiedad depende del estilo. Por lo tanto, cuando el estilo cambia, esta propiedad se actualiza en función de él. Al llamar a setDefaultSectionSize() se detienen las actualizaciones, mientras que al llamar a resetDefaultSectionSize() se restablece el comportamiento por defecto.

Funciones de acceso:

int defaultSectionSize() const
void setDefaultSectionSize(int size)
void resetDefaultSectionSize()

Véase también setSectionResizeMode() y minimumSectionSize.

firstSectionMovable : bool

Esta propiedad determina si el usuario puede mover la primera columna

Esta propiedad controla si el usuario puede mover la primera columna. En una lista plana ( QTreeView), la primera columna contiene la estructura de árbol y, por lo tanto, no se puede mover de forma predeterminada, ni siquiera tras establecer « setSectionsMovable » (true).

Se puede volver a hacer movible, por ejemplo, en el caso de listas planas sin estructura de árbol, llamando a este método. En tal caso, se recomienda llamar también a ` QTreeView::setRootIsDecorated(false)`.

treeView->setRootIsDecorated(false);
treeView->header()->setFirstSectionMovable(true);

Establecerlo en «true» no tiene ningún efecto a menos que también se llame a « setSectionsMovable » (true).

Funciones de acceso:

bool isFirstSectionMovable() const
void setFirstSectionMovable(bool movable)

Véase también ` setSectionsMovable()`.

highlightSections : bool

Esta propiedad indica si las secciones que contienen los elementos seleccionados están resaltadas

Por defecto, esta propiedad tiene el valor « false ».

Funciones de Access:

bool highlightSections() const
void setHighlightSections(bool highlight)

maximumSectionSize : int

Esta propiedad establece el tamaño máximo de las secciones de encabezado.

El tamaño máximo de sección es el mayor tamaño permitido para una sección. El valor por defecto de esta propiedad es 1048575, que es también el mayor tamaño posible para una sección. Si se establece el valor máximo en -1, el valor se restablecerá al tamaño máximo de sección.

A excepción de «stretch», esta propiedad es respetada por todas las resize modes

funciones de Access:

int maximumSectionSize() const
void setMaximumSectionSize(int size)

Véase también « setSectionResizeMode()» y « defaultSectionSize ».

minimumSectionSize : int

Esta propiedad establece el tamaño mínimo de las secciones del encabezado.

El tamaño mínimo de sección es el tamaño de sección más pequeño permitido. Si el tamaño mínimo de sección se establece en -1, QHeaderView utilizará el tamaño font metrics.

Esta propiedad es respetada por todos los resize modes.

Funciones de acceso:

int minimumSectionSize() const
void setMinimumSectionSize(int size)

Véase también setSectionResizeMode() y defaultSectionSize.

sectionsClickable : bool

Toma el valor « true » si se puede hacer clic en el encabezado; en caso contrario, « false ». Se puede configurar un encabezado en el que se pueda hacer clic para permitir al usuario cambiar la representación de los datos de la vista relacionados con dicho encabezado.

Funciones de acceso:

bool sectionsClickable() const
void setSectionsClickable(bool clickable)

Véase también sectionPressed() y setSortIndicatorShown().

sectionsMovable : bool

Si sectionsMovable es verdadero, el usuario puede mover las secciones de la cabecera; en caso contrario, permanecen fijas en su lugar.

Cuando se utiliza junto con ` QTreeView`, la primera columna no se puede mover (ya que contiene la estructura de árbol), de forma predeterminada. Se puede hacer que sea movible con ` setFirstSectionMovable` (verdadero).

Funciones de acceso:

bool sectionsMovable() const
void setSectionsMovable(bool movable)

Véanse también ` sectionMoved()` y ` setFirstSectionMovable()`.

showSortIndicator : bool

Esta propiedad determina si se muestra el indicador de ordenación

Por defecto, esta propiedad está false.

Funciones de acceso:

bool isSortIndicatorShown() const
void setSortIndicatorShown(bool show)

Véase también setSectionsClickable().

[since 6.1] sortIndicatorClearable : bool

Esta propiedad determina si el indicador de ordenación se puede desactivar haciendo clic varias veces en una sección

Esta propiedad controla si el usuario puede eliminar el indicador de ordenación de una sección determinada haciendo clic varias veces en dicha sección. Normalmente, al hacer clic en una sección solo se cambia el orden de clasificación de esa sección. Al establecer esta propiedad en «true», el indicador de ordenación se desactivará tras alternar entre orden ascendente y descendente; esto suele restablecer la ordenación original de un modelo.

Establecer esta propiedad en «true» no tiene ningún efecto a menos que sectionsClickable() también sea «true» (lo cual es el valor por defecto para ciertas vistas, por ejemplo, QTableView, o se establece automáticamente al hacer que una vista sea ordenable, por ejemplo, llamando a QTreeView::setSortingEnabled).

Esta enumeración se introdujo en Qt 6.1.

Funciones de acceso:

bool isSortIndicatorClearable() const
void setSortIndicatorClearable(bool clearable)

Señal del notificador:

void sortIndicatorClearableChanged(bool clearable)

stretchLastSection : bool

Esta propiedad indica si la última sección visible del encabezado ocupa todo el espacio disponible

El valor por defecto es «false».

Nota: Los encabezados horizontales proporcionados por QTreeView se configuran con esta propiedad establecida en «true», lo que garantiza que la vista no desperdicie nada del espacio que se le ha asignado para su encabezado. Si este valor se establece en «true», esta propiedad anulará el modo de redimensionamiento establecido en la última sección del encabezado.

Funciones de acceso:

bool stretchLastSection() const
void setStretchLastSection(bool stretch)

Véase también setSectionResizeMode().

Documentación de funciones de miembro

[explicit] QHeaderView::QHeaderView(Qt::Orientation orientation, QWidget *parent = nullptr)

Crea un nuevo encabezado genérico con los valores indicados en « orientation » y « parent ».

[virtual noexcept] QHeaderView::~QHeaderView()

Elimina el encabezado.

int QHeaderView::count() const

Devuelve el número de secciones que hay en el encabezado.

Véase también sectionCountChanged() y length().

[override virtual protected] void QHeaderView::currentChanged(const QModelIndex &current, const QModelIndex &old)

Reimplementa: QAbstractItemView::currentChanged(const QModelIndex &current, const QModelIndex &previous).

[override virtual protected] bool QHeaderView::event(QEvent *e)

Reimplementa: ` QAbstractItemView::event(QEvent *event)`.

[signal] void QHeaderView::geometriesChanged()

Esta señal se emite cuando las geometrías del encabezado han cambiado.

[slot] void QHeaderView::headerDataChanged(Qt::Orientation orientation, int logicalFirst, int logicalLast)

Actualiza las secciones del encabezado modificadas con el orientation indicado, desde logicalFirst hasta logicalLast, ambos inclusive.

int QHeaderView::hiddenSectionCount() const

Devuelve el número de secciones del encabezado que se han ocultado.

Véase también setSectionHidden() y isSectionHidden().

void QHeaderView::hideSection(int logicalIndex)

Oculta la sección especificada en logicalIndex.

Véase también showSection(), isSectionHidden(), hiddenSectionCount() y setSectionHidden().

[override virtual protected] int QHeaderView::horizontalOffset() const

Reimplementa: QAbstractItemView::horizontalOffset() const.

Devuelve el desplazamiento horizontal del encabezado. Este valor es 0 para los encabezados verticales.

Véase también offset().

[virtual protected] void QHeaderView::initStyleOption(QStyleOptionHeader *option) const

Inicializa ` option ` con los valores de esta página: QHeaderView. Este método resulta útil para las subclases cuando necesitan un ` QStyleOptionHeader`, pero no desean rellenar toda la información por sí mismas.

Véase también QStyleOption::initFrom() y initStyleOptionForIndex().

[virtual protected, since 6.0] void QHeaderView::initStyleOptionForIndex(QStyleOptionHeader *option, int logicalIndex) const

Inicializa el estilo « option » a partir del « logicalIndex » especificado. Esta función es llamada por la implementación predeterminada de « paintSection » después de que se haya llamado a « initStyleOption ».

Esta función se introdujo en Qt 6.0.

Véase también paintSection() y initStyleOption().

bool QHeaderView::isSectionHidden(int logicalIndex) const

Devuelve true si la sección especificada por logicalIndex está oculta explícitamente al usuario; en caso contrario, devuelve false.

Véanse también hideSection(), showSection(), setSectionHidden() y hiddenSectionCount().

int QHeaderView::length() const

Devuelve la longitud a lo largo de la orientación de la cabecera.

Véase también sizeHint(), setSectionResizeMode() y offset().

int QHeaderView::logicalIndex(int visualIndex) const

Devuelve el «logicalIndex» de la sección situada en la posición indicada por « visualIndex », o -1 si « visualIndex » < 0 o « visualIndex » >= « QHeaderView::count »().

Ten en cuenta que el visualIndex no se ve afectado por las secciones ocultas.

Véanse también visualIndex() y sectionPosition().

int QHeaderView::logicalIndexAt(const QPoint &pos) const

Devuelve el índice lógico de la sección en la posición indicada en pos. Si el encabezado es horizontal, se utilizará la coordenada x; en caso contrario, se utilizará la coordenada y para hallar el índice lógico.

Véase también sectionPosition().

int QHeaderView::logicalIndexAt(int position) const

Devuelve la sección que abarca el position dado en la ventana gráfica.

Véase también visualIndexAt() y isSectionHidden().

int QHeaderView::logicalIndexAt(int x, int y) const

Devuelve el índice lógico de la sección en la coordenada indicada. Si el encabezado es horizontal, se utilizará ` x `; en caso contrario, se utilizará ` y ` para hallar el índice lógico.

[override virtual protected] void QHeaderView::mouseDoubleClickEvent(QMouseEvent *e)

Reimplementa: QAbstractItemView::mouseDoubleClickEvent(QMouseEvent *event).

[override virtual protected] void QHeaderView::mouseMoveEvent(QMouseEvent *e)

Reimplementa: QAbstractItemView::mouseMoveEvent(QMouseEvent *event).

[override virtual protected] void QHeaderView::mousePressEvent(QMouseEvent *e)

Reimplementa: ` QAbstractItemView::mousePressEvent(QMouseEvent *event)`.

[override virtual protected] void QHeaderView::mouseReleaseEvent(QMouseEvent *e)

Reimplementa: QAbstractItemView::mouseReleaseEvent(QMouseEvent *event).

void QHeaderView::moveSection(int from, int to)

Mueve la sección situada en el índice visual from para que ocupe el índice visual to.

Véase también sectionsMoved().

int QHeaderView::offset() const

Devuelve el desplazamiento del encabezado: se trata del píxel visible situado más a la izquierda (o más arriba, en el caso de los encabezados verticales) del encabezado.

Véase también setOffset().

Qt::Orientation QHeaderView::orientation() const

Devuelve la orientación del encabezado.

Véase también Qt::Orientation.

[override virtual protected] void QHeaderView::paintEvent(QPaintEvent *e)

Reimplementa: QAbstractScrollArea::paintEvent(QPaintEvent *event).

[virtual protected] void QHeaderView::paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const

Pinta la sección especificada por el ` logicalIndex` proporcionado, utilizando el ` painter ` y el ` rect` indicados.

Normalmente, no es necesario llamar a esta función.

[override virtual] void QHeaderView::reset()

Reimplementa: QAbstractItemView::reset().

int QHeaderView::resizeContentsPrecision() const

Devuelve el grado de precisión con el que se calculará « QHeaderView » en « ResizeToContents ».

Véase también setResizeContentsPrecision() y setSectionResizeMode().

void QHeaderView::resizeSection(int logicalIndex, int size)

Cambia el tamaño de la sección especificada por logicalIndex a size, medido en píxeles. El parámetro «size» debe ser un valor mayor o igual a cero. Sin embargo, no se recomienda utilizar un tamaño igual a cero. En ese caso, se debe utilizar en su lugar hideSection.

Véanse también sectionResized(), sectionSize() y hideSection().

[protected slot] void QHeaderView::resizeSections()

Ajusta el tamaño de las secciones según sus valores de tamaño recomendados. Normalmente, no es necesario llamar a esta función.

Nota: Esta ranura está sobrecargada. Para conectarse a esta ranura:

// Connect using qOverload:
connect(sender, &SenderClass::signal,
        headerView, qOverload<>(&QHeaderView::resizeSections));

// Or using a lambda as wrapper:
connect(sender, &SenderClass::signal,
        headerView, [receiver = headerView]() { receiver->resizeSections(); });
Para ver más ejemplos y métodos, consulta la sección sobre cómo conectarse a ranuras sobrecargadas.

void QHeaderView::resizeSections(QHeaderView::ResizeMode mode)

Cambia el tamaño de las secciones según el valor especificado en « mode », sin tener en cuenta el modo de redimensionamiento actual.

Véase también sectionResized().

bool QHeaderView::restoreState(const QByteArray &state)

Restaura el estado « state » de esta vista de encabezado. Esta función devuelve « true » si se ha restaurado el estado; en caso contrario, devuelve «false».

Véase también saveState().

QByteArray QHeaderView::saveState() const

Guarda el estado actual de esta vista de encabezado.

Para restaurar el estado guardado, pasa el valor de retorno a restoreState().

Véase también restoreState().

[signal] void QHeaderView::sectionClicked(int logicalIndex)

Esta señal se emite cuando se hace clic en una sección. El índice lógico de la sección viene especificado por ` logicalIndex`.

Ten en cuenta que también se emitirá la señal ` sectionPressed `.

Véanse también setSectionsClickable() y sectionPressed().

[signal] void QHeaderView::sectionCountChanged(int oldCount, int newCount)

Esta señal se emite cuando cambia el número de secciones, es decir, cuando se añaden o se eliminan secciones. El recuento original se especifica mediante oldCount, y el nuevo recuento mediante newCount.

Véanse también count(), length() y headerDataChanged().

[signal] void QHeaderView::sectionDoubleClicked(int logicalIndex)

Esta señal se emite cuando se hace doble clic en una sección. El índice lógico de la sección viene determinado por logicalIndex.

Véase también setSectionsClickable().

[signal] void QHeaderView::sectionEntered(int logicalIndex)

Esta señal se emite cuando el cursor se desplaza sobre la sección y se pulsa el botón izquierdo del ratón. El índice lógico de la sección viene especificado por logicalIndex.

Véanse también setSectionsClickable() y sectionPressed().

[signal] void QHeaderView::sectionHandleDoubleClicked(int logicalIndex)

Esta señal se emite al hacer doble clic en una sección. El índice lógico de la sección viene especificado por logicalIndex.

Véase también setSectionsClickable().

[signal] void QHeaderView::sectionMoved(int logicalIndex, int oldVisualIndex, int newVisualIndex)

Esta señal se emite cuando se desplaza una sección. El índice lógico de la sección se especifica mediante logicalIndex, el índice anterior mediante oldVisualIndex y la nueva posición del índice mediante newVisualIndex.

Véase también moveSection().

int QHeaderView::sectionPosition(int logicalIndex) const

Devuelve la posición de la sección indicada en ` logicalIndex`, o -1 si la sección está oculta. La posición se mide en píxeles desde la esquina superior izquierda del primer elemento visible hasta la esquina superior izquierda del elemento con ` logicalIndex`. La medición se realiza a lo largo del eje x para los encabezados horizontales y a lo largo del eje y para los encabezados verticales.

Véase también sectionViewportPosition().

[signal] void QHeaderView::sectionPressed(int logicalIndex)

Esta señal se emite cuando se pulsa una sección. El índice lógico de la sección se especifica mediante logicalIndex.

Véase también setSectionsClickable().

QHeaderView::ResizeMode QHeaderView::sectionResizeMode(int logicalIndex) const

Devuelve el modo de redimensionamiento que se aplica a la sección especificada por el logicalIndex dado.

Véase también setSectionResizeMode().

[signal] void QHeaderView::sectionResized(int logicalIndex, int oldSize, int newSize)

Esta señal se emite cuando se modifica el tamaño de una sección. El número lógico de la sección se especifica mediante logicalIndex, el tamaño anterior mediante oldSize y el nuevo tamaño mediante newSize.

Véase también resizeSection().

int QHeaderView::sectionSize(int logicalIndex) const

Devuelve la anchura (o la altura, en el caso de los encabezados verticales) del elemento ` logicalIndex` indicado.

Véase también length(), setSectionResizeMode() y defaultSectionSize().

[virtual protected] QSize QHeaderView::sectionSizeFromContents(int logicalIndex) const

Devuelve el tamaño del contenido de la sección especificada por el logicalIndex proporcionado.

Véase también defaultSectionSize().

int QHeaderView::sectionSizeHint(int logicalIndex) const

Devuelve una sugerencia de tamaño adecuada para la sección especificada por logicalIndex.

Qt::SizeHintRole

Véase también sizeHint(), defaultSectionSize(), minimumSectionSize() y maximumSectionSize().

int QHeaderView::sectionViewportPosition(int logicalIndex) const

Devuelve la posición de la ventana de sección de la « logicalIndex » indicada.

Si la sección está oculta, el valor devuelto es indefinido.

Véase también ` sectionPosition()` y ` isSectionHidden()`.

[protected slot] void QHeaderView::sectionsAboutToBeRemoved(const QModelIndex &parent, int logicalFirst, int logicalLast)

Esta ranura se activa cuando se eliminan secciones de parent. logicalFirst y logicalLast indican dónde se han eliminado las secciones.

Si solo se elimina una sección, logicalFirst y logicalLast serán iguales.

bool QHeaderView::sectionsClickable() const

Devuelve las secciones «Clickable».

Nota: Funcióngetter para la propiedad sectionsClickable.

Véase también ` setSectionsClickable()`.

bool QHeaderView::sectionsHidden() const

Devuelve ` true ` si se han ocultado secciones del encabezado; en caso contrario, devuelve `false`;

Véase también setSectionHidden().

[protected slot] void QHeaderView::sectionsInserted(const QModelIndex &parent, int logicalFirst, int logicalLast)

Esta ranura se activa cuando se insertan secciones en parent. Los índices logicalFirst y logicalLast indican dónde se han insertado las nuevas secciones.

Si solo se inserta una sección, logicalFirst y logicalLast serán iguales.

bool QHeaderView::sectionsMovable() const

Devuelve sectionsMovable.

Nota: Funcióngetter para la propiedad sectionsMovable.

Véase también ` setSectionsMovable()`.

bool QHeaderView::sectionsMoved() const

Devuelve « true » si se han movido secciones del encabezado; en caso contrario, devuelve «false»;

Véase también moveSection().

[override virtual] void QHeaderView::setModel(QAbstractItemModel *model)

Reimplementa: QAbstractItemView::setModel(QAbstractItemModel *model).

[slot] void QHeaderView::setOffset(int offset)

Establece el desplazamiento del encabezado en offset.

Véase también offset() y length().

[slot] void QHeaderView::setOffsetToLastSection()

Establece el desplazamiento para que la última sección quede visible.

Véase también setOffset(), sectionPosition() y setOffsetToSectionPosition().

[slot] void QHeaderView::setOffsetToSectionPosition(int visualSectionNumber)

Establece el desplazamiento respecto al inicio de la sección en la dirección indicada en ` visualSectionNumber`. ` visualSectionNumber ` es la sección visible real cuando no se tienen en cuenta las secciones ocultas (`hiddenSections`). Esto no siempre coincide con ` visualIndex()`.

Véanse también setOffset() y sectionPosition().

void QHeaderView::setResizeContentsPrecision(int precision)

Establece el nivel de precisión con el que QHeaderView debe calcular el tamaño cuando se utiliza ResizeToContents. Un valor bajo proporcionará un redimensionamiento automático menos preciso pero más rápido, mientras que un valor más alto proporcionará un redimensionamiento más preciso que, sin embargo, puede resultar lento.

El número « precision » especifica cuántas secciones deben tenerse en cuenta a la hora de calcular el tamaño preferido.

El valor por defecto es 1000, lo que significa que una columna horizontal con redimensionamiento automático tendrá en cuenta un máximo de 1000 filas al realizar el cálculo del redimensionamiento automático.

El valor especial 0 significa que solo se tendrá en cuenta el área visible. El valor especial -1 implica que se tendrán en cuenta todos los elementos.

Este valor se utiliza en QTableView::sizeHintForColumn(), QTableView::sizeHintForRow() y QTreeView::sizeHintForColumn(). La reimplementación de estas funciones puede hacer que esta función no surta efecto.

Véanse también resizeContentsPrecision(), setSectionResizeMode(), resizeSections(), QTableView::sizeHintForColumn(), QTableView::sizeHintForRow() y QTreeView::sizeHintForColumn().

void QHeaderView::setSectionHidden(int logicalIndex, bool hide)

Si hide es verdadero, la sección especificada por logicalIndex queda oculta; en caso contrario, la sección se muestra.

Véanse también isSectionHidden() y hiddenSectionCount().

void QHeaderView::setSectionResizeMode(QHeaderView::ResizeMode mode)

Establece las restricciones sobre cómo se puede cambiar el tamaño del encabezado según las descritas en el documento mode.

Véanse también sectionResizeMode(), length() y sectionResized().

void QHeaderView::setSectionResizeMode(int logicalIndex, QHeaderView::ResizeMode mode)

Establece las restricciones sobre cómo se puede redimensionar la sección especificada por « logicalIndex » en el encabezado, de acuerdo con las descritas en « mode ». El índice lógico debe existir en el momento en que se llama a esta función.

Nota: Esta configuración se ignorará para la última sección si la propiedad stretchLastSection está establecida en true. Este es el valor por defecto para las cabeceras horizontales proporcionadas por QTreeView.

Véase también setStretchLastSection() y resizeContentsPrecision().

void QHeaderView::setSectionsClickable(bool clickable)

Establece « sectionsClickable » en « clickable ».

Nota: Funciónde asignación para la propiedad sectionsClickable.

Véase también sectionsClickable().

void QHeaderView::setSectionsMovable(bool movable)

Establece el valor de « sectionsMovable » en « movable ».

Nota: Funciónde asignación para la propiedad sectionsMovable.

Véase también sectionsMovable().

[override virtual protected] void QHeaderView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags)

Reimplementa: QAbstractItemView::setSelection(const QRect &rect, QItemSelectionModel::SelectionFlags flags).

Selecciona los elementos del « rect » dado según la « flags » especificada.

La implementación de la clase base no realiza ninguna acción.

void QHeaderView::setSortIndicator(int logicalIndex, Qt::SortOrder order)

Establece el indicador de ordenación para la sección especificada por « logicalIndex » en la dirección indicada por « order », y elimina el indicador de ordenación de cualquier otra sección que lo mostrara.

logicalIndex Puede ser -1; en ese caso, no se mostrará ningún indicador de ordenación y el modelo volverá a su orden natural, sin ordenar. Ten en cuenta que no todos los modelos admiten esta función y que, en este caso, podrían incluso bloquearse.

Véanse también sortIndicatorSection() y sortIndicatorOrder().

[override virtual] void QHeaderView::setVisible(bool v)

Reimplementa una función de acceso para la propiedad: QWidget::visible.

void QHeaderView::showSection(int logicalIndex)

Muestra la sección especificada en logicalIndex.

Véase también hideSection(), isSectionHidden(), hiddenSectionCount() y setSectionHidden().

[override virtual] QSize QHeaderView::sizeHint() const

Reimplementa: ` QAbstractScrollArea::sizeHint()` const.

Devuelve una indicación de tamaño adecuada para este encabezado.

Véase también sectionSizeHint().

[signal] void QHeaderView::sortIndicatorChanged(int logicalIndex, Qt::SortOrder order)

Esta señal se emite cuando se modifica la sección que contiene el indicador de ordenación o el orden indicado. El índice lógico de la sección se especifica mediante logicalIndex y el orden de clasificación se especifica mediante order.

Véase también setSortIndicator().

Qt::SortOrder QHeaderView::sortIndicatorOrder() const

Devuelve el orden correspondiente al indicador de ordenación. Si ninguna sección tiene un indicador de ordenación, el valor devuelto por esta función es indefinido.

Véase también setSortIndicator() y sortIndicatorSection().

int QHeaderView::sortIndicatorSection() const

Devuelve el índice lógico de la sección que tiene un indicador de ordenación. Por defecto, se trata de la sección 0.

Véase también setSortIndicator(), sortIndicatorOrder() y setSortIndicatorShown().

int QHeaderView::stretchSectionCount() const

Devuelve el número de secciones que están configuradas en el modo de redimensionamiento «stretch». En las vistas, esto se puede utilizar para comprobar si la vista de cabecera necesita redimensionar las secciones cuando cambia la geometría de la vista.

Véase también stretchLastSection.

void QHeaderView::swapSections(int first, int second)

Intercambia la sección del índice visual first con la sección del índice visual second.

Véase también moveSection().

[override virtual protected] int QHeaderView::verticalOffset() const

Reimplementa: ` QAbstractItemView::verticalOffset()` const.

Devuelve el desplazamiento vertical del encabezado. Este valor es 0 para los encabezados horizontales.

Véase también offset().

[override virtual protected] bool QHeaderView::viewportEvent(QEvent *e)

Reimplementa: ` QAbstractItemView::viewportEvent(QEvent *event)`.

int QHeaderView::visualIndex(int logicalIndex) const

Devuelve la posición del índice visual de la sección especificada por el ` logicalIndex` proporcionado; en caso contrario, devuelve -1.

Las secciones ocultas siguen teniendo índices visuales válidos.

Véase también logicalIndex().

int QHeaderView::visualIndexAt(int position) const

Devuelve el índice visual de la sección que cubre el position dado en la ventana gráfica.

Véase también logicalIndexAt().

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