- Qt 6.5
- Qt Quick Controls
- QML Types
- HorizontalHeaderView
- Qt 6.5.0 Reference Documentation

# HorizontalHeaderView QML Type

Provides a horizontal header view to accompany a TableView. More...

Import Statement: | import QtQuick.Controls
Inherits: | TableView

- List of all members, including inherited members

## Properties

- model : QVariant
- syncView : TableView
- textRole : QString

## Detailed Description

A HorizontalHeaderView provides labeling of the columns of a TableView. To add a horizontal header to a TableView, bind the syncView property to the TableView:

     HorizontalHeaderView {
         id: horizontalHeader
         syncView: tableView
         anchors.left: tableView.left
     }

The header displays data from the {syncView}'s model by default, but can also have its own model. If the model is a QAbstractTableModel, then the header will display the model's horizontal headerData(); otherwise, the model's data().

A HorizontalHeaderView will have TableView::resizableColumns set to `true` by default.

## Property Documentation

model : QVariant

This property holds the model providing data for the horizontal header view.

When model is not explicitly set, the header will use the syncView's model once syncView is set.

If model is a QAbstractTableModel, its horizontal headerData() will be accessed.

If model is a QAbstractItemModel other than QAbstractTableModel, model's data() will be accessed.

Otherwise, the behavior is same as setting TableView::model.

See also TableView, model, and QAbstractTableModel.

syncView : TableView

This property holds the TableView to synchronize with.

Once this property is bound to another TableView, both header and table will synchronize with regard to column widths, column spacing, and flicking horizontally.

If the model is not explicitly set, then the header will use the syncView's model to label the columns.

See also model and TableView.

textRole : QString

This property holds the model role used to display text in each header cell.

When the model has multiple roles, textRole can be set to determine which role should be displayed.

If model is a QAbstractItemModel then it will default to "display"; otherwise it is empty.

See also QAbstractItemModel::roleNames().