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 ¤t, 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()`.
| Constante | Valor | Descripción |
|---|---|---|
QHeaderView::Interactive | 0 | El 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::Fixed | 2 | El 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::Stretch | 1 | QHeaderView 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::ResizeToContents | 3 | QHeaderView 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:
| Constante | Valor | Descripción |
|---|---|---|
QHeaderView::Custom | Fixed | Utiliza «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 ¤t, const QModelIndex &old)
Reimplementa: QAbstractItemView::currentChanged(const QModelIndex ¤t, 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(); });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.
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.