[Qt]QListView 重绘实例之二：列表项覆盖的问题处理

已于 2023-09-26 04:11:18 修改
阅读量314 收藏
点赞数
分类专栏： Qt 文章标签： qt 开发语言
于 2023-09-24 22:58:55 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/kyzoon/article/details/133255225
版权

0 环境

  1. Windows 11
  2. Qt 5.15.2 MinGW x64

1 系列文章

简介：本系列文章，是以纯代码方式实现 Qt 控件的重构，尽量不使用 Qss 方式。

《[Qt]QListView 重绘实例之一：背景重绘》

《[Qt]QListView 重绘实例之二：列表项覆盖的问题处理》

《[Qt]QListView 重绘实例之三：滚动条覆盖的问题处理》

《[Qt]QListView 重绘实例之四：效果一讲解》

《[Qt]QListView 重绘实例之五：效果二讲解》

2 问题开始

继上文《之一》，绘制圆角矩形背景时，遗留了两个主要问题：

  • 列表项覆盖破坏背景效果；
  • 滚动条覆盖破坏背景效果；

其中，对于滚动条的问题，留作下一文《之三》讲解。参考《[Qt]QListView 重绘实例之三：滚动条的处理》。

本文先解决列表项覆盖的问题。

QListView-residual2

至少有两个思路解决列表项的覆盖问题：

  • 使用委托。如子类化 QItemDelegate，然后进行列表项的重绘；
  • 使用代理样式。如子类化 QProxyStyle，然后进行列表项的重绘；

本文选择第二种思路，原因有二：

  • 其一，承接上文《之一》已经使用了子类化 QProxyStyle 的方法，继续实现对列表项的重绘功能即可，没有必要再另外添加一个新委托子类实现；
  • 其二，样式 QStyle /代理样式 QProxyStyle，本身即包含委托实现的功能。而且它们更多强大，可以对某类或全局样式进行控件；

具体的重绘过程分为两个部分：

  1. 对于视口最上行/最下行，需要处理上半部分/下半部分的圆角绘制；
  2. 对于视口的其它中间行，则进行默认绘制（或按期望样式绘制）；

→→→ 解决方案直达 ←←←

3 重绘列表项背景

代理样式中，与列表项相关的主要有一个样式类和两个元素类型：

  • 样式类：QStyleOptionViewItem
  • 元素类型：
    • QStyle::CE_ItemViewItem - void drawControl() const
    • QStyle::PE_PanelItemViewItem - void drawPrimitive() const

Qt 文档关于 QStyle 类有如下说明：

Styles in Item Views

…

The primitive element PE_PanelItemViewItem is responsible for painting the background of items, and is called from QCommonStyle’s implementation of CE_ItemViewItem.

（译：QCommonStyle 子类实现中的控制类型 CE_ItemViewItem 会调用原始类型 PE_PanelItemViewItem，其中，原始类型 PE_PanelItemViewItem 负责绘制列表项的背景。）

…

即，在 QStyle::PE_PanelItemViewItem 中绘制列表项的背景，在 QStyle::CE_ItemViewItem 中绘制列表项的内容。

3.1 保存视口大小信息

Qt 明确说明 QListView 是垂直型的列表。

首先，需要判断视口中的最上/最下行位置。而判断位置则需要知道整个列表的高度。具体实现是在绘制 QFrame 时保存数据。

/* .h */
class PListViewStyle : public QListView
{
public:
    // ...
private:
    mutable QRect mRect;	// Need mutable
}

/* .cpp */
void PListViewStyle::drawControl(QStyle::ControlElement element,
                                 const QStyleOption *option,
                                 QPainter *painter,
                                 const QWidget *widget) const
{
    switch(element)
    {
    case QStyle::CE_ShapedFrame:
    {
        const QStyleOptionFrame *opt = qstyleoption_cast<const QStyleOptionFrame *>(option);
        if(nullptr == opt) { return; }
        
        mRect = opt->rect;
        //...
        return;
    }
    default:
        break;
    }

    QProxyStyle::drawControl(element, option, painter, widget);
}

注意：变量 mRect 必须使用 mutable 修饰。

3.2 判断视口中的最上/最下行位置

  • 判断视口中的最上行位置
if(0 == opt->rect.y())

如果没有设置内填充，最上行位置的 y 坐标应该等于 0，因此使用此条件进行判断。

  • 判断视口中的最下行位置
bool PListViewStyle::isLastRow(const QRect rect, int &rowHeight) const
{
    /* 列表可显示行数 */
    int rowCount = mRect.height() / rect.height();
    /* 由 y 坐标与行高计算行索引 */
    int index = rect.y() / rect.height();

    if(rowCount == index)
    {
        rowHeight = mRect.height() - index * rect.height();
        return true;
    }

    return false;
}

3.3 绘制列表项背景

/* 添加常量定义，需要添加到 cpp 文件开头位置 */
const int Radius = 15;

void PListViewStyle::drawPrimitive(QStyle::PrimitiveElement element,
                                   const QStyleOption *option,
                                   QPainter *painter,
                                   const QWidget *widget) const
{
    switch(element)
    {
    /* PE_PanelItemViewItem 主要负责绘制列表项的背景（选中背景/高亮背景）*/
    case QStyle::PE_PanelItemViewItem:
    {
        const QStyleOptionViewItem *opt = qstyleoption_cast<const QStyleOptionViewItem *>(option);
        if(nullptr == opt) { break; }

        QColor c(Qt::lightGray);
        if(QStyle::State_MouseOver & opt->state)
        {
            c = QColor(0, 0, 255, 255 * 0.2);
        }
        else if(QStyle::State_Selected & opt->state)
        {
            c = QColor(0, 0, 255, 255 * 0.5);
        }

        int x, y, w, h;
        opt->rect.getRect(&x, &y, &w, &h);
        
        QPainterPath path;
        int rowHeight = 0;
        /* 最上一行 */
        if(0 == y)
        {
            /* 创建最上一行，带圆的角矩形路径 */
            path.moveTo(x, y + h);
            path.arcTo(QRect(x, y, 2 * Radius, 2 * Radius), 180, -90);
            path.lineTo(x + w, y);
            path.lineTo(x + w, y + h);
            path.closeSubpath();
        }
        /* 最下一行 */
        else if(isLastRow(opt->rect, rowHeight))
        {
            /* 创建最下一行，带圆角的矩形路径 */
            path.moveTo(x, y);
            path.lineTo(x + w, y);
            path.lineTo(x + w, y + rowHeight);
            path.arcTo(QRect(x, y + rowHeight - 2 * Radius, 2 * Radius, 2 * Radius), 270, -90);
            path.closeSubpath();
        }
        else
        {
            path.addRect(QRect(x, y, w, h));
        }

        painter->save();
        painter->setRenderHint(QPainter::Antialiasing);
        painter->setPen(Qt::NoPen);
        painter->setBrush(QBrush(c));
        painter->drawPath(path);
        painter->restore();

        return;
    }
    default:
        break;
    }

    QProxyStyle::drawPrimitive(element, option, painter, widget);
}

为了显示绘图的效果，这里特地将列表项的默认白色背景，改成了浅灰色。

其中的重点是：对视口最上行和最下行进行了圆角处理，通过 QPainterPaht 实现。

效果图如下：

QListView-itembg

从上图中可以看到，绘制列表项的圆角效果确实出来了，高亮效果也正确。说明，至少这样的处理方案没有问题。

但是，还是发现，背景上有一个白色直角矩形，仍然破坏了圆角矩形背景。

这也同样说明，这个白色直角矩形并不是由于列表项产生的影响。

3.4 视口 viewport()

好了，现在问题好像又回到 QListView 的里层了。

很明显，列表项应该是表层的，因为用户是可以直接看到的。

接下来，结合上一文《之一》的内容，来看一下以下这张图。

QListView-layers

这里有一个层级关系：

  • 最底层：QFrame。在《之一》中使用 paintEvent() 进行重绘时，正是设置的这个，直接设置成了 QFrame::NoFrame；
  • 上一层：viewpotr()。在《之一》中也验证过这点，而且，viewport() 区域是不包含滚动条的。如上图中列表项底下的白色矩形；
  • 最上层：列表项。上文已有说明。

现在，基本上可以确定问题应该聚焦在 viewport() 上。

查看 Qt 帮助文档，与视口相关的有两个接口：

QWidget *QAbstractScrollArea::viewport() const;
void QAbstractScrollArea::setViewport(QWidget *widget);

可知，视口即是一个 QWidget 控件。

那么，再来验证一下，重新设置视口控件，然后设置其背景色为蓝色：

PListView::PListView(QWidget *parent) : QListView(parent)
{
    auto *widget = new QWidget;
    widget->setStyleSheet("background: blue");
    setViewport(widget);
}

效果图如下：

QListView-viewport

由此可知，确认了之前的推论。

补充内容：

解决方法只需要一条语句：setViewport(new QWidget)，而且，做过一些深入的尝试，但没有理解具体的原因。

  • 既然视口是一个 QWidget，那么，对 QWidget 进行绘制，是不是应该也可以当作背景使用？实际上的情况是，子类化 QWidget 后重写 paintEvent() 方法，再设置为新的视口控件，重绘函数根本不会被调用。经实测，可以改变这个视口控件的方式，只有通过设置 Qss 才有效。也没明白是为什么。
  • 然后，设置 QWidget 对象为新的视口控件，该对象的调色板（或者说对象样式）是会影响列表项的默认样式的。例如 QWidget 通过 Qss 设置背景颜色为蓝色，则列表项的默认背景色也会变为蓝色。当然，这也可能是 Qss 设置影响了子对象。

此外，之所以只要设置一个默认的 QWidget 对象作为新视口即可，猜测原因是：默认 QWidget 本身是一个透明的（或者是统一风格背景色的）控制，在 QListView 中即表现为透明的一层，所以不会影响圆角背景的效果。

虽然实际原因不知，但能解决问题。

4 解决方案

  • 添加新的视口控件
PListView::PListView(QWidget *parent) : QListView(parent)
{
    setViewport(new QWidget);
    setFrameStyle(QFrame::NoFrame);	// Must
    //...
}
  • 绘制列表项背景
void PListViewStyle::drawPrimitive(QStyle::PrimitiveElement element,
                                   const QStyleOption *option,
                                   QPainter *painter,
                                   const QWidget *widget) const
{
    switch(element)
    {
    /* PE_PanelItemViewItem 主要负责绘制列表项的背景（以及选中背景/高亮背景） */
    case QStyle::PE_PanelItemViewItem:
    {
        const QStyleOptionViewItem *opt = qstyleoption_cast<const QStyleOptionViewItem *>(option);
        if(nullptr == opt) { break; }

        QColor c(Qt::white);	/* 默认背景色 */
        if(QStyle::State_MouseOver & opt->state)
        {
            c = QColor(0, 0, 255, 255 * 0.2);
        }
        else if(QStyle::State_Selected & opt->state)
        {
            c = QColor(0, 0, 255, 255 * 0.5);
        }

        int x, y, w, h;
        opt->rect.getRect(&x, &y, &w, &h);

        QPainterPath path;
        int rowHeight = 0;
        /* 最上一行 */
        if(0 == y)
        {
            /* 创建最上一行，带圆角的矩形路径 */
            path.moveTo(x, y + h);
            path.arcTo(QRect(x, y, 2 * Radius - 5, 2 * Radius - 5), 180, -90);
            path.lineTo(x + w, y);
            path.lineTo(x + w, y + h);
            path.closeSubpath();
        }
        /* 最下一行 */
        else if(isLastRow(opt->rect, rowHeight))
        {
            /* 创建最下一行，带圆角的矩形路径 */
            path.moveTo(x, y);
            path.lineTo(x + w, y);
            path.lineTo(x + w, y + rowHeight);
            path.arcTo(QRect(x, y + rowHeight - 2 * Radius, 2 * Radius, 2 * Radius), 270, -90);
            path.closeSubpath();
        }
        else
        {
            path.addRect(QRect(x, y, w, h));
        }

        painter->save();
        painter->setRenderHint(QPainter::Antialiasing);
        painter->setPen(Qt::NoPen);
        painter->setBrush(QBrush(c));
        painter->drawPath(path);
        painter->restore();

        return;
    }
    default:
        break;
    }

    QProxyStyle::drawPrimitive(element, option, painter, widget);
}

最后来看一下效果图，达到了预期的效果目标。

QListView-items

kyzoon
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
QListView text动态显示
flutter_learner的博客
07-08 609
QListView动态显示文本
用QT QListView写的仿微信好友列表
03-19
用QT QListView写的仿微信好友列表,列表仿微信好友列表（头像+上下双行数据），还有单击获取信息的功能；效果图在 https://blog.csdn.net/u014385680/article/details/104963956
qt MVD 框架入门教学归纳实例：QListView + QAbstractItemModel + QStyledItemDelegate 实现自定义进度条（同时显示文件名 + 实时跟新进度）
她的吻让他
09-06 949
关于model的学习，直接给你讲实现接口根本不存在看懂的可能性，先根据下方视频链接，看完并实操一次，根据视频讲解理解自定义model 必须要实现的接口以及这些接口的功能。
QListView 使用Delegate定制
三人行
07-20 1541
QListView Model/View 使用Delegate自定义控件
解决QListView的编辑器不起作用的问题
zgrjkflmkyc的专栏
05-24 980
最近按部就班地写了QItemDelegate来实现QListView数据的编辑器功能，但运行后发现选中某一行数据编辑时，编辑器却没有正常显示出来。查看了之前写的代码才发现是因为自己漏掉了重写QAbstractListModel的flags虚函数的步骤，我觉得这是一个很重要的点，分享出来供大家参考。 如下面的代码，其中一个重写了flags虚函数，另一个没有重写flags虚函数，从后面的运行效果可知，如果没有重写flags虚函数返回正确的配置数据，QListView的数据是无法被正常编辑的。 main.cp
QT入门Item Views之QListView
Littlehero_121的博客
03-13 1347
qt控件
ListView控件的重绘相关
。橙子(Chengs)的博客
09-06 456
最近在做关于C++ ListView控件重绘相关的工作，记录一下重要的重绘逻辑 这个先解释下它在不同框架（也不能这么说），不同地方的不同 MFC：就是CListContrl类，这个封装的很好，做起来相对简单 COM:对应的用法都在CommCtrl里面 以 ListView_开头，下面说的主要是COM这个编程相关，不过原理都是一样的 直接上代码 case WM_NOTIFY: if (reinterpret_cast<LPNMHDR>(lParam)->hwnd
Qt QListView示例
12-17
connect(listView, &QListView::clicked, this, &MainWindow::onListViewClicked); ``` `onListViewClicked`是你的槽函数，可以获取被点击项的信息： ```cpp void MainWindow::onListViewClicked(const ...
NavListView.zip_QT导航栏_QT树形导航栏_Qt导航树_Qt树形列表_qlistview
07-14
QT实现的精美树形导航条，使用QLisView进行样式设置，希望对初学者有所帮助。
QListView(仿网易云本地音乐列表)
最新发布
03-24
在本文中，我们将深入探讨如何使用Qt库中的QListView组件，并通过QStyledItemDelegate来实现一个仿照网易云本地音乐列表的界面。QListView是Qt提供的一种用于显示列表数据的视图类，常用于展示一系列可滚动的项目，...
QT QListVIew mvd例程
12-19
QT QListVIew mvd例程,MVD机制理解,方便二次开发使用,看看.
[Qt]QListView 重绘实例之一：背景重绘
kyzoon的专栏
09-23 720
QListView 重绘实例之一：背景重绘
在主窗口中增加绘图类控件时（以QPainter为例）时不显示内容的问题（不应该加addStretch）
David's Tweet
01-10 1311
问题引出 假如我要实现以下GUI，包含一个主窗口，主窗口内又包含1个绘图类控件（QPainter中的QdrawText）和1个单行文本框控件（QLineEdit）。 期望效果图 开始实现的代码为： from PyQt5.QtCore import * from PyQt5.QtGui import * from PyQt5.QtWidgets import * class bui...
QT view视图内容显示的三种技术分析
weixin_32895669的博客
02-28 686
QT view视图内容显示的三种技术分析
QListWidget和QListView的使用和item点击事件
独行猫a 的沉淀、积累、总结。天天学习，好好向上...c/c++,嵌入式 linux,Android,HarmonyOS)
06-01 8521
QListWidget和QListView很常用，但是使用上功能类似，往往容易分不清区别，但是不知道如何选择。这里总结下二者之间的区别和使用，分享给有需要的人。
QtC++与QListView详解
LuXiaoXin1999的博客
11-07 1363
在 Qt 中， 是一个用于显示项目列表的控件，通常与数据模型一起使用。它是 Qt 框架中的标准视图控件之一，用于创建具有项目的可滚动列表视图。以下是关于 的详细讲解和其作用：QListView 的作用：项目列表显示： 主要用于在用户界面中显示项目列表，这些项目可以是文本、图像或自定义的数据项。数据模型支持： 通常， 与数据模型（例如 的子类）一起使用，以提供项目数据和管理。数据模型负责提供项目的数据，而 用于显示和交互。选择和交互： 用户可以与项目进行交互，选择项目并执行相应的操作。 支持单选和多选
QT QTableView QTableWidget 复杂表头(多行表头) 、（冻结、固定特定的行）
热门推荐
漫步繁华街的专栏
09-26 5万+
demo下载地址在最后 ================================分割线====================================== 对于所有前端开发人员会留意到，我们在开发过程中对于表格使用频率还是挺高的，使用QT框架开发时候我们使用QTableView或者QTableWidget创建表格。 其中表格分为 表格头与表格体： 对于简单地表格，...
qt 委托 paint（） 显示数据
证券指标的专栏
10-01 779
Subclassing When subclassing QItemDelegate to create a delegate that displays items using a custom renderer, it is important to ensure that the delegate can render items suitably for all the requ
QT QListView的项长文本无法完全显示问题
Jane_Yih的博客
01-27 2245
关于QT QListView的长文本内容无法完全显示的问题分析与解决方案。
qt qlistview仿微信好友列表
06-15
Qt是一款跨平台的C++图形界面开发工具，而QListView是其提供的一种列表控件，可以用来实现类似微信好友列表的功能。 首先，我们可以通过设置QListView的显示模式，将其变成类似于微信好友列表的样式，比如使用QListView::IconMode或QListView::ListMode等模式。 其次，我们需要利用QAbstractListModel类来实现列表数据的处理，可以继承该类自己实现模型，也可以使用QStandardItemModel类来管理数据。在QStandardItemModel中，我们可以添加QStandardItem，通过设置它的数据和图标来实现列表项的显示。 然后，我们需要在QListView中设置模型，将数据绑定到视图上。通过QListView的setModel函数可以将QAbstractItemModel绑定到QListView中，这样就可以在界面上显示出对应的数据项了。 最后，我们可以利用QAbstractItemDelegate类来自定义列表项的显示效果。在使用QListView时，我们通常会将列表项划分为多个区域，比如头像、昵称、备注等，每个区域可以使用不同的字体、颜色、背景等，这时就需要通过QAbstractItemDelegate来实现。 综上所述，Qt的QListView控件可以很方便地实现类似于微信好友列表的功能。通过设置显示模式、管理数据、绑定模型和自定义列表项的显示效果，我们可以实现一个美观、易用且功能强大的好友列表。

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

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值