鼠标在QTreeView、QTableView、QTableWidget项上移动，背景色改变

1. 前言

2. 需求

3. 功能实现

3.1. 代码实现

3.2. 功能讲解

4. 附录

1. 前言

本博文用到了Qt的model/view framework框架,如果对Qt的“模型/视图/委托”框架不懂，本博文很难读懂。如果不懂这方面的知识，请在Qt Assistant 中输入Model/View Programming 学习了解。读者本机Qt安装目录下的Examples\Qt-XX.XX.XX\widgets\itemviews目录下有很多model/view framework的例子，可以进行自学了解，其中XX.XX.XX为Qt的版本号，如：5.14.1。
因为QColumnView、QHeaderView、QListView、QTableView、QTreeView、QListWidget 、QUndoView、QTableWidget、QTreeWidget都是从QAbstractItemView继承，故本博文所说的技术点也适用于这些类，本博文以QTableView类来讲解。

2. 需求

业务需求是：鼠标在QTableView的项上方移动（不是按下）时，项背景色改变。即像下面那样的效果：

3. 功能实现

3.1. 代码实现

logTableView.h：

#ifndef LOG_TABLE_VIEW_H
#define LOG_TABLE_VIEW_H

#include <QTableView>


class CLogTableView : public QTableView
{
    Q_OBJECT

public:
    explicit CLogTableView(QWidget *parent = nullptr);

signals:

   // void mouseEnterItemSigal(const QModelIndex &);
private:

    /* 注意：不能重载mouseMoveEvent函数，否则QAbstractItemView::entered信号不会触发,
            如果非要重载mouseMoveEvent函数，则在该函数中发送自定义鼠标进入视图项的信号，如本 
            类中的mouseEnterItemSigal信号
    */
    //virtual void mouseMoveEvent(QMouseEvent *event) override;
};

#endif // LOG_TABLE_VIEW_H

logTableView.cpp：

#include "logTableView.h"
#include<QMouseEvent>
CLogTableView::CLogTableView(QWidget *parent)
    : QTableView(parent)
{
    setMouseTracking(true);
}

/* 注意：不能重载mouseMoveEvent函数，否则QAbstractItemView::entered信号不会触发,
        如果非要重载mouseMoveEvent函数，则在该函数中发送自定义鼠标进入视图项的信号，如本类
        中的mouseEnterItemSigal信号
*/
//void CLogTableView::mouseMoveEvent(QMouseEvent *event)
//{
//   auto pos = event->pos();
//   auto modelIndex = this->indexAt(pos);
//  // emit mouseEnterItemSigal(modelIndex);
//   //update();
//}

logTableModel.h：

#ifndef LOGTABLEMODEL_H
#define LOGTABLEMODEL_H

#include <QAbstractTableModel>

class CLogTableModel : public QAbstractTableModel
{
    Q_OBJECT

public:
    explicit CLogTableModel(QObject *parent = nullptr);

public:

    /*功能:向外层发送日志信息
     *参数1:日志具体内容
     *参数2:日志来源的模块，如：设备管理模块
     *参数3:日志级别
    */
    void addLog(const QString&qsLog, const QString&qsLogSrcModule, int nLogEvel);

private:
    // Basic functionality:
    int rowCount(const QModelIndex &parent = QModelIndex()) const override;
    int columnCount(const QModelIndex &parent = QModelIndex()) const override;

    QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override;

    virtual Qt::ItemFlags flags(const QModelIndex &index) const override;
private:
    QVariant doDecorationRole(int nLogEvel) const;

    QVariant doForegroundRole(int nLogEvel) const;


private:

    QStringList m_lstLogInfo;

};

#endif // LOGTABLEMODEL_H

logTableModel.cpp：

#include "logTableModel.h"
#include<QIcon>
#include<QBrush>

CLogTableModel::CLogTableModel(QObject *parent)
    : QAbstractTableModel(parent)
{
    
}

int CLogTableModel::rowCount(const QModelIndex &parent) const
{
    if (parent.isValid())
        return 0;

    return static_cast<int>(m_lstLogInfo.size() / 3);
}

int CLogTableModel::columnCount(const QModelIndex &parent) const
{
    if (parent.isValid())
        return 0;

    return 1;
}

QVariant CLogTableModel::data(const QModelIndex &index, int role) const
{
    if (!index.isValid())
        return QVariant();

    auto rowIndex = index.row();
    auto rowCount = m_lstLogInfo.size() / 3;
    if((rowIndex < 0) || ( rowCount <= rowIndex))
    {
        Q_ASSERT(0);
        return QVariant();
    }

    // 以下这么做的目的是为了让最近产生的日志排在最顶部，最久产生的日志排在最底部
    auto logIndex = 3 * rowIndex;
    auto qsLog = m_lstLogInfo[logIndex];
    auto qsLogSrcModule = m_lstLogInfo[logIndex + 1];
    auto nLogEvel = m_lstLogInfo[logIndex + 2].toInt();

    auto columnIndex = index.column();

    switch (role)
    {
        case Qt::DisplayRole:
        {
            switch (columnIndex)
            {
                case 0:
                {
                   return qsLog;
                }
            }
        }
        break;
        case Qt::DecorationRole:
        {
            return doDecorationRole(nLogEvel);
        }
        break;
        case Qt::ForegroundRole:
        {
           return doForegroundRole(nLogEvel);
        }
        break;

    } // end switch role

    return QVariant();
}

Qt::ItemFlags CLogTableModel::flags(const QModelIndex &index) const
{
    Q_UNUSED(index);

    return Qt::ItemIsSelectable | Qt::ItemIsEnabled;
}

QVariant CLogTableModel::doForegroundRole(int nLogEvel) const
{
    switch (nLogEvel)
    {
        case 1:
        {
            return QBrush(Qt::yellow);
        }
        break;
        case 2
        case 3:
        {
            return QBrush(Qt::red);
        }
        break;
        default:
        {

        }
        break;
    }

    return QVariant();
}

QVariant CLogTableModel::doDecorationRole(int nLogEvel) const
{
    QIcon icon;
    switch (nLogEvel)
    {
        case 0:
        {
            icon.addFile(QLatin1String(":/logWnd/image/log/normal.png"));
            return icon;
        }
        break;
        case 1:
        {
            icon.addFile(QLatin1String(":/logWnd/image/log/warn.png"));
            return icon;
        }
        break;
        case 2:
        case 3:
        {
            icon.addFile(QLatin1String(":/logWnd/image/log/error.png"));
            return icon;
        }
        break;
        default:
        {
            return icon;
        }
       break;
    }

    return QVariant();
}


void CLogTableModel::addLog(const QString&qsLog, const QString&qsLogSrcModule, int nLogEvel)
{
    beginResetModel();

    if(m_lstLogInfo.size() >= 50)
    {
        m_lstLogInfo.clear();
    }

    auto qsLogEvel = QString::number(nLogEvel);
    m_lstLogInfo.insert(0, qsLog);
    m_lstLogInfo.insert(1, qsLogSrcModule);
    m_lstLogInfo.insert(2, qsLogEvel);

    endResetModel();
}

logItemDelegate.h：

#ifndef CLOGITEMDELEGATE_H
#define CLOGITEMDELEGATE_H

#include <QStyledItemDelegate>

class CLogItemDelegate : public QStyledItemDelegate
{
    Q_OBJECT

public:
    explicit CLogItemDelegate(QObject *parent = nullptr);

public:
     void enterItem(const QModelIndex &index);
private:
    void paint(QPainter *painter, const QStyleOptionViewItem &option,
               const QModelIndex &index) const override;

private:

     QModelIndex m_curIndex;
};

#endif // CLOGITEMDELEGATE_H

logItemDelegate.cpp：

#include "logItemDelegate.h"
#include<QPainter>

CLogItemDelegate::CLogItemDelegate(QObject *parent)
    : QStyledItemDelegate(parent)
{
}

void CLogItemDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const
{
    if (m_curIndex.row() == index.row())
     {
        // 可以把第2个参数换成你想要的任何颜色
        painter->fillRect(option.rect, option.palette.highlight());
    }

    QStyledItemDelegate::paint(painter, option, index);
}


void CLogItemDelegate::enterItem(const QModelIndex &index)
{
    if(!index.isValid())
    {
        return;
    }

    m_curIndex = index;
}

调用方代码如下：

#include "logWnd.h"
#include "ui_logWnd.h"
#include<QPainter>
#include "logTableModel.h"
#include"logItemDelegate.h"

CLogWnd::CLogWnd(QWidget *parent) : QWidget(parent),
    ui(new Ui::CLogWnd)
{   
    ui->setupUi(this);
    this->resize(650, 1200);
    this->setWindowFlags(Qt::FramelessWindowHint | Qt::WindowStaysOnTopHint | Qt::Window);

    // 创建模型类
    m_pLogTableModel = new CLogTableModel(this);
    ui->logTv->setModel(m_pLogTableModel);

    // 创建委托类
    auto pLogItemDelegate = new CLogItemDelegate(this);
    ui->logTv->setItemDelegate(pLogItemDelegate);

    ui->logTv->horizontalHeader()->hide();
    ui->logTv->verticalHeader()->hide();
    ui->logTv->setSelectionBehavior(QAbstractItemView::SelectionBehavior::SelectRows);

    // 连接entered信号
    connect(ui->logTv, &CLogTableView::entered, pLogItemDelegate, &CLogItemDelegate::enterItem);

    // connect(ui->logTv, &QAbstractItemView::mouseEnterItemSigal, pLogItemDelegate, &CLogItemDelegate::enterItem);

}

void CLogWnd::addLog(const QString&qsLog, const QString&qsLogSrcModule, int nLogEvel)
{
    m_pLogTableModel->addLog(qsLog, qsLogSrcModule, nLogEvel);
}

调用：

auto pLogWnd = new CLogWnd(this);
pLogWnd->addLog("a", "a1", 0);
pLogWnd->addLog("b", "b1", 2);
pLogWnd->addLog("c", "c1", 2;

3.2. 功能讲解

功能实现说明如下：

CLogTableView类中将鼠标跟踪属性设置为true，否则不会捕捉QAbstractItemView类的entered信号。
在槽函数CLogItemDelegate类的enterItem记录鼠标光标所在项目的模型索引。
在委托类CLogItemDelegate中的paint函数中检测发现如果是鼠标光标所在项目的模型索引，则改变该项的背景色，否则就采用默认背景色。
不能重载mouseMoveEvent函数，否则QAbstractItemView::entered信号不会触发,如果非要重载mouseMoveEvent函数，则在该函数中发送自定义鼠标进入视图项的信号，如本类中的mouseEnterItemSigal信号。