企业官网建设流程全解析

免费个人网站注册,厦门网站推广￥做下拉去118cr,策划公司英文,怎样推广平台QListView 是 PySide6 中用于展示列表数据的核心控件#xff0c;属于 Model/View 架构的一部分#xff08;与 QListWidget 不同#xff0c;QListWidget 是封装了 Model 的便捷控件#xff0c;而 QListView 需配合数据模型使用#xff09;。它支持自定义数据展示、批量操作…QListView 是 PySide6 中用于展示列表数据的核心控件属于 Model/View 架构的一部分与 QListWidget 不同QListWidget 是封装了 Model 的便捷控件而 QListView 需配合数据模型使用。它支持自定义数据展示、批量操作、排序 / 筛选等高级功能。一、核心特性Model/View 解耦数据与界面分离通过 Model 管理数据View 仅负责展示便于数据复用和维护。灵活的显示模式支持列表List、图标Icon、详情Details等模式需配合 QStandardItemModel 或自定义 Model。自定义委托Delegate可定制列表项的绘制样式、编辑逻辑。交互支持多选、拖拽、编辑、右键菜单等。性能优化懒加载、虚拟滚动适合海量数据展示。二、使用范例基础使用import sys from PySide6.QtCore import QStringListModel from PySide6.QtWidgets import QApplication, QListView, QVBoxLayout, QWidget class MainWindow(QWidget): def __init__(self): super().__init__() self.setWindowTitle(QListView 基础示例) self.resize(400, 300) # 1. 创建布局 layout QVBoxLayout(self) # 2. 创建 QListView self.list_view QListView() layout.addWidget(self.list_view) # 3. 创建数据模型QStringListModel 仅支持字符串 self.model QStringListModel() # 设置初始数据 self.model.setStringList([Python, PySide6, QListView, Model/View]) # 4. 将模型绑定到 QListView self.list_view.setModel(self.model) # 5. 可选设置交互属性 self.list_view.setEditTriggers(QListView.EditTrigger.DoubleClicked) # 双击编辑 self.list_view.setSelectionMode(QListView.SelectionMode.ExtendedSelection) # 多选 self.list_view.setSpacing(3) # 列表项间距 if __name__ __main__: app QApplication(sys.argv) window MainWindow() window.show() sys.exit(app.exec())支持多列、自定义数据图标、复选框、自定义角色import sys from PySide6.QtCore import QModelIndex, Qt from PySide6.QtGui import QStandardItemModel, QStandardItem from PySide6.QtWidgets import QApplication, QListView, QVBoxLayout, QWidget, QMainWindow class AdvancedListView(QWidget): def __init__(self): super().__init__() self.setWindowTitle(QListView 进阶示例) self.resize(400, 300) layout QVBoxLayout(self) # 1. 创建 QListView self.list_view QListView() layout.addWidget(self.list_view) # 2. 创建 QStandardItemModel支持复杂数据 self.model QStandardItemModel() # 添加带图标、复选框的项 items [ (Python, False), (PySide6, False), (QListView, False), (Model/View, False) ] for text, checked in items: item QStandardItem(text) item.setCheckable(True) # 启用复选框 item.setCheckState(Qt.CheckState.Checked if checked else Qt.CheckState.Unchecked) # 设置初始状态 # 自定义数据通过角色存储 item.setData(f描述{text}, Qt.ItemDataRole.UserRole) self.model.appendRow(item) # 3. 绑定模型 self.list_view.setModel(self.model) # 4. 信号绑定选中项变化 self.list_view.selectionModel().currentChanged.connect(self.on_current_changed) def on_current_changed(self, current: QModelIndex, previous: QModelIndex): 选中项变化时触发 if current.isValid(): # 获取项的文本 text current.data(Qt.ItemDataRole.DisplayRole) # 获取自定义数据 desc current.data(Qt.ItemDataRole.UserRole) # 获取复选框状态 check_state current.data(Qt.ItemDataRole.CheckStateRole) print(f选中{text} | {desc} | 复选框{check_state}) if __name__ __main__: app QApplication(sys.argv) window AdvancedListView() window.show() sys.exit(app.exec())三、关键配置与属性1. 显示模式# 设置为列表模式默认 self.list_view.setViewMode(QListView.ViewMode.ListMode) # 设置为图标模式类似桌面图标 self.list_view.setViewMode(QListView.ViewMode.IconMode) # 图标模式下的图标大小 self.list_view.setIconSize(QSize(32, 32)) # 换行ListMode 下是否自动换行 self.list_view.setWrapping(True)2. 选择模式模式说明QListView.NoSelection不可选QListView.SingleSelection单选QListView.MultiSelection多选点击切换QListView.ExtendedSelection扩展多选Ctrl/Shift 辅助QListView.ContiguousSelection连续多选拖拽选择配置示例self.list_view.setSelectionMode(QListView.SelectionMode.ExtendedSelection) # 设置选择行为选中整行/仅文本 self.list_view.setSelectionBehavior(QListView.SelectionBehavior.SelectRows)3. 编辑触发方式# 双击编辑 self.list_view.setEditTriggers(QListView.EditTrigger.DoubleClicked) # 点击编辑 self.list_view.setEditTriggers(QListView.EditTrigger.SelectedClicked) # 禁止编辑 self.list_view.setEditTriggers(QListView.EditTrigger.NoEditTriggers) # 多种触发方式组合 self.list_view.setEditTriggers( QListView.EditTrigger.DoubleClicked | QListView.EditTrigger.AnyKeyPressed )4. 布局与外观# 列表项间距 self.list_view.setSpacing(8) # 边距 self.list_view.setContentsMargins(10, 10, 10, 10) # 启用网格布局IconMode 下 self.list_view.setGridSize(QSize(100, 50)) # 隐藏横向滚动条 self.list_view.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAlwaysOff) # 设置字体 font self.list_view.font() font.setPointSize(12) self.list_view.setFont(font)四、常用信号与交互1. 核心信号信号说明clicked(QModelIndex)点击项时触发doubleClicked(QModelIndex)双击项时触发activated(QModelIndex)激活项回车 / 双击时触发selectionModel().currentChanged选中项变化时触发pressed(QModelIndex)按下鼠标时触发2. 获取选中项# 获取所有选中的索引 selected_indexes self.list_view.selectionModel().selectedIndexes() for index in selected_indexes: text index.data(Qt.ItemDataRole.DisplayRole) print(f选中项{text}) # 获取当前选中的单个索引 current_index self.list_view.currentIndex() if current_index.isValid(): print(当前选中, current_index.data())3. 操作数据模型# 添加项QStandardItemModel new_item QStandardItem(新项) self.model.appendRow(new_item) # 修改项 index self.model.index(0, 0) # 第0行第0列 self.model.setData(index, 修改后的文本, Qt.ItemDataRole.DisplayRole) # 删除项 self.model.removeRow(0) # 删除第0行 # 清空所有项 self.model.clear() # 排序 self.model.sort(0, Qt.SortOrder.AscendingOrder) # 第0列升序五、自定义委托Delegate通过自定义委托可以完全控制列表项的绘制和编辑示例自定义背景色和字体from PySide6.QtCore import QModelIndex, Qt from PySide6.QtWidgets import QStyledItemDelegate, QStyle from PySide6.QtGui import QPainter, QColor, QFont import sys from PySide6.QtCore import QStringListModel from PySide6.QtWidgets import QApplication, QListView, QVBoxLayout, QWidget class MainWindow(QWidget): def __init__(self): super().__init__() self.setWindowTitle(QListView 基础示例) self.resize(400, 300) # 1. 创建布局 layout QVBoxLayout(self) # 2. 创建 QListView self.list_view QListView() layout.addWidget(self.list_view) # 3. 创建数据模型QStringListModel 仅支持字符串 self.model QStringListModel() # 设置初始数据 self.model.setStringList([Python, PySide6, QListView, Model/View]) # 4. 将模型绑定到 QListView self.list_view.setModel(self.model) # 5. 可选设置交互属性 self.list_view.setEditTriggers(QListView.EditTrigger.DoubleClicked) # 双击编辑 self.list_view.setSelectionMode(QListView.SelectionMode.ExtendedSelection) # 多选 self.list_view.setSpacing(3) # 列表项间距 # 使用自定义委托 self.list_view.setItemDelegate(CustomDelegate()) # 自定义委托 class CustomDelegate(QStyledItemDelegate): def paint(self, painter: QPainter, option, index: QModelIndex): 绘制列表项 # 选中状态 if option.state QStyle.StateFlag.State_Selected: painter.fillRect(option.rect, QColor(66, 133, 244)) # 蓝色背景 painter.setPen(QColor(255, 255, 255)) # 白色文字 else: # 交替行背景 if index.row() % 2 0: painter.fillRect(option.rect, QColor(240, 240, 240)) painter.setPen(QColor(0, 0, 0)) # 设置字体 font QFont() font.setBold(True) painter.setFont(font) # 绘制文本 text index.data(Qt.ItemDataRole.DisplayRole) painter.drawText(option.rect, Qt.AlignmentFlag.AlignVCenter | Qt.AlignmentFlag.AlignLeft, text) if __name__ __main__: app QApplication(sys.argv) window MainWindow() window.show() sys.exit(app.exec())六、实现鼠标右键from PySide6.QtCore import QModelIndex, Qt, QPoint from PySide6.QtWidgets import QStyledItemDelegate, QStyle, QMenu from PySide6.QtGui import QPainter, QColor, QFont, QStandardItem, QStandardItemModel import sys from PySide6.QtCore import QStringListModel from PySide6.QtWidgets import QApplication, QListView, QVBoxLayout, QWidget class MainWindow(QWidget): def __init__(self): super().__init__() self.setWindowTitle(QListView 基础示例) self.resize(400, 300) # 1. 创建布局 layout QVBoxLayout(self) # 2. 创建 QListView self.list_view QListView() layout.addWidget(self.list_view) # 3. 创建数据模型QStringListModel 仅支持字符串 self.model QStandardItemModel() # 设置初始数据 # self.model.setStringList([Python, PySide6, QListView, Model/View]) str_list [Python, PySide6, QListView, Model/View] for s in str_list: item QStandardItem(s) self.model.appendRow(item) # 4. 将模型绑定到 QListView self.list_view.setModel(self.model) from PySide6.QtWidgets import QMenu # 绑定右键菜单 self.list_view.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu) self.list_view.customContextMenuRequested.connect(self.show_context_menu) def show_context_menu(self, pos: QPoint): 显示右键菜单 menu QMenu() # 获取当前点击的项 index self.list_view.indexAt(pos) if index.isValid(): menu.addAction(删除, lambda: self.model.removeRow(index.row())) menu.addAction(编辑, lambda: self.list_view.edit(index)) menu.addAction(添加项, lambda: self.model.appendRow(QStandardItem(新项))) menu.exec(self.list_view.mapToGlobal(pos)) if __name__ __main__: app QApplication(sys.argv) window MainWindow() window.show() sys.exit(app.exec())七、海量数据优化使用 QAbstractItemModel 自定义模型实现懒加载仅加载可视区域数据禁用不必要的特性如自动排序、实时更新使用 setUniformItemSizes(True) 优化布局计算self.list_view.setUniformItemSizes(True) # 所有项大小相同时启用提升性能注仅当列表中所有项的尺寸完全一致时启用如纯文本列表、统一图标 文本的项若项尺寸不同如部分项带长文本、部分带大图标启用后会导致尺寸显示异常。八、QListView vs QListWidget特性QListViewQListWidget架构Model/View 解耦封装 Model 的便捷控件数据量适合海量数据性能优适合少量数据简单定制性高可自定义 Model/Delegate低仅支持基础定制复杂度稍高需手动管理 Model低开箱即用选型建议简单字符串列表、少量数据 → QListWidget大量数据、自定义展示、多源数据复用 → QListView 自定义 Model。总结QListView 是 PySide6 中功能强大的列表展示控件核心在于 Model/View 架构的解耦设计。掌握其与QStringListModel/QStandardItemModel的配合、选择模式、信号绑定和自定义委托可满足从简单列表到复杂自定义展示的各类需求。