Home · All Classes · Modules

QItemSelectionModel Class Reference
^{[QtGui module]}

The QItemSelectionModel class keeps track of a view's selected items. More...

Inherits QObject.

Types

• enum SelectionFlag { NoUpdate, Clear, Select, Deselect, ..., ClearAndSelect }
• class SelectionFlags

Methods

• __init__ (self, QAbstractItemModel model)
• __init__ (self, QAbstractItemModel model, QObject parent)
• clear (self)
• clearSelection (self)
• bool columnIntersectsSelection (self, int column, QModelIndex parent)
• QModelIndex currentIndex (self)
• emitSelectionChanged (self, QItemSelection newSelection, QItemSelection oldSelection)
• bool hasSelection (self)
• bool isColumnSelected (self, int column, QModelIndex parent)
• bool isRowSelected (self, int row, QModelIndex parent)
• bool isSelected (self, QModelIndex index)
• QAbstractItemModel model (self)
• reset (self)
• bool rowIntersectsSelection (self, int row, QModelIndex parent)
• select (self, QModelIndex index, SelectionFlags command)
• select (self, QItemSelection selection, SelectionFlags command)
• list-of-QModelIndex selectedColumns (self, int row = 0)
• list-of-QModelIndex selectedIndexes (self)
• list-of-QModelIndex selectedRows (self, int column = 0)
• QItemSelection selection (self)
• setCurrentIndex (self, QModelIndex index, SelectionFlags command)

Qt Signals

• void currentChanged (const QModelIndex&,const QModelIndex&)
• void currentColumnChanged (const QModelIndex&,const QModelIndex&)
• void currentRowChanged (const QModelIndex&,const QModelIndex&)
• void selectionChanged (const QItemSelection&,const QItemSelection&)

The QItemSelectionModel class is one of the Model/View Classes and is part of Qt's model/view framework.

The selected items are stored using ranges. Whenever you want to modify the selected items use select() and provide either a QItemSelection, or a QModelIndex and a QItemSelectionModel.SelectionFlag.

The QItemSelectionModel takes a two layer approach to selection management, dealing with both selected items that have been committed and items that are part of the current selection. The current selected items are part of the current interactive selection (for example with rubber-band selection or keyboard-shift selections).

To update the currently selected items, use the bitwise OR of QItemSelectionModel.Current and any of the other SelectionFlags. If you omit the QItemSelectionModel.Current command, a new current selection will be created, and the previous one added to the whole selection. All functions operate on both layers; for example, selectedItems() will return items from both layers.

Type Documentation

QItemSelectionModel.SelectionFlag

This enum describes the way the selection model will be updated.

The SelectionFlags type is a typedef for QFlags<SelectionFlag>. It stores an OR combination of SelectionFlag values.

Method Documentation

QItemSelectionModel.__init__ (self, QAbstractItemModel model)

The model argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a selection model that operates on the specified item model.

QItemSelectionModel.__init__ (self, QAbstractItemModel model, QObject parent)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a selection model that operates on the specified item model with parent.

QItemSelectionModel.clear (self)

This method is also a Qt slot with the C++ signature void clear().

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

QItemSelectionModel.clearSelection (self)

This method is also a Qt slot with the C++ signature void clearSelection().

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

This function was introduced in Qt 4.2.

bool QItemSelectionModel.columnIntersectsSelection (self, int column, QModelIndex parent)

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

QModelIndex QItemSelectionModel.currentIndex (self)

Returns the model item index for the current item, or an invalid index if there is no current item.

See also setCurrentIndex().

QItemSelectionModel.emitSelectionChanged (self, QItemSelection newSelection, QItemSelection oldSelection)

Compares the two selections newSelection and oldSelection and emits selectionChanged() with the deselected and selected items.

bool QItemSelectionModel.hasSelection (self)

Returns true if the selection model contains any selection ranges; otherwise returns false.

bool QItemSelectionModel.isColumnSelected (self, 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 QItemSelectionModel.isRowSelected (self, 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 QItemSelectionModel.isSelected (self, QModelIndex index)

Returns true if the given model item index is selected.

QAbstractItemModel QItemSelectionModel.model (self)

Returns the item model operated on by the selection model.

QItemSelectionModel.reset (self)

This method is also a Qt slot with the C++ signature void reset().

Clears the selection model. Does not emit any signals.

bool QItemSelectionModel.rowIntersectsSelection (self, int row, QModelIndex parent)

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

QItemSelectionModel.select (self, QModelIndex index, SelectionFlags command)

This method is also a Qt slot with the C++ signature void select(const QModelIndex&,QItemSelectionModel::SelectionFlags).

Selects the model item index using the specified command, and emits selectionChanged().

See also QItemSelectionModel.SelectionFlags.

QItemSelectionModel.select (self, QItemSelection selection, SelectionFlags command)

This method is also a Qt slot with the C++ signature void select(const QItemSelection&,QItemSelectionModel::SelectionFlags).

Selects the item selection using the specified command, and emits selectionChanged().

See also QItemSelectionModel.SelectionFlag.

list-of-QModelIndex QItemSelectionModel.selectedColumns (self, int row = 0)

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

See also selectedIndexes() and selectedRows().

list-of-QModelIndex QItemSelectionModel.selectedIndexes (self)

Returns a list of all selected model item indexes. The list contains no duplicates, and is not sorted.

list-of-QModelIndex QItemSelectionModel.selectedRows (self, int column = 0)

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

See also selectedIndexes() and selectedColumns().

QItemSelection QItemSelectionModel.selection (self)

Returns the selection ranges stored in the selection model.

QItemSelectionModel.setCurrentIndex (self, QModelIndex index, SelectionFlags command)

This method is also a Qt slot with the C++ signature void setCurrentIndex(const QModelIndex&,QItemSelectionModel::SelectionFlags).

Sets the model item index to be the current item, and emits currentChanged(). The current item is used for keyboard navigation and focus indication; it is independent of any selected items, although a selected item can also be the current item.

Depending on the specified command, the index can also become part of the current selection.

See also currentIndex() and select().

Qt Signal Documentation

void currentChanged (const QModelIndex&,const QModelIndex&)

This is the default overload of this signal.

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.

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

void currentColumnChanged (const QModelIndex&,const QModelIndex&)

This is the default overload of this signal.

This signal is emitted if the current item changes and its column is different to the column of the previous current item.

See also currentChanged(), currentRowChanged(), currentIndex(), and setCurrentIndex().

void currentRowChanged (const QModelIndex&,const QModelIndex&)

This is the default overload of this signal.

This signal is emitted if the current item changes and its row is different to the row of the previous current item.

See also currentChanged(), currentColumnChanged(), currentIndex(), and setCurrentIndex().

void selectionChanged (const QItemSelection&,const QItemSelection&)

This is the default overload of this signal.

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.

See also select() and currentChanged().