PySide6.QtWidgets.QListView¶

class QListView¶

QListView 类提供了一个列表或图标视图来显示模型。更多…

继承自： QUndoView, QListWidget, QHelpIndexWidget

概要¶

属性¶

batchSizeᅟ - 如果layoutMode设置为Batched，则每批中布局的项目数量
flowᅟ - 项目布局应该流动的方向
gridSizeᅟ - 布局网格的大小
isWrappingᅟ - 项目布局是否应该换行
itemAlignmentᅟ - 每个项目在其单元格中的对齐方式
layoutModeᅟ - 确定项目的布局是否应立即进行或延迟
modelColumnᅟ - 模型中可见的列
movementᅟ - 项目是否可以自由移动，是否对齐到网格，或者完全不能移动
resizeModeᅟ - 当视图调整大小时，项目是否重新布局
selectionRectVisibleᅟ - 如果选择矩形应该可见
spacingᅟ - 布局中项目周围的间距
uniformItemSizesᅟ - 列表视图中的所有项目是否具有相同的大小
viewModeᅟ - QListView的视图模式
wordWrapᅟ - 项目文本的换行策略

方法¶

def __init__()
def batchSize()
def clearPropertyFlags()
def contentsSize()
def flow()
def gridSize()
def isRowHidden()
def isSelectionRectVisible()
def isWrapping()
def itemAlignment()
def layoutMode()
def modelColumn()
def movement()
def rectForIndex()
def resizeContents()
def resizeMode()
def setBatchSize()
def setFlow()
def setGridSize()
def setItemAlignment()
def setLayoutMode()
def setModelColumn()
def setMovement()
def setPositionForIndex()
def setResizeMode()
def setRowHidden()
def setSelectionRectVisible()
def setSpacing()
def setUniformItemSizes()
def setViewMode()
def setWordWrap()
def setWrapping()
def spacing()
def uniformItemSizes()
def viewMode()
def wordWrap()

信号¶

def indexesMoved()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

一个QListView展示存储在模型中的项目，可以是一个简单的非层次列表，也可以是一组图标。这个类用于提供以前由QListBox和QIconView类提供的列表和图标视图，但使用了Qt的模型/视图架构提供的更灵活的方法。

QListView 类是 Model/View Classes 之一，并且是 Qt 的 model/view framework 的一部分。

此视图不显示水平或垂直标题；要显示带有水平标题的项目列表，请改用QTreeView。

QListView 实现了由 QAbstractItemView 类定义的接口，使其能够显示从 QAbstractItemModel 类派生的模型提供的数据。

列表视图中的项目可以使用两种视图模式之一显示：在ListMode中，项目以简单列表的形式显示；在IconMode中，列表视图采用图标视图的形式，其中项目像文件管理器中的文件一样显示图标。默认情况下，列表视图处于ListMode。要更改视图模式，请使用setViewMode()函数，要确定当前视图模式，请使用viewMode()。

这些视图中的项目按照列表视图的flow()指定的方向排列。项目可以固定不动，也可以移动，这取决于视图的movement()状态。

如果模型中的项目无法在流动方向上完全布局，它们可以在视图小部件的边界处换行；这取决于isWrapping()。当项目由图标视图表示时，此属性非常有用。

resizeMode() 和 layoutMode() 控制项目的布局方式和时间。项目根据它们的 spacing() 进行间距调整，并且可以存在于由 gridSize() 指定大小的概念网格中。项目可以根据它们的 iconSize() 渲染为大图标或小图标。

提高性能¶

为了提高显示大量项目时的性能，可以向视图提供有关其处理的数据的提示。对于旨在显示大小相等的项目的视图，可以采取的一种方法是将uniformItemSizes属性设置为true。

另请参阅

查看类 QTreeView QTableView QListWidget

class Movement¶

常量	描述
QListView.Static	用户无法移动项目。
QListView.Free	用户可以将项目自由移动。
QListView.Snap	当移动时，项目会对齐到指定的网格；参见 `setGridSize()` 。

class Flow¶

常量	描述
QListView.LeftToRight	项目在视图中从左到右排列。
QListView.TopToBottom	项目在视图中从上到下排列。

class ResizeMode¶

常量	描述
QListView.Fixed	项目只会在视图首次显示时布局。
QListView.Adjust	每次调整视图大小时，项目将重新布局。

class LayoutMode¶

常量	描述
QListView.SinglePass	项目一次性布局完成。
QListView.Batched	项目以`batchSize`个项目为一批进行布局。

另请参阅

batchSize

class ViewMode¶

常量	描述
QListView.ListMode	项目使用`TopToBottom`流布局，具有小尺寸和静态移动
QListView.IconMode	项目使用`LeftToRight`流布局，具有大尺寸和自由移动