QItemSelectionModel露

PyQt5.QtCore.QItemSelectionModel: Inherits from QObject.

Description露

The QItemSelectionModel class keeps track of a view鈥檚 selected items.

A QItemSelectionModel keeps track of the selected items in a view, or in several views onto the same model. It also keeps track of the currently selected item in a view.

The QItemSelectionModel class is one of the Model/View Classes and is part of Qt鈥檚 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 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 Current and any of the other SelectionFlags. If you omit the 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.

Note: Since 5.5, model(), hasSelection(), and currentIndex() are meta-object properties.

Classes露

SelectionFlags

Enums露

SelectionFlag

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

Member	Value	Description
Clear	0x0001	The complete selection will be cleared.
ClearAndSelect	Clear \| Select	A combination of Clear and Select, provided for convenience.
Columns	0x0040	All indexes will be expanded to span columns.
Current	0x0010	The current selection will be updated.
Deselect	0x0004	All specified indexes will be deselected.
NoUpdate	0x0000	No selection will be made.
Rows	0x0020	All indexes will be expanded to span rows.
Select	0x0002	All specified indexes will be selected.
SelectCurrent	Select \| Current	A combination of Select and Current, provided for convenience.
Toggle	0x0008	All specified indexes will be selected or deselected depending on their current state.
ToggleCurrent	Toggle \| Current	A combination of Toggle and Current, provided for convenience.

Methods露

__init__(model: QAbstractItemModel = None): TODO

__init__(QAbstractItemModel, QObject): Constructs a selection model that operates on the specified item model with parent.

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

clearCurrentIndex(): Clears the current index. Emits currentChanged.

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

columnIntersectsSelection(int, QModelIndex) → bool: Returns true if there are any items selected in the column with the given parent.

currentIndex() → QModelIndex: Returns the model item index for the current item, or an invalid index if there is no current item.

See also

setCurrentIndex().

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

hasSelection() → bool: Returns true if the selection model contains any selection ranges; otherwise returns false.

isColumnSelected(int, QModelIndex) → bool

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.

isRowSelected(int, QModelIndex) → bool

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.

isSelected(QModelIndex) → bool: Returns true if the given model item index is selected.

model() → QAbstractItemModel: Returns the item model operated on by the selection model.

reset(): Clears the selection model. Does not emit any signals.

rowIntersectsSelection(int, QModelIndex) → bool: Returns true if there are any items selected in the row with the given parent.

select(QModelIndex, Union[SelectionFlags, SelectionFlag]): Selects the model item index using the specified command, and emits selectionChanged.

See also

QItemSelectionModel::SelectionFlags.

select(QItemSelection, Union[SelectionFlags, SelectionFlag]): Selects the item selection using the specified command, and emits selectionChanged.

See also

SelectionFlag.

selectedColumns(row: int = 0) → List[QModelIndex]: Returns the indexes in the given row for columns where all rows are selected.

See also

selectedIndexes(), selectedRows().

selectedIndexes() → List[QModelIndex]: Returns a list of all selected model item indexes. The list contains no duplicates, and is not sorted.

selectedRows(column: int = 0) → List[QModelIndex]: Returns the indexes in the given column for the rows where all columns are selected.

See also

selectedIndexes(), selectedColumns().

selection() → QItemSelection: Returns the selection ranges stored in the selection model.

setCurrentIndex(QModelIndex, Union[SelectionFlags, SelectionFlag])

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.

Signals露

currentChanged(QModelIndex, QModelIndex): TODO

currentColumnChanged(QModelIndex, QModelIndex): TODO

currentRowChanged(QModelIndex, QModelIndex): TODO

modelChanged(QAbstractItemModel): TODO

selectionChanged(QItemSelection, QItemSelection): TODO