The QItemSelectionModel class keeps track of a view's selected 项。 更多...
继承 QObject .
The QItemSelectionModel class keeps track of a view's selected 项。
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 模型/视图类 且属于 Qt 的 模型/视图框架 .
The selected items are stored using ranges. Whenever you want to modify the selected items use select () and provide either a QItemSelection ，或 QModelIndex 和 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.
This enum describes the way the selection model will be updated.
| 常量 | 值 | 描述 |
|---|---|---|
| QItemSelectionModel.NoUpdate | 0x0000 | No selection will be made. |
| QItemSelectionModel.Clear | 0x0001 | The complete selection will be cleared. |
| QItemSelectionModel.Select | 0x0002 | All specified indexes will be selected. |
| QItemSelectionModel.Deselect | 0x0004 | All specified indexes will be deselected. |
| QItemSelectionModel.Toggle | 0x0008 | All specified indexes will be selected or deselected depending on their current state. |
| QItemSelectionModel.Current | 0x0010 | The current selection will be updated. |
| QItemSelectionModel.Rows | 0x0020 | All indexes will be expanded to span rows. |
| QItemSelectionModel.Columns | 0x0040 | All indexes will be expanded to span columns. |
| QItemSelectionModel.SelectCurrent | Select | Current | A combination of Select and Current, provided for convenience. |
| QItemSelectionModel.ToggleCurrent | Toggle | Current | A combination of Toggle and Current, provided for convenience. |
| QItemSelectionModel.ClearAndSelect | Clear | Select | A combination of Clear and Select, provided for convenience. |
The SelectionFlags type is a typedef for QFlags <SelectionFlag>. It stores an OR combination of SelectionFlag values.
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 .
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 .
This method is also a Qt slot with the C++ signature void clear() .
Clears the selection model. Emits selectionChanged () and currentChanged ().
This method is also a Qt slot with the C++ signature void clearSelection() .
Clears the selection in the selection model. Emits selectionChanged ().
该函数在 Qt 4.2 引入。
Returns true if there are any items selected in the column with the given parent .
Returns the model item index for the current item, or an invalid index if there is no current item.
另请参阅 setCurrentIndex ().
Compares the two selections newSelection and oldSelection 并发射 selectionChanged () with the deselected and selected items.
Returns true if the selection model contains any selection ranges; otherwise returns false.
该函数在 Qt 4.2 引入。
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.
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.
Returns true if the given model item index is selected.
Returns the item model operated on by the selection model.
This method is also a Qt slot with the C++ signature void reset() .
Clears the selection model. Does not emit any signals.
Returns true if there are any items selected in the row with the given parent .
This method is also a Qt slot with the C++ signature void select(const QModelIndex&,QItemSelectionModel::SelectionFlags) .
Selects the model item index 使用指定 command , and emits selectionChanged ().
另请参阅 QItemSelectionModel.SelectionFlags .
This method is also a Qt slot with the C++ signature void select(const QItemSelection&,QItemSelectionModel::SelectionFlags) .
Selects the item selection 使用指定 command , and emits selectionChanged ().
另请参阅 QItemSelectionModel.SelectionFlag .
Returns the indexes in the given row for columns where all rows are selected.
该函数在 Qt 4.2 引入。
另请参阅 selectedIndexes () and selectedRows ().
Returns a list of all selected model item indexes. The list contains no duplicates, and is not sorted.
Returns the indexes in the given column for the rows where all columns are selected.
该函数在 Qt 4.2 引入。
另请参阅 selectedIndexes () and selectedColumns ().
Returns the selection ranges stored in the selection model.
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 发射 currentChanged ()。 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 ， index can also become part of the current selection.
另请参阅 currentIndex () 和 select ().
This is the default overload of this signal.
此信号被发射每当当前项改变。 上一 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.
另请参阅 currentIndex (), setCurrentIndex (), and selectionChanged ().
This is the default overload of this signal.
此信号被发射，若 current item changes and its column is different to the column of the 上一 当前项。
Note that this signal will not be emitted when the item model is reset.
另请参阅 currentChanged (), currentRowChanged (), currentIndex (), and setCurrentIndex ().
This is the default overload of this signal.
此信号被发射，若 current item changes and its row is different to the row of the 上一 current 项。
Note that this signal will not be emitted when the item model is reset.
另请参阅 currentChanged (), currentColumnChanged (), currentIndex (), and setCurrentIndex ().
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 项。
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.
另请参阅 select () 和 currentChanged ().
