ItemSelectionModel QML Type

Instantiates a QItemSelectionModel to be used in conjunction with a QAbstractItemModel and any view supporting it. More...

Import Statement: import QtQml.Models 2.2
Since: Qt 5.5
Instantiates: QItemSelectionModel

Properties

Signals

Methods

Detailed Description

See also QItemSelectionModel and Models and Views in Qt Quick.

Property Documentation

[read-only] currentIndex : QModelIndex

Use setCurrentIndex() to set its value.

See also setCurrentIndex() and currentChanged().


[read-only] hasSelection : bool

It will trigger property binding updates every time selectionChanged() is emitted, even though its value hasn't changed.

See also selection(), selectedIndexes, select(), and selectionChanged().


model : QAbstractItemModel

This property's value must match the view's model.


[read-only] selectedIndexes : QModelIndexList

Contains the list of all the indexes in the selection model.


[read-only] selection : object

Holds the selection ranges stored in the selection model.


Signal Documentation

currentChanged(QModelIndex current, QModelIndex previous)

This signal is emitted whenever the current item changes. The previous model item index is replaced by the current index as the selection's current item.

Note that this signal will not be emitted when the item model is reset.

See also currentIndex(), setCurrentIndex(), and selectionChanged().


selectionChanged(QItemSelection selected, QItemSelection deselected)

This signal is emitted whenever the selection changes. The change in the selection is represented as an item selection of deselected items and an item selection of selected items.

Note the that the current index changes independently from the selection. Also note that this signal will not be emitted when the item model is reset.

See also select() and currentChanged().


Method Documentation

void clear()

Clears the selection model. Emits selectionChanged() and currentChanged().


void clearCurrentIndex()

Clears the current index. Emits currentChanged().


void clearSelection()

Clears the selection in the selection model. Emits selectionChanged().


bool columnIntersectsSelection(int column, QModelIndex parent)

Returns true if there are any items selected in the column with the given parent.


bool isColumnSelected(int column, QModelIndex parent)

Returns true if all items are selected in the column with the given parent.

Note that this function is usually faster than calling isSelected() on all items in the same column, and that unselectable items are ignored.


bool isRowSelected(int row, QModelIndex parent)

Returns true if all items are selected in the row with the given parent.

Note that this function is usually faster than calling isSelected() on all items in the same row, and that unselectable items are ignored.


bool isSelected(QModelIndex index)

Returns true if the given model item index is selected.


void reset()

Clears the selection model. Does not emit any signals.


bool rowIntersectsSelection(int row, QModelIndex parent)

Returns true if there are any items selected in the row with the given parent.


void select(QItemSelection selection, SelectionFlags command)


void select(QModelIndex index, SelectionFlags command)


QModelIndexList selectedColumns(int row)

Returns the indexes in the given row for columns where all rows are selected.

See also selectedRows().


QModelIndexList selectedRows(int column)

Returns the indexes in the given column for the rows where all columns are selected.

See also selectedColumns().


void setCurrentIndex(QModelIndex index, SelectionFlags command)


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