En esta página

HorizontalHeaderView QML Type

Ofrece una vista de cabecera horizontal que acompaña a un « TableView ». Más...

Import Statement: import QtQuick.Controls
Inherits:

TableView

Propiedades

Descripción detallada

Un HorizontalHeaderView proporciona un encabezado de tabla con estilo. Se puede utilizar como vista independiente o como encabezado de un TableView.

Se puede añadir un encabezado a una vista de tabla ( TableView ) asignando la vista de encabezado ( TableView ) a la propiedad « syncView » de HorizontalHeaderView. De este modo, el encabezado y la tabla se mantendrán sincronizados al deslizar el dedo.

De forma predeterminada, HorizontalHeaderView muestra los datos de encabezado de header data a partir de sync view's model . Si no deseas utilizar los datos de encabezado de ese modelo, o si no utilizas un syncView, puedes asignar un modelo de forma explícita a la propiedad model.

Nota: Para mostrar los datos de cabecera de un QAbstractItemModel, HorizontalHeaderView envolverá internamente los datos de cabecera del modelo en un modelo proxy independiente. Este modelo no comparte ningún elemento con el application model. Esto significa que, si se llaman funciones como index(), el índice del modelo que se obtenga pertenecerá al modelo proxy y no al modelo de la aplicación.

Por defecto, ` textRole ` está configurado como ` "display"`, lo que significa que se utilizarán los datos de la ` Qt::DisplayRole ` del modelo. Puedes configurarlo con otro nombre de rol para que se muestren esos datos en su lugar.

La aplicación se encarga de colocar el encabezado en la ubicación correcta dentro de la escena. Puedes añadir tantos encabezados como desees a un único ` TableView`, lo cual puede resultar útil si, por ejemplo, quieres colocar encabezados en los cuatro lados de la tabla.

El siguiente fragmento de código muestra cómo se puede añadir una vista de encabezado horizontal y vertical a una vista de tabla:

import QtQuick
import QtQuick.Controls
import Qt.labs.qmlmodels

ApplicationWindow {
    visible: true
    width: 640
    height: 480
    title: qsTr("HeaderView")

    Rectangle {
        anchors.fill: parent
        // The background color will show through the cell
        // spacing, and therefore become the grid line color.
        color: Application.styleHints.appearance === Qt.Light ? palette.mid : palette.midlight

        HorizontalHeaderView {
            id: horizontalHeader
            anchors.left: tableView.left
            anchors.top: parent.top
            syncView: tableView
            clip: true
        }

        VerticalHeaderView {
            id: verticalHeader
            anchors.top: tableView.top
            anchors.left: parent.left
            syncView: tableView
            clip: true
        }

        TableView {
            id: tableView
            anchors.left: verticalHeader.right
            anchors.top: horizontalHeader.bottom
            anchors.right: parent.right
            anchors.bottom: parent.bottom
            clip: true

            columnSpacing: 1
            rowSpacing: 1

            model: TableModel {
                TableModelColumn { display: "name" }
                TableModelColumn { display: "color" }

                rows: [
                    {
                        "name": "cat",
                        "color": "black"
                    },
                    {
                        "name": "dog",
                        "color": "brown"
                    },
                    {
                        "name": "bird",
                        "color": "white"
                    }
                ]
            }

            delegate: Rectangle {
                implicitWidth: 100
                implicitHeight: 20
                color: palette.base
                Label {
                    text: display
                }
            }
        }
    }
}

Una «HorizontalHeaderView» tendrá « resizableColumns » establecido en « true » de forma predeterminada.

Véase también VerticalHeaderView.

Documentación de propiedades

model : QVariant

Esta propiedad contiene el modelo que proporciona los datos para la vista de cabecera horizontal.

Por defecto, la vista de encabezado horizontal muestra header data desde sync view's model . Si no deseas utilizar los datos de encabezado de ese modelo, o si no utilizas un syncView, puedes asignar un modelo explícitamente a esta propiedad. Si model es un QAbstractTableModel, se utilizará header data. De lo contrario, si es un QAbstractItemModel, se utilizará data.

Además de QAbstractItemModels, también se pueden asignar otros tipos de modelos a esta propiedad, como las matrices de JavaScript.

Véase también TableView, model y QAbstractTableModel.

movableColumns : bool [since 6.8]

Esta propiedad permite al usuario mover columnas en la vista. El valor por defecto es « false ».

Nota: Si se configura esta propiedad, la opción « HorizontalHeaderView » permite al usuario arrastrar y soltar columnas en la posición deseada. Cuando se activa la opción « syncView », cualquier cambio se aplicará al elemento correspondiente de la vista.

Esta propiedad se introdujo en Qt 6.8.

syncView : TableView

Esta propiedad contiene la propiedad ` TableView ` con la que se va a sincronizar.

Una vez que esta propiedad se vincule a otro TableView, tanto el encabezado como la tabla se sincronizarán en lo que respecta al ancho de las columnas, el espaciado entre columnas y el desplazamiento horizontal.

Si no se establece explícitamente el ` model `, la cabecera utilizará el modelo de `syncView` para etiquetar las columnas.

Véase también « model » y « TableView ».

textRole : string

Esta propiedad contiene el rol del modelo que se utiliza para mostrar el texto en cada celda de encabezado.

Cuando el modelo tiene varios roles, se puede establecer textRole para determinar qué rol debe mostrarse.

Es responsabilidad del delegado respetar el « textRole » asignado al presentar los datos del modelo. Aunque « HorizontalHeaderViewDelegate » y « VerticalHeaderViewDelegate » gestionan esto automáticamente, los delegados personalizados deben implementar este comportamiento de forma explícita.

Si el modelo es un ` QAbstractItemModel `, el valor por defecto será «display»; de lo contrario, estará vacío.

Se muestra una advertencia si el método roleNames() del modelo no proporciona el rol especificado en textRole. La advertencia se puede silenciar configurando el valor de textRole.

Véase también QAbstractItemModel::roleNames().

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