Qt Model/View 学习(6) - Delegate教程之——渲染

最新推荐文章于 2024-07-15 16:51:49 发布
最新推荐文章于 2024-07-15 16:51:49 发布
阅读量4.2k 收藏 43
点赞数 23
分类专栏： Qt Model/View 文章标签： qt mvc c++
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/Copperxcx/article/details/122338752
版权

目录

0. 前言

我们在专栏的第一篇文章中，提到Delegate时说：

在这里插入图片描述

但现在Model和View都已经入门了，该来的总是要来的：本文我们就一起开始进攻Delegate吧！


系列文章回顾：
Qt Model/View 学习(1) - 是什么和为什么？
Qt Model/View 学习(2) - QModelIndex索引模型数据
Qt Model/View 学习(3) - 索引来一堆东西，究竟取谁（ItemDataRole）？
Qt Model/View 学习(4) - 实现自己的QAbstractTableModel类（支持显示与修改）
Qt Model/View 学习(5) - QTableView（优雅）使用教程（附源码）
Qt Model/View 学习(5.5) - 使用QTableView（优雅地）实现翻页效果（附源码）

1. Delegate简介

从第一篇文章我们已经知道了，Delegate提供在View上对数据进行渲染和修改的功能，以及提供了一个默认Delegate把数据显示成字符串。

这里先老样子，仿照Model和View，来一张UML类图，看看它的家族渊源：
在这里插入图片描述

可以发现这位老兄比Model或是View要简洁多了，从QObject出来直接就是标准的Abstract接口了。

从前文我们已经知道 QAbstractItemModel和QAbstractItemView分别定义了Model类和View类的标准接口；

标准接口均无法实例化。

图中的两兄弟QStyledItemDelegate和QItemDelegate，官方更推荐使用QStyledItemDelegate，因为它使用了当前程序的风格去绘制对象。所以本文所有操作都将围绕QStyledItemDelegate进行。
在这里插入图片描述

2. 为什么要用Delegate

在学习它之前我们需要知道，为什么我们需要使用它？或者哪些情况使用它能带给我们何种便利？我们不能因为它是Model/View框架里面的重要一员而学习。

使用场景自然从其功能分析，Delegate负责渲染和编辑数据，那我们使用它必然是因为默认的渲染或编辑方式不及预期。

所以使用Delegate基本上是一个锦上添花的操作，如果只需要实现基本功能的话，似乎不使用Delegate也无伤大雅。换言之：决心使用Delegate的朋友都是高品位的 👻。

举2个简单例子阐述：

  1. 渲染：比如对于百分比可能更想用进度条显示，对于布尔值更想用勾选框显示……甚至对于有较高UI要求人士而言数据的表现形式可以是画星星的数量（Star Delegate教程）等等；
    在这里插入图片描述

  2. 编辑：比如对于性别这类取值限定的数据，在处理输入时会更希望采用下拉菜单而不是直接输入；
    在这里插入图片描述

使用Delegate以后，或许比较重要的是开放思想，发挥创意，它能做的远超我们想象！

3. 渲染方法

3.1 函数重写

查看QStyledItemDelegate的Subclassing部分：如果想要自定义绘制对象，需要派生QStyledItemDelegate，并重写paint()以及或许需要sizeHint()。并且提示了：对不想要自定义绘制的类型应该调用基类的实现。
在这里插入图片描述
听起来很简单，甚至当场想说一句：就这？

但是别着急，我们先看看paint()的函数原型，QStyledItemDelegate重写了QAbstractItemDelegate的纯虚函数paint()：

[virtual] void QStyledItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

[pure virtual] void QAbstractItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const

事实上，sizeHint()函数也是QStyledItemDelegate重写了QAbstractItemDelegate的纯虚函数sizeHint()，所以官方文档才会说或许需要重写sizeHint()。

[virtual] QSize QStyledItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

[pure virtual] QSize QAbstractItemDelegate::sizeHint(const QStyleOptionViewItem &option, const QModelIndex &index) const

如此看来，要重写这两个函数，就得先攻克一下QPainter和QStyleOptionViewItem这两兄弟了。

从类名看起来，QPainter主要是用来画东西的，QStyleOptionViewItem是提供画东西的一些选项。我们能将数据渲染成怎样基本取决于QPainter的能力。

3.2 QPainter

根据官方文档，QPainter能在paint device上绘制各种简单直线、复杂形状、文字、图片等，而paint device是指QPaintDevice或由其派生的子类，是一个以左上角为原点，X向右Y向下的二维平面，常见的paint device有QWidget、QImage、QPixmap等。

可以看出来，QPainter是一个比较底层的类，给了我们很多灵活性。接下来我们看一下它是通过哪些函数来绘制的。

3.2.1 设置

参考QPainter的Settings部分，常用的有字体QFont、笔刷QBrush、钢笔QPen的设置。

在设置某个QPainter之前，最好先调用其save()函数，保存其设置状态，在使用完之后调用restore()函数恢复。

笔者猜想，养成这个好习惯的重要意义在于：很多函数中QPainter以指针传递。

3.2.2 绘制能力

给出的绘制内容的函数如下表：

函数图形
drawPoint点
drawArc弧
drawChord弦
drawEllipse椭圆
drawLine直线
drawPath路径
drawPie扇形
drawPolygon多边形
drawPolyline多段线
drawRect矩形
drawRoundedRect圆角矩形
eraseRect擦除矩形
fillRect填充矩形
drawText文字
drawImage图片
drawPicture图片
drawPixmap图片

所以我们可以猜想，Star Delegate应该是使用了drawPolygon函数实现的画星星功能。

虽然我们要从直线、多边形、椭圆、扇形等等基本图形中组合出优美的渲染效果或许很难，但是，我们既然看到了画图片的几个函数，可以直接PS出各种图片再画上去。

其它思路就靠大家自己打开了~

3.3 QStyle

若不是从QAbstractItemDelegate的介绍中看到了下图的效果，谁能想到还有这种操作？
在这里插入图片描述
这种效果是调用了QStyle::drawControl()函数：
在这里插入图片描述
附上其函数原型：

[static] QStyle *QApplication::style();

[pure virtual] void QStyle::drawControl(ControlElement element, const QStyleOption *option, QPainter *painter, const QWidget *widget = Q_NULLPTR) const

这和上一小节的QPainter完全是两种路子，而且绘制的效果要复杂多了。不过也是十分底层的函数。最后绘制出来的内容应该没有事件处理，只是一副图像。

支持绘制的控件类型为QStyle::ControlElement的枚举类型，而且绘制时需要提供QStyleOption类型的绘制选项。下面的表格中列举了常见的枚举值：

值控件选项类型
QStyle::CE_PushButton按键QStyleOptionButton
QStyle::CE_CheckBox勾选框QStyleOptionButton
QStyle::CE_ProgressBar进度条QStyleOptionProgressBar

支持的控件类型还有很多很多，但应该说能用于显示数据的或许较少，需要大家自行发觉~在Assistant中搜索drawControl函数即可。

3.4 QStyleOptionViewItem

QStyleOptionViewItem描述了在一个View控件中绘制对象的所有参数，包含了QStyle函数需要的所有信息。具体见下图：
在这里插入图片描述

听起来有些绕，但是我们需要知道的也不用很多：

  1. 为了高性能，它的变量都是公有的，直接访问进行修改即可；
  2. 记住它的rect参数，最常用的就是它了，它规定了绘制时可用的矩形区域；甚至在官方文档的例子中，都只用了rect这一个参数：
    在这里插入图片描述

4. 小结

  1. 需要使用Delegate时，一般建议从QStyledItemDelegate派生，因为它使用了当前程序的风格去绘制对象；
  2. 实现自定义渲染需要重载paint()函数，也建议重载sizeHint()函数；
  3. 在paint()函数中，可以使用QPainter来绘制各种基础图形，也可以绘制图片；
  4. QPainter支持一堆设置，在指针传递时最好先save()再改变设置，使用完后restore()恢复设置；
  5. QPainter只能在QPaintDevice上绘制内容，后者可看做是一个二维平面，左上角为原点，X轴向右，Y轴向下；QWidget、QPicture等都是QPaintDevice的子类；
  6. 还可以在paint()函数中采用QStyle::drawControl()函数绘制控件，以稍微复杂的形式（如进度条）来显示数据；
  7. paint()函数形参有一个QStyleOptionViewItem对象，记住它的rect属性，基本操作使用它就够了；
  8. 下一篇我们代码实现一下多种渲染方法~

如有错误欢迎指正，共同进步~

今天你学废了吗？

Copperxcx
关注
  • 23
    点赞
  • 踩
  • 43
    收藏
    觉得还不错? 一键收藏
  • 8
    评论
专栏目录
qt model view Delegate的例子
07-21
改例子是工作中从同事那里得到的参考例子，感觉经典，就留下来了，虽然内容不多，几乎涵盖了所有相关的操作，很好的参考例子，所以要留下来，方便以后使用
PyQt Model/View编程：通过实例代码来认识 Delegate 组件的强大功能
Python技术探索
03-29 1512
Delegate是PyQt Model/View 模型-视图框架的3个组件之一，也称为委托，或代理， Delegate主要用于渲染单元格外观; 为修改时提供编辑控件功能。QAbstractItemDelegate是基类， 子类有ItemDelegate， QStyledItemDelegate, QSqlRelationalDelegate类，本文给出了自定义下拉列表Combo Delegate、进度条 progressBar Delegate, 星号图形 Delegate类的实例代码
Qt QStyle详解
希望能帮助大家，希望大家多多支持，你们的支持是我前进的动力。
04-15 1795
QStyle类是 Qt 框架中用于控制应用程序界面元素外观的一个抽象基类。这个类提供了一种方式来定制窗口部件（widgets）的绘制和行为，可以通过改变主题或风格来更改应用程序的外观，而无需修改窗口部件本身的代码。Qt包含一组QStyle子类，这些子类模仿Qt支持的不同平台的样式（QWindowsStyle、QMacStyle等）。默认情况下，这些样式内置在Qt GUI模块中。样式也可以作为插件提供。Qt的内置widget使用QStyle来执行几乎所有的绘制，确保它们看起来与等效的本地小部件完全相同。
【QT表格-4】由QTableView/QTableWidget显示进度条和按钮，理解qt代理delegate用法
大橘子的博客
11-01 2658
我认为还是始终贯彻MVC模式的应用，比如一个view绑定了一个model，则model的数据是和view同步的。主要是继承QStyledItemDelegate之后，重写那几个函数的意义。
QtDelegate委托的使用
Mr.Xu的博客
09-18 7681
简单基础部件的委托可以继承QItemDelegate，并使用这些函数的默认实现，委托编辑器可以通过使用小工具来管理编辑过程或直接处理事件来实现。 使用Delegate的原因：Qt中当用到QTreeView和QTableView等用于显示item的视图时，你要编辑一个item用到的编辑工具可能是除了默认文字编辑lineEdit以外的工具，例如button，spinBox，甚至Slider,ProgressBar，也有可能是自定义的widget。所以Qt提供了一个委托类，用来处理View中的数据展示方式
QStyle类用法总结（一）
danshiming的博客
05-28 5149
QStyle类用法总结
Qt之模型/视图（自定义按钮）
weixin_34356310的博客
03-24 821
简述 衍伸前面的章节，我们对QTableView实现了数据显示、自定义排序、显示复选框、进度条等功能的实现，本节主要针对自定义按钮进行讲解，这节过后，也希望大家对自定义有更深入的了解，在以后的功能开发过程中，相信无论遇到什么样式形式，我们都可以很好地实现。 简述 效果 QStyledItemDelegate 源码 衍伸...
Qt自定义Delegate
m0_60259116的博客
02-24 897
Qt自定义Delegate
QT学习：代理(Delegate)练习
weixin_42374938的博客
07-03 1286
利用Delegate设计表格中控件。 实现步骤如下。 （1）首先，加载表格数据，以便后面的操作。源文件“main.cpp”中的具体代码如下： #include <QApplication> #include <QStandardItemModel> #include <QTableView> #include <QFile> #include <QTextStream> int main(int argc,char *argv[]) { Q
QT Model/View结构学习
02-22
在深入学习QT Model/View之前，我们需要理解几个关键概念： 1. **数据模型（Model）**：数据模型是整个结构的基础，它负责存储和管理数据。Model类通常继承自QAbstractItemModel或其子类，如QStandardItemModel、...
QT 自定义混合控件——基于View/Model/Delegate的QTableView/QTreewidget/Combobox实现
04-01
在本项目"QT自定义混合控件——基于View/Model/Delegate的QTableView/QTreewidget/Combobox实现"中，我们将深入探讨如何利用QT库中的核心组件构建一个强大的数据展示和交互界面。 首先，我们要理解View/Model/...
Qt-Model-View-学习笔记.pdf
11-17
在Qt的实现中，Model提供了数据接口，View负责渲染数据，Delegate则允许自定义数据项的显示和编辑行为。 **Model组件** 所有item models都继承自`QAbstractItemModel`，该类定义了一个通用接口，使得View和...
Qt Model View 学习笔记.pdf
11-17
Qt Model/View 架构是Qt库中一种强大的设计模式，它源于经典的Model-View-Controller（MVC）模式，但简化为Model-View结构，适用于构建用户界面，特别是数据密集型的应用。这一架构的核心思想是将数据模型、视图显示...
Qt5开发从入门到精通——第八篇四节（ 模型／视图结构—— 代理 (Delegate)）
weixin_44759598的博客
09-27 1643
本章节会给大家带来模型／视图结构—— 代理 (Delegate)的开发实例详解。在表格中嵌入各种不同控件，通过表格中的控件对编辑的内容进行限定。通常情况下，采用这种在表格中插入控件的方式，控件始终显示。当表格中控件数目较多时，将影响表格的美观。此时，可利用 Delegate 的方式实现同样的效果，控件只有在需要编辑数据项时才会显示，从而解决了所遇到的上述问题。模型／视图结构—— 代理 (Delegate)会在应用程序开发中经常用到的。
Qt的QItemDelegate使用
sinat_31608641的博客
08-03 4817
qt delegate
[Qt基础内容-09] Qt中MVC的C（Delegate）
qq_44723937的博客
09-14 1065
Qt MVC 中 C （Delegate）
qt中delegate的使用
热门推荐
qq_37529442的博客
09-29 1万+
Qt中使用delegate来自定义控件的显示方法。与传统的MVC模式不同，在此之前，先了解一下何为MVC模式。  MVC架构是"Model-View-Controller"的缩写，中文翻译为"模式-视图-控制器"。MVC应用程序总是由这三个部分组成。Event(事件)导致Controller改变Model或View，或者同时改变两者。只要Controller改变了Models的数据或者属性，所有
Qt模型/视图原理(3)：自定义委托(QAbstractItemDelegate)
qq_40329851的博客
02-08 1122
Qt模型/视图原理(3)：自定义委托(QAbstractItemDelegate) 本文为原创文章，转载请注明出处，或注明转载自“黄邦勇帅(原名：黄勇) 本文出自本人原创著作《Qt5.10 GUI完全参考手册》网盘地址： https://pan.baidu.com/s/1iqagt4SEC8PUYx6t3ku39Q 《C++语法详解》网盘地址：https://pan.baidu.com/s/1dIxLMN5b91zpJN2sZv1MNg 若对C++语...
QT 底层绘图基础类 QGraphicsRectItem::mousePressEvent(event)
最新发布
xie__jin__cheng的博客
07-15 332
QGraphicsRectItem::mousePressEvent(event)
Qt Model/View/Delegate浅谈 - roleNames()
05-31
Qt Model/View/Delegate 是 Qt 提供的一种用于实现 MVC 设计模式的框架，其中 Model 负责存储数据，View 负责显示数据，Delegate 负责定制数据的显示方式。 在 Model 中，我们可以通过实现 `roleNames()` 函数来定义数据的角色名称。这些角色名称可以被 View 和 Delegate 使用来访问 Model 中的数据。 `roleNames()` 函数返回一个 `QHash<int, QByteArray>` 类型的值，其中键是角色的编号，值是角色的名称。对于一个标准的 Model，Qt 提供了一些已经定义好的角色，例如 `Qt::DisplayRole` 用于显示数据，`Qt::EditRole` 用于编辑数据等。 我们也可以自定义角色，例如在一个存储学生信息的 Model 中，我们可以自定义一个 `Qt::UserRole` 角色，用于存储学生的分数信息。在 `roleNames()` 中，我们可以这样定义： ```cpp QHash<int, QByteArray> StudentModel::roleNames() const { QHash<int, QByteArray> roles; roles[Qt::DisplayRole] = "display"; roles[Qt::UserRole] = "score"; return roles; } ``` 在 View 中，我们可以使用 `data()` 函数来访问 Model 中的数据，同时指定要访问的角色。例如： ```cpp QVariant score = model->data(modelIndex, Qt::UserRole); ``` 在 Delegate 中，我们可以重写 `setModelData()` 函数来更新 Model 中的数据，同时指定要更新的角色。例如： ```cpp void ScoreDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex &index) const { QLineEdit *lineEdit = static_cast<QLineEdit*>(editor); QString score = lineEdit->text(); model->setData(index, score, Qt::UserRole); } ``` 通过定义和使用自定义角色，我们可以更加灵活地操作 Model 中的数据，并将数据以更加自然的方式展示给用户。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 8
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值