QRowTable表格控件-支持hover整行、checked整行、指定列排序等

时间:2022-04-27 17:50:29

原文链接:QRowTable表格控件-支持hover整行、checked整行、局部列排序等

一、开心一刻

老公和老婆晚上回家,路旁突然跳出三个持刀蒙面大汉:“绑架!你俩可以走一个,回家等消息。”

老公一把将老婆推开:“老婆快走!”待老婆走远后,三个蒙面人摘下面具:“尼玛现在找你打个麻将这么费劲?”

五分钟后老公致电老婆:"往卡里打五千块,别报警,他们说关我一夜明早放人。"十分钟后老公从卡里取走五千块战斗到天明。

次日老公回家,老婆扑上来含泪说:“关键时候才能看出老公对我的好,老公以后我啥都听你的!

二、嘴一嘴

看完笑话,我们进入正题。

本篇文章我们带来的是一个表格的简单使用,主要是把表格的hover、checked进行了重新定制,支持用户自己去设置相关颜色,并且可以对指定列进行放大缩小等。

为什么会写这篇文章呢?博主自己使用Qt也好几年了,对于Qt的使用算是比较有心得了吧。最近在做表格的一些相关东西,发现网上的很多文章讲的不是特别好,因此将自己做的一个简单事例做一分享,希望能帮到有需要的同学。

本篇文章我们主要对表格的以下内容进行了封装,内容比较有限,有深度定制需求的同学可以加我QQ详谈。

  1. hover行背景色
  2. checked行背景色
  3. 列宽是否可排序
  4. 列宽允许拖动范围
  5. 准确定位hover状态

三、效果展示

如下图所示,一个简单的gif效果展示。

配色时博主自己随便搞的,配色只能说很一般,大家主要看效果和实现思路。

QRowTable表格控件-支持hover整行、checked整行、指定列排序等

四、浅谈实现

使用过QTableView或者了解控件的同学应该都很清楚,表格是一个很强大的控件,支持我们做各种各样的功能,博主之前也想过几篇相关的文章,都是讲述表格控件的。

  1. Qt实现表格控件-支持多级列表头、多级行表头、单元格合并、字体设置等

  2. Qt高仿Excel表格组件-支持冻结列、冻结行、内容自适应和合并单元格

  3. 属性浏览器控件QtTreePropertyBrowser编译成动态库(设计师插件)

  4. 超级实用的属性浏览器控件--QtTreePropertyBrowser

  5. Qt之表格控件蚂蚁线

当然了表格控件的使用远远不止于此,后续有时间和精力我会陆续推出更多有用好玩儿的功能。

本篇文章的功能实现也比较简单,写这个demo我大概用了大半天的时间,代码量其实不多,大部分的时间主要用来设计接口和重构逻辑功能了。

如下图所示,是整个工程目录结构,这里主要重写了数据源model和view

QRowTable表格控件-支持hover整行、checked整行、指定列排序等

下面我们就分别讲述model和view都干了些什么

五、自定义数据源

所谓数据源,其实主要就是给view提供数据的地方,这里我们取了一个巧,数据源直接继承自QStandarItemModel,这样的话数据的存储和获取大部分的工作都不需要我们去关心,因为QStandarItemModel这个类已经做的很完善。

这里我们主要从写了两个接口

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

virtual Qt::ItemFlags flags(const QModelIndex & index) const override;

1、data函数

视图获取数据的接口就是data,因此这个接口我们必须重写,实现代码也很简单,主要是需要大家对Qt的MVC有一个基本的认识。

QVariant QRowModel::data(const QModelIndex & index, int role /*= Qt::DisplayRole*/) const
{
if (Qt::BackgroundRole == role)
{
if (index.row() == m_iHoverRow)
{
return m_HoverColor;
}
}
else if (role == Qt::ForegroundRole)
{
if (index.row() == m_iHoverRow)
{
return m_HoverColor.lighter(255);
}
} return QStandardItemModel::data(index, role);
}

看上述代码,当绘制视图的时候,hover一行时,我们需要返回自定义的颜色值,其他情况走默认处理即可,是不是很简单。

关于checked的实现不能放在这里,因为当item被选中的时候,item的背景色不是取自Qt::BackgroundRole,同时前景色也不是取自Qt::ForegroundRole,因此这里处理不了。

如果非要让checked状态在这里实现也是有办法的,我们可以重写flags函数,让item不能被选中,这个办法博主是试过的,没有问题。 但是就存在一个隐,如果后期我们的item想被选中,就比较麻烦了。

基于以上设想,我们只需要这样重写flags函数,然后在data函数中返回checked行的背景色和前景色即可。

Qt::ItemFlags QRowModel::flags(const QModelIndex & index) const
{
return Qt::ItemIsEnabled;
}

2、flags函数

上一小节flags函数都已经展示出来了,item处于可用状态,这里还需要在添加上可选中状态,以免有其他坑

Qt::ItemFlags QRowModel::flags(const QModelIndex & index) const
{
return Qt::ItemIsEnabled | Qt::ItemIsSelectable;
}

以上就是model函数的重写了,比较简单,下面放出model的头文件

/**
* 简介: 主要提供接口 提供hover行
*/
class QRowModel : public QStandardItemModel
{
Q_OBJECT public:
explicit QRowModel(QObject * parent = 0);
~QRowModel(); private:
//hover时背景色 不建议外部直接调用
void SetHoverColor(const QColor & color);
QColor GetHoverColor() const { return m_HoverColor; } //设置当前hover行 不建议外部直接调用
void SetHoverRow(int row);
int GetHoverRow() const { return m_iHoverRow; } protected:
virtual QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; virtual Qt::ItemFlags flags(const QModelIndex & index) const override; private:
int m_iHoverRow = -1;//没有hover
QColor m_HoverColor = QColor(20, 22, 23); friend class QRowTable;
};

六、自定义视图

下面讲述今天的重头戏view。

首先需要搞清楚,重写视图需要完成哪些工作,才能更好的准备定位每个函数的意思。

1、目的

  1. hover时,把hover行通知到数据源
  2. 准确的hover和取消hover状态,这个问题确实搞了好久
  3. 点击item时,设置行选中色
  4. 指定列可排序

有了以上目标之后,我们逐个问题解决。

2、问题分析

针对以上4个目的,我们逐个分析解决办法

1、鼠标hover到这个比较简单,而且可以通过多种方式进行获取。

想要拿到这个状态,有一个很重要的属性需要开启:setMouseTracking(true);

a、如果我们重写的是QTableWidget这个类,那么可以去接收cellEntered这个信号

b、如果重写跟本篇文章一样,重写的QTableView这个类,那么我们需要重写mouseMoveEvent这个函数,然后通过indexAt函数获取当前行。

void QRowTable::mouseMoveEvent(QMouseEvent * event)
{
QTableView::mouseMoveEvent(event); const QModelIndex & index = indexAt(event->pos());
int row = -1;
if (index.isValid())
{
row = index.row();
} if (m_pModel->GetHoverRow() != row)
{
m_pModel->SetHoverRow(index.row());
viewport()->update();
}
}

2、取消hover装态

这个问题处理确实化了好长时间,主要还是想处理的办法更优雅,效率高一些。

这里为了实现不在item上时立刻取消hover状态,主要做了2件事。

第一件事

重写leaveEvent函数,鼠标离开时,恢复hover行为-1

void QRowTable::leaveEvent(QEvent * e)
{
if (m_pModel->GetHoverRow() != -1)
{
m_pModel->SetHoverRow(-1);
viewport()->update();
}
QTableView::leaveEvent(e);
}

第二件事

重写了QHeaderView,当鼠标在表头移动时,发送MouseMove信号,重置当前hover行为-1

void QRowHeader::mouseMoveEvent(QMouseEvent * event)
{
emit MouseMove(); QHeaderView::mouseMoveEvent(event);
}
auto callback = [this]{
if (m_pModel->GetHoverRow() != -1)
{
m_pModel->SetHoverRow(-1);
viewport()->update();
}
};
connect(vHeader, &QRowHeader::MouseMove, this, callback);
connect(hHeader, &QRowHeader::MouseMove, this, callback);

以上这个办法也是不得已为之,如果大家有更好的办法,欢迎评论区留言

3、点击item时设置当前行高亮背景色

第一小节的最后,我们也提到了,checked正行可以放到data函数中完成,但是由于我们的item有了可选择属性后,当前选中的item,或者选中行的背景色和前景色都是取自以下两个属性,因此这里我们只需要把这两个属性颜色值进行设置即可。

QPalette::Highlight
QPalette::HighlightedText

设置checked行颜色实现方式如下。

void QRowTable::SetCheckedColor(const QColor & color)
{
m_CheckedColor = color; QPalette palette = this->palette();
palette.setBrush(QPalette::Inactive, QPalette::Highlight, m_CheckedColor);
palette.setBrush(QPalette::Inactive, QPalette::HighlightedText, m_CheckedColor.lighter(255));
setPalette(palette);
}

如果仔细想一想,可能就会觉得有些问题,这里我们怎么去控制是一个单元格背景色还是整行背景色呢?

莫慌,加上以下两个属性即可,接口真的很简单,啥意思我就不说了。如果实现不知道的同学,欢迎评论区留言

setSelectionBehavior(QAbstractItemView::SelectRows);
setSelectionMode(QTableView::SingleSelection);//不能多选

4、 指定列排序

首先需要搞清楚Qt自带的排序处理逻辑,然后才可以对症下药,这里我也是跟了Qt自己代码,然后各种分析后,得出的处理方式。

Qt的代码分析这里不做讨论,有需要的同学私信吧。

各种代码跟踪后发现,当我们设置了setSortingEnabled为true时,Qt就支持排序了,并且在排序完成后会发给我们一个sortIndicatorChanged信号,这个信号主要是用来显示排序三角形的。

如果我们想不显示排序三角形,但是只是排序也是可以的,可以在接收这个信号后,调用setSortIndicatorShown接口隐藏三角形

为什么会这样麻烦呢?因为楼主跟踪Qt的代码了,发现如果排序了,Qt的三角形就是必须画出来的

void QHeaderView::paintSection(QPainter *painter, const QRect &rect, int logicalIndex) const
{
...
if (isSortIndicatorShown() && sortIndicatorSection() == logicalIndex)
opt.sortIndicator = (sortIndicatorOrder() == Qt::AscendingOrder)
? QStyleOptionHeader::SortDown : QStyleOptionHeader::SortUp; ...
}

是不是很刺激,Qt太强大了,啥事情都给我们搞好了。

本篇文章我们主要是实现指定列不能进行排序,因此处理函数是这么干的,当接收到非排序列排序信号时,调用setSortingEnabled接口设置禁止排序。

void QRowTable::SortColumnChanged(int logicalIndex, Qt::SortOrder order)
{
if (m_Indicator.contains(logicalIndex) && m_Indicator[logicalIndex] == false)
{
if (isSortingEnabled())
{
setSortingEnabled(false);
}
}
else
{
if (isSortingEnabled() == false)
{
setSortingEnabled(true);
}
}
}

七、测试

1、view配置

QRowTable w;

//前两列不可排序
w.SetIndicatorVisible(0, false);
w.SetIndicatorVisible(1, false); //设置列最大宽度
w.SetColumnMinWidth(50); //设置列最小宽度
w.SetColumnMaxWidth(150); w.SetHoverColor(Qt::red);

2、model配置

QRowModel * model = w.GetModel();

QStringList headlist;
headlist << QStringLiteral("代码") << QStringLiteral("名称") << QStringLiteral("行业") << QStringLiteral("价格") << QStringLiteral("涨跌幅") << QStringLiteral("换手率");
model->setHorizontalHeaderLabels(headlist);

数据添加就跟我们平时往QStandardItemModel中放数据类似,代码太长就不放出来了。

八、相关文章

  1. Qt实现表格控件-支持多级列表头、多级行表头、单元格合并、字体设置等

  2. Qt高仿Excel表格组件-支持冻结列、冻结行、内容自适应和合并单元格

  3. 属性浏览器控件QtTreePropertyBrowser编译成动态库(设计师插件)

  4. 超级实用的属性浏览器控件--QtTreePropertyBrowser

  5. Qt之表格控件蚂蚁线

以上就是本篇文章的所有内容了,一个简易的整行hover、整行checked的表格

如果您觉得文章不错,不妨给个打赏,写作不易,感谢各位的支持。您的支持是我最大的动力,谢谢!!!
QRowTable表格控件-支持hover整行、checked整行、指定列排序等 QRowTable表格控件-支持hover整行、checked整行、指定列排序等

很重要--转载声明

  1. 本站文章无特别说明,皆为原创,版权所有,转载时请用链接的方式,给出原文出处。同时写上原作者:朝十晚八 or Twowords

  2. 如要转载,请原文转载,如在转载时修改本文,请事先告知,谢绝在转载时通过修改本文达到有利于转载者的目的。