VerticalHeaderView QML Type
Ofrece una vista de encabezado vertical que acompaña a TableView. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- model : QVariant
- movableRows : bool
(since 6.8) - syncView : TableView
- textRole : string
Descripción detallada
Un VerticalHeaderView 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 propiedad « TableView » a la propiedad « syncView » de VerticalHeaderView. De este modo, el encabezado y la tabla se mantendrán sincronizados al deslizar el dedo.
De forma predeterminada, VerticalHeaderView muestra los datos de la tabla ( header data ) procedentes del modelo de datos ( sync view's ) model. Si no deseas utilizar los datos de la cabecera de ese modelo, o si no utilizas un modelo de datos ( syncView), puedes asignar un modelo de forma explícita a la propiedad model.
Nota: Para mostrar los datos de cabecera de un QAbstractItemModel, VerticalHeaderView 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 invocan 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 cambiarlo por 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. Se pueden añadir tantos encabezados como se desee a un único ` TableView`, lo que puede resultar útil si, por ejemplo, se quieren 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 «VerticalHeaderView» tendrá « resizableColumns » establecido en « true » de forma predeterminada.
Véase también « HorizontalHeaderView ».
Documentación de propiedades
model : QVariant
Esta propiedad contiene el modelo que proporciona los datos para la vista de cabecera vertical.
De forma predeterminada, la vista de encabezado vertical 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 de forma explícita 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 matrices de JavaScript.
Véase también TableView, model y QAbstractTableModel.
movableRows : bool [since 6.8]
Esta propiedad permite al usuario mover filas en la vista. El valor por defecto es « false ».
Nota: Si se configura esta propiedad, la opción « VerticalHeaderView » permite al usuario arrastrar y soltar filas 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 ellas y el desplazamiento vertical.
Si no se establece explícitamente el ` model `, el encabezado 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»; en caso 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.