TableView

This property is set to true if the view alternates the row color. The default value is true.

This property determines if the background should be filled or not.

The default value is true.

Note: The rowDelegate is not affected by this property

The current number of columns

This is the content footer of the TableView

This is the content header of the TableView

The current row index of the view. The default value is -1 to indicate that no row is selected.

This property defines a delegate to draw a header.

In the header delegate you have access to the following special properties:

• styleData.value - the value or text for this item
• styleData.column - the index of the column
• styleData.pressed - true when the column is being pressed
• styleData.containsMouse - true when the column is under the mouse

This property determines if the header is visible. The default value is true.

This property defines a delegate to draw a specific cell.

In the item delegate you have access to the following special properties:

• styleData.selected - if the item is currently selected
• styleData.value - the value or text for this item
• styleData.textColor - the default text color for an item
• styleData.row - the index of the row
• styleData.column - the index of the column
• styleData.elideMode - the elide mode of the column
• styleData.textAlignment - the horizontal text alignment of the column

Example:

itemDelegate: Item {
    Text {
        anchors.verticalCenter: parent.verticalCenter
        color: styleData.textColor
        elide: styleData.elideMode
        text: styleData.value
    }
}

This property holds the model providing data for the table view.

The model provides the set of data that is used to create the items in the view. Models can be created directly in QML using ListModel, XmlListModel or VisualItemModel, or provided by C++ model classes.

Example model:

model: ListModel {
    ListElement{ column1: "value 1" ; column2: "value 2" }
    ListElement{ column1: "value 3" ; column2: "value 4" }
}

See also ListView::model and Data Models.

The current number of rows

This property defines a delegate to draw a row.

In the row delegate you have access to the following special properties:

• styleData.alternate - true when the row uses the alternate background color
• styleData.selected - true when the row is currently selected
• styleData.row - the index of the row

These properties determine the section labels.

See also ListView::section.

Index of the current sort column. The default value is 0.

This sets the sorting order of the sort indicator The allowed values are:

• Qt.AscendingOrder - the default
• Qt.DescendingOrder

This property shows or hides the sort indicator The default value is false.

Note: The view itself does not sort the data.

Emitted when the user activates an item by mouse or keyboard interaction. Mouse activation is triggered by single- or double-clicking, depending on the platform.

row int provides access to the activated row index.

Emitted when the user clicks a valid row by single clicking

row int provides access to the clicked row index.

Emitted when the user double clicks a valid row.

row int provides access to the clicked row index.

Adds a column and returns the added column.

The column argument can be an instance of TableViewColumn, or a Component. The component has to contain a TableViewColumn. Otherwise null is returned.

Returns the column at the given index or null if the index is invalid.

Inserts a column at the given index and returns the inserted column.

The column argument can be an instance of TableViewColumn, or a Component. The component has to contain a TableViewColumn. Otherwise null is returned.

Moves a column from index to another.

Positions the view such that the specified row is at the position defined by mode:

• ListView.Beginning - position item at the top of the view.
• ListView.Center - position item in the center of the view.
• ListView.End - position item at bottom of the view.
• ListView.Visible - if any part of the item is visible then take no action, otherwise bring the item into view.
• ListView.Contain - ensure the entire item is visible. If the item is larger than the view the item is positioned at the top of the view.

If positioning the row creates an empty space at the beginning or end of the view, then the view is positioned at the boundary.

For example, to position the view at the end at startup:

Component.onCompleted: table.positionViewAtRow(rowCount -1, ListView.Contain)

Depending on how the model is populated, the model may not be ready when TableView Component.onCompleted is called. In that case you may need to delay the call to positionViewAtRow by using a Timer.

Note: This method should only be called after the component has completed.

Removes and destroys a column at the given index.

Returns the index of the visible row at the point x, y in content coordinates. If there is no visible row at the point specified, -1 is returned.

Note: This method should only be called after the component has completed.