详细学习Pyqt5的5种项目视图（Item View）

CClaris

已于 2024-08-13 22:47:55 修改

阅读量3k

点赞数 34

分类专栏： PyQt5 文章标签： qt 开发语言 Pyqt5 GUI python Python UI ui

于 2023-11-30 12:32:53 首次发布

本文链接：https://blog.youkuaiyun.com/weixin_49520696/article/details/134709486

版权

PyQt5 专栏收录该内容

25 篇文章

订阅专栏

本文详细介绍PyQt5中的五种视图控件（QListView、QTableView、QTreeView、QColumnView）及QComboBox的使用方法。涵盖基本应用、高级特性和最佳实践，帮助开发者构建高效且用户友好的界面。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在现代的应用程序设计中，有效地展示和管理数据是至关重要的。特别是在 PyQt5 这样的强大 GUI 框架中，选择合适的视图和组合框控件对于创建一个既美观又功能强大的用户界面尤为关键。视图控件提供了展示列表、表格、树状结构等不同形式数据的方法，而组合框则允许用户在一个下拉列表中选择一个选项，两者都是数据展示和用户交互的重要组成部分。

在本文中，我们将探讨以下几个关键组件：

QListView：用于展示一个简单列表，适合于显示一系列项，如文本列表或图标集。
QTableView：提供了表格视图，适合于展示和编辑结构化数据，如电子表格。
QTreeView：用于显示树形结构数据，非常适用于展示具有层级关系的信息，如文件系统。
QColumnView：提供了一种独特的方式来浏览树形结构数据，通过连续的列来显示每个层级，适合于深层次的层级数据。
QComboBox：这是一个组合框控件，允许用户从一个下拉列表中选择一个选项，适用于需要从有限选项中选择一个的场景。

了解和掌握这些组件的使用，对于开发一个高效且用户友好的 PyQt5 应用程序是非常重要的。通过这些组件，开发者可以提供清晰、直观且交互性强的数据展示和选择方式。

1. QListView的基本应用

基本概念和典型用途：
QListView 是 PyQt5 中用于展示一系列项（例如文本列表或图标集）的控件。它显示一个可垂直滚动的列表，非常适合用于简单的数据展示，如显示字符串列表、图像集合或其他一维数据。QListView 可以与数据模型（如 QStringListModel 或 QStandardItemModel）结合使用，这使得它可以动态地展示和更新数据。

使用 QListView 显示简单列表数据：
QListView 与数据模型的结合使用为数据的展示和管理提供了极大的灵活性。以下是使用 QListView 显示简单列表数据的基本步骤：

创建 QListView 实例。
创建一个数据模型，并填充数据。
将数据模型设置为 QListView 的模型。

代码示例：
下面的示例演示了如何实现一个基本的列表视图：

from PyQt5.QtWidgets import QApplication, QWidget, QListView, QVBoxLayout
from PyQt5.QtCore import QStringListModel

app = QApplication([])
window = QWidget()

# 创建 QListView 实例
list_view = QListView()

# 创建一个数据模型并添加数据
model = QStringListModel()
model.setStringList(["Item 1", "Item 2", "Item 3", "Item 4"])

# 设置模型到视图
list_view.setModel(model)

# 创建布局并添加视图
layout = QVBoxLayout()
layout.addWidget(list_view)
window.setLayout(layout)

window.show()
app.exec_()

在这个示例中，我们创建了一个 QListView 和一个 QStringListModel，后者用于存储字符串列表。通过将模型设置到视图，QListView 能够显示模型中的数据。这种方式使得数据的更新和展示变得简单且灵活，特别适合于需要动态更新数据的场景。

2. QTableView的高级特性

QTableView的强大功能：
QTableView 在 PyQt5 中用于展示和编辑结构化的表格数据，这使其成为数据库和电子表格等应用的理想选择。它支持显示多行和多列，并且可以与模型类（如 QStandardItemModel 或自定义模型）结合使用，来管理和展示复杂的数据集。QTableView 不仅提供了数据的视觉展示，还允许用户通过编辑功能直接操作这些数据。

自定义列、行和单元格：

自定义列和行： 可以设置列宽和行高，使其适应内容或满足特定的显示需求。还可以隐藏特定的列或行。
单元格定制： 每个单元格可以定制，包括字体、背景色、文本对齐方式等。也可以为单元格添加自定义的渲染器或编辑器，从而展示更复杂的内容，如图标、按钮或自定义绘制的元素。

实际代码示例：
以下是一个展示在 QTableView 中展示复杂数据的实际代码示例：

from PyQt5.QtWidgets import QApplication, QWidget, QTableView, QVBoxLayout
from PyQt5.QtGui import QStandardItemModel, QStandardItem

app = QApplication([])
window = QWidget()

# 创建 QTableView 实例
table_view = QTableView()

# 创建一个标准项模型
model = QStandardItemModel(4, 2)  # 4行2列
model.setHorizontalHeaderLabels(['Column 1', 'Column 2'])

# 填充数据到模型
for row in range(4):
    for column in range(2):
        item = QStandardItem(f'Row {row}, Column {column}')
        model.setItem(row, column, item)

# 设置模型到视图
table_view.setModel(model)

# 自定义列宽和行高
table_view.setColumnWidth(0, 120)
table_view.setRowHeight(0, 30)

# 创建布局并添加表格视图
layout = QVBoxLayout()
layout.addWidget(table_view)
window.setLayout(layout)

window.show()
app.exec_()

在这个示例中，我们创建了一个 QTableView 和一个 QStandardItemModel，并为模型填充了数据。通过设置模型到视图，表格中显示了模型的数据。此外，我们自定义了第一列的宽度和第一行的高度。这种方式提供了展示和操作结构化数据的强大功能，适用于需要丰富数据操作的应用程序。

3. QTreeView和层次数据的展示

QTreeView的工作原理：
QTreeView 是 PyQt5 中用于展示层次数据或树状结构的控件。它允许以树形方式展示信息，每个节点可以展开或折叠来显示或隐藏其子项。这种控件特别适合于展示具有明显层级关系的数据，如文件系统、组织结构或分类信息。

创建和操作树状结构：
使用 QTreeView 时，可以执行以下操作：

创建节点： 在树中添加新的节点，每个节点代表数据层次中的一个元素。
删除节点： 从树中移除不再需要的节点。
修改节点： 更新节点的内容，例如改变文本或添加图标。

代码示例：
以下示例展示了如何在 QTreeView 中创建和操作树状结构：

from PyQt5.QtWidgets import QApplication, QWidget, QTreeView, QVBoxLayout
from PyQt5.QtGui import QStandardItemModel, QStandardItem

app = QApplication([])
window = QWidget()

# 创建 QTreeView 实例
tree_view = QTreeView()

# 创建一个标准项模型
model = QStandardItemModel()
model.setHorizontalHeaderLabels(['Title', 'Description'])

# 创建根节点
root_node = QStandardItem('Root')
model.appendRow(root_node)

# 添加子节点
child_node = QStandardItem('Child 1')
root_node.appendRow(child_node)

# 添加子节点的子节点
subchild_node = QStandardItem('Subchild of Child 1')
child_node.appendRow(subchild_node)

# 设置模型到视图
tree_view.setModel(model)
tree_view.expandAll()  # 展开所有节点

# 创建布局并添加树视图
layout = QVBoxLayout()
layout.addWidget(tree_view)
window.setLayout(layout)

window.show()
app.exec_()

在这个示例中，我们创建了一个 QTreeView 和一个 QStandardItemModel，并在其中添加了层次结构的节点。通过设置模型到视图，树形结构在 QTreeView 中得以展示。这种方式适用于需要展示层次化数据的场景，如配置设置、文档组织或其他需要树形视图的应用。通过使用 QTreeView，可以为用户提供一种直观和易于导航的方式来浏览复杂的层次数据。

4. QColumnView的多列展示

QColumnView的特点和适用场景：
QColumnView 是 PyQt5 中一个独特的控件，用于以多列的方式展示树状或层次数据。它提供了一种动态和直观的方式来浏览复杂数据结构，每次选择一个节点都会在新的列中展示该节点的子节点。这种视图特别适用于需要展示深层次数据结构的应用，如文件浏览器或分类浏览器。

与 QTreeView 不同，QColumnView 通过连续的列来显示每个层级，为用户提供了一种更为直观的方式来浏览和导航复杂的层次结构。

使用QColumnView展示多列视图：
QColumnView 通常与模型（如 QStandardItemModel）结合使用，以动态展示数据。当用户选择某个节点时，其子节点会在新的列中显示，从而允许用户逐层深入地浏览数据。

代码示例：
以下示例展示了如何使用 QColumnView 来展示树状结构的数据：

from PyQt5.QtWidgets import QApplication, QWidget, QColumnView, QVBoxLayout
from PyQt5.QtGui import QStandardItemModel, QStandardItem

app = QApplication([])
window = QWidget()

# 创建 QColumnView 实例
column_view = QColumnView()

# 创建一个标准项模型
model = QStandardItemModel()

# 创建根节点和子节点
root_node = QStandardItem('Root')
child_node1 = QStandardItem('Child 1')
child_node2 = QStandardItem('Child 2')
root_node.appendRow([child_node1, child_node2])

# 创建子节点的子节点
subchild_node1 = QStandardItem('Subchild of Child 1')
subchild_node2 = QStandardItem('Subchild of Child 2')
child_node1.appendRow(subchild_node1)
child_node2.appendRow(subchild_node2)

# 设置模型到视图
model.appendRow(root_node)
column_view.setModel(model)

# 创建布局并添加列视图
layout = QVBoxLayout()
layout.addWidget(column_view)
window.setLayout(layout)

window.show()
app.exec_()

在这个示例中，我们创建了一个 QColumnView 和一个 QStandardItemModel，并在模型中添加了层次化的节点。通过将模型设置到视图，QColumnView 以多列的形式展示了树状结构的数据。这种方式适用于需要提供直观且动态的层次数据浏览体验的应用程序，例如文件管理器或分类浏览工具。

5. QComboBox的灵活应用

QComboBox的多功能性：
QComboBox 是 PyQt5 中一个非常灵活的控件，通常用作下拉列表，允许用户从一系列预定义选项中选择一个。它不仅可以显示简单的文本列表，还可以包含复杂的项，如带有图标的选项。QComboBox 适用于各种场景，如表单中的选择字段、设置对话框中的选项列表等。

填充和检索组合框的数据：
QComboBox 提供了多种方法来填充和检索数据：

添加项： 可以使用 addItem 或 addItems 方法向组合框中添加一个或多个项。
检索选项： 可以通过 currentText 或 currentIndex 方法获取用户选择的文本或选项索引。

代码示例：
以下示例演示了如何在用户界面中使用 QComboBox：

from PyQt5.QtWidgets import QApplication, QWidget, QComboBox, QVBoxLayout

app = QApplication([])
window = QWidget()

# 创建 QComboBox 实例
combo_box = QComboBox()

# 向组合框中添加选项
combo_box.addItems(["Option 1", "Option 2", "Option 3"])

# 当选项改变时执行的函数
def on_combobox_changed():
    print(f"Selected: {combo_box.currentText()}")

# 连接信号
combo_box.currentIndexChanged.connect(on_combobox_changed)

# 创建布局并添加组合框
layout = QVBoxLayout()
layout.addWidget(combo_box)
window.setLayout(layout)

window.show()
app.exec_()

在这个示例中，我们创建了一个 QComboBox 并添加了三个选项。当用户选择不同的选项时，on_combobox_changed 函数会被触发，并打印出当前选中的项。这种方式使 QComboBox 成为获取用户输入和选择的理想工具，可以灵活地应用于多种用户界面场景。通过适当地配置和使用 QComboBox，开发者可以在应用程序中提供清晰且易于使用的选项列表。

6. 集成数据模型和视图

模型与视图的结合使用：
在 PyQt5 中，数据模型和视图的结合使用是实现灵活、可维护的用户界面的关键。模型（如 QStandardItemModel）负责管理应用的数据，而视图（如 QListView、QTableView、QTreeView）则负责展示这些数据。模型和视图的分离符合模型-视图-控制器（MVC）模式的原则，提高了应用程序的组织性和可扩展性。

MVC模式在PyQt5中的应用和好处：

模型（Model）： 负责管理和存储应用程序的数据。在 PyQt5 中，有多种标准模型可用，如 QStandardItemModel、QStringListModel 和 QSqlTableModel。
视图（View）： 负责展示模型中的数据。视图从关联的模型中检索要展示的数据，并且在模型数据改变时自动更新。
控制器（Controller）： 在 PyQt5 中，控制器的角色通常由视图和自定义代码共同承担，负责处理用户的输入和更新模型。

好处：

解耦： 数据和视图的分离使得开发者可以独立地修改数据模型和视图，而不会互相影响。
可维护性和可扩展性： MVC 模式提高了代码的组织性，使得应用更容易维护和扩展。
灵活性： 同一模型可以被多个视图使用，或者相同的视图可以用于展示不同的模型，提供了极大的灵活性。

代码示例：

from PyQt5.QtWidgets import QApplication, QWidget, QListView, QVBoxLayout
from PyQt5.QtGui import QStandardItemModel, QStandardItem

app = QApplication([])
window = QWidget()

# 创建数据模型
model = QStandardItemModel()
for i in range(5):
    item = QStandardItem(f"Item {i}")
    model.appendRow(item)

# 创建视图并设置模型
list_view = QListView()
list_view.setModel(model)

# 创建布局并添加视图
layout = QVBoxLayout()
layout.addWidget(list_view)
window.setLayout(layout)

window.show()
app.exec_()

在这个示例中，我们创建了一个 QStandardItemModel 并填充了一些数据。接着，创建了一个 QListView 并将模型设置给它。这样，任何对模型数据的更改都会自动反映在视图上，用户界面和数据管理的逻辑分离，使得开发和维护变得更加高效和简单。

7. 最佳实践和性能优化

在使用 PyQt5 的视图和组合框时，遵循最佳实践不仅可以提高用户体验，还能优化性能，尤其是在处理大量数据时。

最佳实践：

简洁明了的用户界面： 保持视图和组合框的界面简单直观，避免过度复杂的布局，以提高用户的理解和操作效率。
一致的视觉风格： 确保视图和组合框与应用的整体风格保持一致，包括字体、颜色和图标。
合理的数据展示： 根据数据的性质选择合适的视图控件，例如使用 QTableView 展示表格数据，QTreeView 展示层次数据等。
适当的交互反馈： 如悬停提示、选中高亮等，提升用户交互体验。

性能优化：

使用懒加载（Lazy Loading）： 对于包含大量数据的视图，考虑只在需要时加载和显示数据，特别是对于滚动操作。
批量更新： 当需要更新大量数据时，可以先禁用视图的更新（如 setUpdatesEnabled(False)），完成数据操作后再启用，减少不必要的渲染和重绘。
有效的数据模型： 使用有效的数据模型（如 QStandardItemModel）和合理的数据更新机制，避免频繁的全量数据刷新。
资源回收： 在不再需要时，及时清理和删除数据项和视图，避免内存泄露。

通过遵循这些最佳实践和性能优化策略，可以确保即使在数据量较大的情况下，应用程序也能保持流畅和响应迅速。这对于提升用户体验和应用性能至关重要。

8. 结论

在 PyQt5 应用程序开发中，视图（如 QListView、QTableView、QTreeView、QColumnView）和组合框（QComboBox）扮演着至关重要的角色。这些组件不仅提供了数据展示的基本框架，还为用户与应用程序的交互提供了关键的接口。通过合理利用这些视图和组合框，开发者可以创建出既美观又功能丰富的用户界面。

视图控件使得展示复杂和层次化的数据结构成为可能，而组合框则为用户提供了一个简洁的界面来进行选择和输入。正确地使用这些组件可以极大地提高应用程序的用户体验，特别是在涉及到大量数据展示和管理时。利用模型-视图-控制器（MVC）模式，开发者能够更有效地组织代码，提高应用的可维护性和可扩展性。

深入理解这些组件的使用方法和它们背后的原理对于创建高效和用户友好的界面至关重要。无论是简单的列表显示，复杂的表格编辑，还是高级的树形数据展示，恰当地使用 PyQt5 的视图和组合框控件可以使应用程序在功能和视觉上都达到更高的水平。