继承自QAbstractScrollArea
提供项目视图（item view）的基本方法
QAbstractItemView是所有的使用QAbstractItemModel模型的视图的基类，是一个不能被实例化的抽象类。它通过信号槽机制为与模型的交互操作提供了一个标准化的接口，确保子类视图能够随着模型的变化而及时更新。该类对键盘和鼠标的导航、视窗的滚动、项的编辑以及选择提供了标准的支持。
QListView 这样的View控件和 QListWidget 这样的Widget控件区别在于：View基于Model模型，Widget基于Item项目
Qt 5.15-官方文档-QAbstractItemView
在Qt中使用model/View结构来管理数据与视图的关系，model负责数据的存取，数据的交互通过delegate来实现
更多内容可以参考我的博客《PyQt中的 Model/View 结构》
- Model 模型与数据源通信，为体系结构中的其他组件提供数据接口
- View 视图从模型Model中根据一定条件（如行号、列号等）获取模型索引，模型索引是一个指向数据项的引用。通过模型Model的模型索引，视图View可以从数据源检索数据项。
- Delegate 代理在标准视图中展现数据项，编辑项时，代理Delegate直接使用模型索引与模型Model通信。
| 方法 |
描述 |
说明 |
| setAutoScroll(bool enable) |
设置是否开启自动滚动：如果用户在视口边缘的 16 像素内拖动，QAbstractItemView 会自动滚动视图的内容、果当前项发生变化，则视图将自动滚动以确保当前项完全可见 |
默认为True |
| setAutoScrollMargin(int margin) |
设置自动滚动触发的范围，单位是像素 |
默认值为16 |
| setVerticalScrollMode(QAbstractItemView.ScrollMode mode) |
垂直滚动模式 |
见下方ScrollMode表格 |
| setHorizontalScrollMode(QAbstractItemView.ScrollMode mode) |
水平滚动模式 |
见下方ScrollMode表格 |
| QAbstractItemView.ScrollMode |
描述 |
| ScrollPerItem |
一次滚动一个项目的内容 |
| ScrollPerPixel |
一次滚动一个像素的内容 |
| 方法 |
描述 |
说明 |
| setDragEnabled(bool enable) |
此属性保存视图是否支持拖放它自己的项目 |
|
| setDragDropMode(QAbstractItemView.DragDropMode behavior) |
设置拖放模式 |
见下方DragDropMode表格 |
| setDefaultDropAction(Qt.DropAction dropAction) |
设置默认拖拽动作 |
如果未设置该属性，则当所支持的动作支持CopyAction时，删除动作为CopyAction |
| setDragDropOverwriteMode(bool overwrite) |
控制拖拽是否覆盖写 |
如果其值为true，则所选数据将在删除时覆盖现有项数据，而移动数据将清除该项。如果其值为false，则在删除数据时，所选数据将作为新项插入。当数据被移动时，项也会被移除。 |
| setShowDropIndicator(bool enable) |
用于控制在拖拽过程中显示当前拖拽到的位置，当释放时则在当前拖拽位置覆盖或插入 |
|
| QAbstractItemView.DragDropMode |
值 |
描述 |
| NoDragDrop |
0 |
不支持拖拽放置 |
| DragOnly |
1 |
该视图支持拖拽自己的项目 |
| DropOnly |
2 |
接受丢弃 |
| DragDrop |
3 |
支持拖放 |
| InternalMove |
4 |
该视图只接受来自其自身的移动（不是复制）操作 |
| 方法 |
说明 |
备注 |
| setSelectionMode(QAbstractItemView.SelectionMode mode) |
选择模式 |
见下方SelectionMode表格 |
| setSelectionBehavior(QAbstractItemView.SelectionBehavior behavior) |
选择行为 |
见下方SelectionBehavior表格 |
| QAbstractItemView.SelectionMode |
值 |
描述 |
| NoSelection |
0 |
项目不能被选中 |
| SingleSelection |
1 |
当用户选择一个项目时，任何已经选中的项目将取消选中；用户可以通过按住 Ctrl 键同时选择项目以取消选择 |
| MultiSelection |
2 |
当用户以通常的方式选择一个项目时，该项目的选择状态被切换且其他项目保持不变；可以通过在多个项目上拖动鼠标来多选 |
| ExtendedSelection |
3 |
当用户以通常的方式选择一个项目时，选择将被清除并选择新项目。但是，如果用户在单击一个项目时按下Ctrl键，则被单击的项目将被切换，而所有其他项目将保持不变。如果用户在单击项目时按下Shift键，当前项目和已单击项目之间的所有项目将被选中或取消选中，这取决于已单击项目的状态。可以通过在多个项目上拖动鼠标选择。 |
| ContiguousSelection |
4 |
当用户以通常的方式选择一个项目时，选择将被清除并选择新项目。但是，如果用户在单击项目时按下Shift键，当前项目和已单击项目之间的所有项目将被选中或取消选中，这取决于已单击项目的状态。 |
| QAbstractItemView.SelectionBehavior |
值 |
描述 |
| SelectItems |
0 |
选中单个项目 |
| SelectRows |
1 |
选中行 |
| SelectColumns |
2 |
选中列 |
| 方法 |
说明 |
备注 |
| setEditTriggers(QAbstractItemView.EditTriggers triggers) |
设置编辑触发器（控制何种情况下可以开始编辑项目） |
使用 OR 操作符组合多个触发条件；见下方EditTriggers表格 |
| setTabKeyNavigation(bool enable) |
是否支持tab键和(shift+tab)的导航 |
|
| setTextElideMode(Qt.TextElideMode mode) |
省略号在文本中出现的位置 |
默认值为右侧 |
| setIconSize(QSize &size) |
设置图标尺寸 |
|
| QAbstractItemView.EditTriggers |
值 |
描述 |
| NoEditTriggers |
0 |
没有编辑可能 |
| CurrentChanged |
1 |
当当前项目改变时开始编辑 |
| DoubleClicked |
2 |
当一个项目被鼠标双击时开始编辑 |
| SelectedClicked |
4 |
当一个已经被选中的项目被鼠标单击时开始编辑 |
| EditKeyPressed |
8 |
当平台编辑键被在项目上按下时开始编辑 |
| AnyKeyPressed |
16 |
当任何键在项目上按下时开始编辑 |
| AllEditTriggers |
31 |
上述所有动作都将开始编辑 |
| 槽函数 |
说明 |
备注 |
| clearSelection() |
取消选择所有选定项 |
当前索引不改变 |
| edit(QModelIndex &index) |
开始编辑与给定索引对应的项(如果它是可编辑的) |
注意此函数不会改变当前索引，用户可能会发现键盘导航异常。请在调用此函数前调用setCurrentIndex() |
| reset() |
重置视图内部状态 |
已经做出的修改将不会被保存。如想在重置时commit修改，请重新实现此方法：先commit修改，然后调用超类 |
| scrollToBottom() |
滚动到视图底部 |
|
| scrollToTop() |
滚动到视图顶部 |
|
| selectAll() |
选择视图内的全部项目 |
|
| setCurrentIndex(QModelIndex &index) |
将当前项设置为index处的项目 |
除非当前选择模式为NoSelection，否则项目也会同时被选中 |
| setRootIndex(QModelIndex &index) |
设置给定的index为根项目 |
|
| update(QModelIndex &index) |
更新给定index所占用的区域 |
|
| 信号 |
说明 |
备注 |
| activated(QModelIndex &index) |
当用户激活项目时发送此信号，传出项目索引 |
如何“激活”取决于平台，如鼠标单击/双击项目、Enter键 |
| clicked(QModelIndex &index) |
当鼠标左键单击时发送此信号，点击的项目的索引作为参数传出 |
只有索引有效时才发送 |
| doubleClicked(QModelIndex &index) |
鼠标双击时发送此信号，点击的项目的索引作为参数传出 |
只有索引有效时才发送 |
| entered(QModelIndex &index) |
当鼠标光标进入项目时发送此信号，项目索引作为参数传出 |
需要开启鼠标跟踪才能使用 |
| iconSizeChanged(QModelIndex &index) |
项目图标尺寸改变时传出此信号 |
|
| pressed(QModelIndex &index) |
鼠标按键按下时发送此信号，项目索引作为参数传出 |
索引有效时才发送 |
| viewportEntered() |
当鼠标光标进入时发送此信号 |
需要开启鼠标跟踪才能使用此功能 |
