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

目录

• 一、开心一刻
• 二、嘴一嘴
• 三、效果展示
• 四、浅谈实现
• 五、自定义数据源
  • 1、data函数
  • 2、flags函数
• 六、自定义视图
  • 1、目的
  • 2、问题分析
• 七、测试
• 八、相关文章

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

一、开心一刻

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

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

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

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

二、嘴一嘴

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

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

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

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

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

三、效果展示

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

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

四、浅谈实现

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

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

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

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

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

5. Qt之表格控件蚂蚁线

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

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

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

下面我们就分别讲述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的表格

如果您觉得文章不错，不妨给个打赏，写作不易，感谢各位的支持。您的支持是我最大的动力，谢谢！！！

---

很重要--转载声明

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

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

---