QHeaderView Class

Documentación de las funciones miembro

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

Crea una nueva cabecera genérica con los datos orientation y parent.

[virtual noexcept] QHeaderView::~QHeaderView()

Destruye la cabecera.

int QHeaderView::count() const

Devuelve el número de secciones de la cabecera.

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 de la cabecera han cambiado.

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

Actualiza las secciones de cabecera modificadas con la dirección orientation, desde logicalFirst hasta logicalLast inclusive.

int QHeaderView::hiddenSectionCount() const

Devuelve el número de secciones de la cabecera que se han ocultado.

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

void QHeaderView::hideSection(int logicalIndex)

Oculta la sección especificada por 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 de la cabecera. Es 0 para cabeceras verticales.

Véase también offset().

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

Inicializa option con los valores de este QHeaderView. Este método es útil para las subclases cuando necesitan un QStyleOptionHeader, pero no quieren rellenar toda la información ellas 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 especificado logicalIndex. Esta función es llamada por la implementación por defecto de paintSection después de que initStyleOption haya sido llamada.

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á explícitamente oculta al usuario; en caso contrario devuelve false.

Véase 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 en la posición visualIndex dada, o -1 si visualIndex < 0 o visualIndex >= QHeaderView::count().

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

Véase 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 dada en pos. Si la cabecera es horizontal se utilizará la coordenada x, en caso contrario se utilizará la coordenada y para encontrar el índice lógico.

Véase también sectionPosition().

int QHeaderView::logicalIndexAt(int position) const

Devuelve la sección que cubre 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 dada. Si la cabecera es horizontal se utilizará x, en caso contrario se utilizará y para encontrar 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 en el índice visual from para ocupar el índice visual to.

Véase también sectionsMoved().

int QHeaderView::offset() const

Devuelve el desplazamiento de la cabecera: es el píxel visible más a la izquierda (o más arriba para cabeceras verticales) de la cabecera.

Véase también setOffset().

Qt::Orientation QHeaderView::orientation() const

Devuelve la orientación de la cabecera.

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 logicalIndex, utilizando painter y rect.

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

[override virtual] void QHeaderView::reset()

Reimplementa: QAbstractItemView::reset().

int QHeaderView::resizeContentsPrecision() const

Devuelve la precisión con la que QHeaderView calculará 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 tener un valor mayor o igual que cero. Sin embargo, no se recomienda un tamaño igual a cero. En ese caso, debería utilizarse hideSection en su lugar.

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

[protected slot] void QHeaderView::resizeSections()

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

// 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)

Redimensiona las secciones de acuerdo con la dirección mode, ignorando el modo de redimensionado actual.

Véase también sectionResized().

bool QHeaderView::restoreState(const QByteArray &state)

Restaura el state de esta vista de cabecera. 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 cabecera.

Para restaurar el estado guardado, pase 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 se especifica en logicalIndex.

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

Véase 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 eliminan secciones. El recuento original se especifica en oldCount, y el nuevo en newCount.

Véase 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 se especifica en 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 se especifica en logicalIndex.

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

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

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

Véase también setSectionsClickable().

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

Esta señal se emite cuando se mueve una sección. El índice lógico de la sección se especifica mediante logicalIndex, el índice antiguo 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 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 cabeceras horizontales y a lo largo del eje y para cabeceras 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 en 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 en logicalIndex.

Véase también setSectionResizeMode().

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

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

Véase también resizeSection().

int QHeaderView::sectionSize(int logicalIndex) const

Devuelve la anchura (o altura para cabeceras verticales) de logicalIndex.

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

Véase también defaultSectionSize().

int QHeaderView::sectionSizeHint(int logicalIndex) const

Devuelve una sugerencia de tamaño adecuado 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 sección en la ventana gráfica de logicalIndex.

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 sólo se elimina una sección, logicalFirst y logicalLast serán iguales.

bool QHeaderView::sectionsClickable() const

Devuelve sectionsClickable.

Véase también setSectionsClickable().

bool QHeaderView::sectionsHidden() const

Devuelve true si se han ocultado secciones de la cabecera; 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 sólo se inserta una sección, logicalFirst y logicalLast serán iguales.

bool QHeaderView::sectionsMovable() const

Devuelve sectionsMovable.

Véase también setSectionsMovable().

bool QHeaderView::sectionsMoved() const

Devuelve true si las secciones de la cabecera se han movido; 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 offset de la cabecera en offset.

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

[slot] void QHeaderView::setOffsetToLastSection()

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

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

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

Establece el desplazamiento al inicio de la sección en el visualSectionNumber dado. visualSectionNumber es la sección visible real cuando no se consideran las hiddenSections. No siempre es lo mismo que visualIndex().

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

void QHeaderView::setResizeContentsPrecision(int precision)

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

El número precision especifica cuántas secciones deben ser consideradas cuando se calcula 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 calcular el redimensionamiento automático.

El valor especial 0 significa que sólo mirará el área visible. El valor especial -1 implicará mirar todos los elementos.

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

Véase 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 se oculta; en caso contrario, la sección se muestra.

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

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

Establece las restricciones sobre cómo se puede cambiar el tamaño de la cabecera a las descritas por el mode dado.

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

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

Establece las restricciones sobre cómo la sección especificada por logicalIndex en la cabecera puede ser redimensionada a las descritas por el mode dado. El índice lógico debe existir en el momento de llamar a esta función.

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

void QHeaderView::setSectionsClickable(bool clickable)

Establece sectionsClickable en clickable.

Véase también sectionsClickable().

void QHeaderView::setSectionsMovable(bool movable)

Establece sectionsMovable en movable.

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 en el rect dado de acuerdo con el flags especificado.

La implementación de la clase base no hace nada.

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 especificada por order, y elimina el indicador de ordenación de cualquier otra sección que lo estuviera mostrando.

logicalIndex puede ser -1, en cuyo caso no se mostrará ningún indicador de ordenación y el modelo volverá a su orden natural, sin ordenar. Tenga en cuenta que no todos los modelos soportan esto e incluso pueden bloquearse en este caso.

Véase 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 por logicalIndex.

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

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

Reimplementa: QAbstractScrollArea::sizeHint() const.

Devuelve una sugerencia de tamaño adecuada para esta cabecera.

Véase también sectionSizeHint().

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

Esta señal se emite cuando se cambia 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 del indicador de ordenación. Si ninguna sección tiene un indicador de ordenación, el valor de retorno de 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 es 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 para estirar en modo redimensionamiento. En las vistas, esto se puede utilizar para ver 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 en el índice visual first con la sección en el índice visual second.

Véase también moveSection().

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

Reimplementa: QAbstractItemView::verticalOffset() const.

Devuelve el desplazamiento vertical de la cabecera. Es 0 para cabeceras 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 en logicalIndex, o -1 en caso contrario.

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