PyQt5模型视图委托
阅读原文时间:2023年07月11日阅读:2

Model-View-Delegate

模型视图委托(MVD)是PyQt中特有的设计模式,类似MVC设计模式,将MVC设计模式中的Controller当做MVD中的Delegate,两者的概念基本相同。不同的是委托不是独立存在,而是包含在视图里面。

模型视图委托设计模式中,模型负责存储和管理数据;视图负责显示数据,其中界面的框架和基础信息是视图负责,具体数据的显示是委托负责;委托不仅仅负责数据的显示,还有一个重要的功能是负责数据的编辑,如在视图中双击就可以编辑数据。

视图是怎么获取模型数据?首先初始化视图时需要给视图设置模型,然后通过索引获取模型中对应位置的数据。

模型

数据的存储一般是列表,表格和树,不同的存储方式有不同的操作和管理方法,为了适应这种差异性,PyQt中提供了一种统一的操作方法,如下图所示:

对于列表数据:

  • 根节点永远是NULL

  • row递增,column是0

对于表结构:

  • 根节点永远是NULL

  • row和column递增

对于树结构:

  • 根节点是NULL,父节点可变

  • row递增,column是0

模型类:

  • QStandardItemModel 通用存储,可以存储任意结构,最常用

  • QStringListModel 存储一组字符串

  • QDirModel 存储文件系统

  • QSqlQueryModel 对SQL查询的结果进行封装

  • QSqlTableModel 对SQL中的表格进行封装

例子:

import sys

from PyQt5.QtCore import Qt
from PyQt5.QtGui import QStandardItemModel, QStandardItem
from PyQt5.QtWidgets import QApplication, QWidget, QTableView, QHBoxLayout

class MyWidget(QWidget):
def __init__(self):
super(MyWidget, self).__init__()

    self.mode = QStandardItemModel()  
    root = self.mode.invisibleRootItem()

    item1 = QStandardItem()  
    item1.setData('', Qt.DisplayRole)  
    item2 = QStandardItem()  
    item2.setData('', Qt.DisplayRole)  
    item3 = QStandardItem()  
    item3.setData('', Qt.DisplayRole)  
    item4 = QStandardItem()  
    item4.setData('', Qt.DisplayRole)

    root.setChild(0, 0, item1)  
    root.setChild(0, 1, item2)  
    root.setChild(1, 0, item3)  
    root.setChild(1, 1, item4)

    # 表结构存储  
    tableView = QTableView(self)  
    tableView.setModel(self.mode)

    layout = QHBoxLayout()  
    layout.addWidget(tableView)  
    self.setLayout(layout)

if __name__ == '__main__':
app = QApplication(sys.argv)
w = MyWidget()
w.resize(500, 300)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()
sys.exit(app.exec_())

import sys

from PyQt5.QtCore import Qt
from PyQt5.QtGui import QStandardItemModel, QStandardItem
from PyQt5.QtWidgets import QApplication, QWidget, QHBoxLayout, QTreeView

class MyWidget(QWidget):
def __init__(self):
super(MyWidget, self).__init__()

    self.mode = QStandardItemModel()  
    root = self.mode.invisibleRootItem()

    item1 = QStandardItem()  
    item1.setData('', Qt.DisplayRole)  
    item2 = QStandardItem()  
    item2.setData('', Qt.DisplayRole)  
    item3 = QStandardItem()  
    item3.setData('', Qt.DisplayRole)  
    item4 = QStandardItem()  
    item4.setData('', Qt.DisplayRole)

    # 树结构存储  
    root.setChild(0, 0, item1)  
    item1.setChild(0, 0, item2)  
    item1.setChild(1, 0, item3)  
    item3.setChild(0, 0, item4)

    treeView = QTreeView(self)  
    treeView.setModel(self.mode)

    layout = QHBoxLayout()  
    layout.addWidget(treeView)  
    self.setLayout(layout)

if __name__ == '__main__':
app = QApplication(sys.argv)
w = MyWidget()
w.resize(500, 300)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()
sys.exit(app.exec_())

视图

视图主要是用来显示数据,不同的视图对象用于显示不同存储结构的数据,主要的视图对象如下:

  • QListView 列表形式显示

  • QTableView 表格形式显示

  • QTreeView 树结构显示

单独的视图需要配合模型使用,因此PyQt对视图进行了再次封装,直接内部封装模型,主要对象如下:

  • QListWidget 列表形式显示的界面

  • QTableWidget 表格形式显示的界面

  • QTreeWidget 树结构形式显示的界面

委托

委托被封装在视图里面,主要是负责数据的显示和编辑功能。

数据的编辑主要涉及的方法:

  • createEditor 在双击进入编辑时,创建编辑器,如创建QLineEdit,QTextEdit

  • updateEditorGeometry 设置编辑器显示的位置和大小

  • setEditorData 更新数据到视图

  • setModeData 通过索引更新数据到模型

如果需要修改编辑时操作数据的方式,就需要重写上述方法。

视图主要是负责显示,其中涉及的方法:

  • paint 负责绘制

  • editorEvent 负责处理事件

如果要实现自定义视图显示,需要重写paint方法,在paint方法中绘制需要显示的控件,然后在editorEvent方法中处理事件,更新数据。

例子

在TableView中默认的整型数据编辑使用的是计数器控件,本例中是将计数器变成单行文本控件,实现数据的编辑功能。

import sys

from PyQt5.QtCore import Qt, QVariant
from PyQt5.QtGui import QStandardItemModel, QStandardItem
from PyQt5.QtWidgets import QApplication, QWidget, QTableView, QHBoxLayout, QStyledItemDelegate, QLineEdit

class MyTableView(QTableView):
def __init__(self):
super(MyTableView, self).__init__()

class MyDelgate(QStyledItemDelegate):
def __init__(self):
super(MyDelgate, self).__init__()

# 创建编辑器  
def createEditor(self, parent, option, index):  
    print('createEditor')  
    if index.column() == 1:  
        return QLineEdit(parent)  
    else:  
        return QStyledItemDelegate.createEditor(self, parent, option, index)

# 设置编辑器的位置  
def updateEditorGeometry(self, edit, option, index):  
    print('updateEditorGeometry')  
    if index.column() == 1:  
        edit.setGeometry(option.rect)  
    else:  
        return QStyledItemDelegate.updateEditorGeometry(self, edit, option, index)

# 设置数据到模型  
def setModelData(self, edit, model, index):  
    print('setModelData')  
    if index.column() == 1:  
        model.setData(index, int(edit.text()), Qt.DisplayRole)  
    else:  
        return QStyledItemDelegate.setModelData(self, edit, model, index)

# 设置数据到视图  
def setEditorData(self, edit, index):  
    print('setEditorData')  
    if index.column() == 1:  
        edit.setText(str(index.data(Qt.DisplayRole)))  
    else:  
        return QStyledItemDelegate.setEditorData(self, edit, index)

class MyWidget(QWidget):
def __init__(self):
super(MyWidget, self).__init__()

    self.mode = QStandardItemModel()  
    root = self.mode.invisibleRootItem()

    item1 = QStandardItem()  
    item1.setData('a', Qt.DisplayRole)

    item2 = QStandardItem()  
    item2.setData(1, Qt.DisplayRole)

    item3 = QStandardItem()  
    item3.setData(False, Qt.DisplayRole)

    item4 = QStandardItem()  
    item4.setData('b', Qt.DisplayRole)

    item5 = QStandardItem()  
    item5.setData(2, Qt.DisplayRole)

    item6 = QStandardItem()  
    item6.setData(True, Qt.DisplayRole)

    root.setChild(0, 0, item1)  
    root.setChild(0, 1, item2)  
    root.setChild(0, 2, item3)  
    root.setChild(1, 0, item4)  
    root.setChild(1, 1, item5)  
    root.setChild(1, 2, item6)

    tableView = MyTableView()  
    tableView.setModel(self.mode)  
    tableView.setItemDelegate(MyDelgate())

    layout = QHBoxLayout()  
    layout.addWidget(tableView)  
    self.setLayout(layout)

if __name__ == '__main__':
app = QApplication(sys.argv)
w = MyWidget()
w.resize(500, 300)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()
sys.exit(app.exec_())

在TableView中默认的整型显示是数字字符串,本例中将数字字符串变成进度条显示。

import sys

from PyQt5.QtCore import Qt, QEvent
from PyQt5.QtGui import QStandardItemModel, QStandardItem
from PyQt5.QtWidgets import QApplication, QWidget, QTableView, QHBoxLayout, QStyledItemDelegate, QStyle, QStyleOptionProgressBar, QStyleOptionButton

class MyTableView(QTableView):
def __init__(self):
super(MyTableView, self).__init__()

一定要注意复写方法的返回值

class MyDelgate(QStyledItemDelegate):
def __init__(self):
super(MyDelgate, self).__init__()

# 委托负责具体数据的显示,因此重新paint方法  
def paint(self, painter, option, index):  
    if index.column() == 1:  
        style = QStyleOptionProgressBar()  
        style.minimum = 0  
        style.maximum = 10  
        style.progress= index.data(Qt.DisplayRole)  
        style.rect = option.rect  
        QApplication.style().drawControl(QStyle.CE\_ProgressBar, style, painter)

    elif index.column() == 2:  
        style = QStyleOptionButton()  
        if index.data(Qt.DisplayRole) == True:  
            style.state = QStyle.State\_On  
        else:  
            style.state = QStyle.State\_Off  
        style.state |= QStyle.State\_Enabled  
        style.rect = option.rect  
        style.rect.setX(option.rect.x() + option.rect.width() / 2 - 7)  
        QApplication.style().drawControl(QStyle.CE\_CheckBox, style, painter)  
    else:  
        return QStyledItemDelegate.paint(self, painter, option, index)

def editorEvent(self, event, model, option, index):  
    if index.column() == 2:  
        if event.type() == QEvent.MouseButtonPress and option.rect.contains(event.pos()):  
            data = not index.data(Qt.DisplayRole)  
            model.setData(index, data, Qt.DisplayRole)  
        return True  
    else:  
        return QStyledItemDelegate.editorEvent(self, event, model, option, index)

class MyWidget(QWidget):
def __init__(self):
super(MyWidget, self).__init__()

    self.mode = QStandardItemModel()  
    root = self.mode.invisibleRootItem()

    item1 = QStandardItem()  
    item1.setData('a', Qt.DisplayRole)

    item2 = QStandardItem()  
    item2.setData(1, Qt.DisplayRole)

    item3 = QStandardItem()  
    item3.setData(False, Qt.DisplayRole)

    item4 = QStandardItem()  
    item4.setData('b', Qt.DisplayRole)

    item5 = QStandardItem()  
    item5.setData(2, Qt.DisplayRole)

    item6 = QStandardItem()  
    item6.setData(True, Qt.DisplayRole)

    root.setChild(0, 0, item1)  
    root.setChild(0, 1, item2)  
    root.setChild(0, 2, item3)  
    root.setChild(1, 0, item4)  
    root.setChild(1, 1, item5)  
    root.setChild(1, 2, item6)

    tableView = MyTableView()  
    tableView.setModel(self.mode)  
    tableView.setItemDelegate(MyDelgate())

    layout = QHBoxLayout()  
    layout.addWidget(tableView)  
    self.setLayout(layout)

if __name__ == '__main__':
app = QApplication(sys.argv)
w = MyWidget()
w.resize(500, 300)
w.move(300, 300)
w.setWindowTitle('Simple')
w.show()
sys.exit(app.exec_())

总结:如果修改视图中数据的显示方式,需要重写委托的paint方法,editorEvent方法是处理视图中的点击事件,根据需要绝对是否重写;如果要修改视图中数据的编辑方式,需要重写createEditor方法、updateEditorGeometry方法、setEditorData方法以及setModeData方法。

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器

你可能感兴趣的文章