Qt实现表格树控件-支持多级表头
原文链接：qt实现表格树控件-支持多级表头
一、概述
之前写过一篇关于表格控件多级表头的文章，喜欢的话可以参考qt实现表格控件-支持多级列表头、多级行表头、单元格合并、字体设置等。今天这篇文章带来了比表格更加复杂的控件-树控件多级表头实现。
在qt中，表格控件包含有水平和垂直表头，但是常规使用模式下都是只能实现一级表头，而树控件虽然包含有了branch分支，这也间接的削弱了他自身的表头功能，细心的同学可能会发现qt自带的qtreeview树控件只包含有水平表头，没有了垂直表头。
既然qt自带的控件中没有这个功能，那么我们只能自己去实现了。
要实现多级表头功能方式也多种多样，之前就看到过几篇关于实现多级表头的文章，总体可以分为如下两种方式
- 表头使用一个表格来模拟
- 通过给表头自定义model
今天这篇文章我们是通过方式2来实现多级表头。如效果图所示，实现的是一个树控件的多级表头，并且他还包含了垂直列头，实现这个控件所需要完成的代码量还是比较多的。本篇文章可以算作是一个开头吧，后续会逐步把关键功能的实现方式分享出来。
二、效果展示
三、实现方式
本篇文章中的控件看起来是一个树控件，但是他又具备了表格控件该有的一些特性，比如垂直表头、多级水平表头等等。要实现这样的树控件，我们有两个大的方向可以去考虑
- 重写表格控件，实现branch
- 表格控件+树控件
方式1重写表格控件实行branch的工作量是比较大的，而且需要把qt原本的代码迁出来，工作量会比加大，个人选择了发你。
方式2是表格控件+树控件的实现方式，说白了就是表格控件提供水平和垂直表头，树控件提供内容展示，听起来好像没毛病，那么还等什么，直接干呗。
既然大方向定了，那么接下来可能就是一些细节问题的确定。
- 多级水平表头
- 垂直列头拖拽时，实现树控件行高同步变动
- 自绘branch
以上三个问题都是实现表格树控件时遇到的一些比较棘手的问题，后续会分别通过单独的文章来进行讲解，今天这篇文章也是我们的第一讲，怎么实现水平多级表头
四、多级表头
第一节我们也说了，实现多级表头我们使用重写model的方式来实现，接下来就是贴代码的时候。
1、数据源
经常重写model的同学对如下代码应该不陌生，对于继承自qabstractitemmodel的数据源肯定是需要重写该类的所有纯虚方法，包括所有间接父类的纯虚方法。
除此之外自定义model应该还需要提供一个可以合并单元格的方法，为什么呢？因为我们多级表头需要。比如说我们一级表头下有3个二级表头，那这就说明一级表头合并了3列，使得本身的3列数据变成一列。
class hheadermodel : public qabstractitemmodel
{
struct modeldata //模型数据结构
{
qstring text;
modeldata() : text("")
{
}
};
q_object
public:
hheadermodel(qobject * parent = 0);
~hheadermodel();
public:
void setitem(int row, int col, const qstring & text);
qstring item(int row, int col);
void setspan(int firstrow, int firstcolumn, int rowspancount, int columnspancount);
const cellspan& getspan(int row, int column);
public:
virtual qmodelindex index(int row, int column, const qmodelindex & parent) const override;
virtual qmodelindex parent(const qmodelindex & child) const override;
virtual int rowcount(const qmodelindex & parent) const override;
virtual int columncount(const qmodelindex & parent) const override;
virtual qvariant data(const qmodelindex & index, int role) const override;
virtual qt::itemflags flags(const qmodelindex & index) const override;
virtual bool setdata(const qmodelindex & index, const qvariant & value, int role = qt::editrole) override;
virtual qvariant headerdata(int section, qt::orientation orientation, int role) const override;
private:
//找到对应的模型数据
modeldata * modeldata(const qmodelindex & index) const;
private:
//key rowno, key colno
qmap<int, qmap<int, modeldata *> > m_modeldatamap;
int m_imaxcol;
cellspan m_invalidcellspan;
qlist<cellspan> m_cellspanlist;
};
以上便是model的头文件声明，其中重写父类的虚方法这里就不做过多说明，和平时重写其他数据源没有区别，这里多了重点说明下setspan接口。
void hheadermodel::setspan(int firstrow, int firstcolumn, int rowspancount, int columnspancount)
{
for (int row = firstrow; row < firstrow + rowspancount; ++row)
{
for (int col = firstcolumn; col < firstcolumn + columnspancount; ++col)
{
m_cellspanlist.append(cellspan(row, col, rowspancount, columnspancount, firstrow, firstcolumn));
}
}
}
const cellspan& hheadermodel::getspan(int row, int column)
{
for (qlist<cellspan>::const_iterator iter = m_cellspanlist.begin(); iter != m_cellspanlist.end(); ++iter)
{
if ((*iter).currow == row && (*iter).curcol == column)
{
return *iter;
}
}
return m_invalidcellspan;
}
setspan接口存储了哪些列或者行被合并了，在绘制表格头时我们也可以根据这些信息来计算绘制的大小和位置。
2、表格
数据源介绍完，接下来看看表头视图类，这个类相对model来说会复杂很多，主要也是根据model中存储的合并信息来进行绘制。
由于这个类代码比价多，这里我就不贴头文件声明了，下面还是主要介绍下关键函数
a、paintevent绘制函数
void hheaderview::paintevent(qpaintevent * event)
{
qpainter painter(viewport());
qmultimap<int, int> rowspanlist;
int cnt = count();
int currow, curcol;
hheadermodel * model = qobject_cast<hheadermodel *>(this->model());
for (int row = 0; row < model->rowcount(qmodelindex()); ++row)
{
for (int col = 0; col < model->columncount(qmodelindex()); ++col)
{
currow = row;
curcol = col;
qstyleoptionviewitemv4 opt = viewoptions();
qstyleoptionheader header_opt;
initstyleoption(&header_opt);
header_opt.textalignment = qt::aligncenter;
// header_opt.icon = qicon("./resources/logo.ico");
qfont fnt;
fnt.setbold(true);
header_opt.fontmetrics = qfontmetrics(fnt);
opt.fontmetrics = qfontmetrics(fnt);
qsize size = style()->sizefromcontents(qstyle::ct_headersection, &header_opt, qsize(), this);
// size.setheight(25);
header_opt.position = qstyleoptionheader::middle;
//判断当前行是否处于鼠标悬停状态
if (m_hoverindex == model->index(row, col, qmodelindex()))
{
header_opt.state |= qstyle::state_mouseover;
// header_opt.state |= qstyle::state_active;
}
opt.text = model->item(row, col);
header_opt.text = model->item(row, col);
cellspan span = model->getspan(row, col);
int rowspan = span.rowspan;
int columnspan = span.colspan;
if (columnspan > 1 && rowspan > 1)
{
//单元格跨越多列和多行, 不支持，改为多行1列
continue;
/*header_opt.rect = qrect(sectionviewportposition(logicalindex(col)), row * size.height(), sectionsizes(col, columnspan), rowspan * size.height());
opt.rect = header_opt.rect;
col += columnspan - 1; */
}
else if (columnspan > 1)//单元格跨越多列
{
header_opt.rect = qrect(sectionviewportposition(logicalindex(col)), row * size.height(), sectionsizes(col, columnspan), size.height());
opt.rect = header_opt.rect;
col += columnspan - 1;
}
else if (rowspan > 1)//单元格跨越多行
{
header_opt.rect = qrect(sectionviewportposition(logicalindex(col)), row * size.height(), sectionsize(logicalindex(col)), size.height() * rowspan);
opt.rect = header_opt.rect;
for (int i = row + 1; i <= rowspan - 1; ++i)
{
rowspanlist.insert(i, col);
}
}
else
{
//正常的单元格
header_opt.rect = qrect(sectionviewportposition(logicalindex(col)), row * size.height(), sectionsize(logicalindex(col)), size.height());
opt.rect = header_opt.rect;
}
opt.state = header_opt.state;
//opt.displayalignment = qt::aligncenter;
//opt.icon = qicon("./resources/logo.ico");
//opt.backgroundbrush = qbrush(qcolor(255, 0, 0));
qmultimap<int, int>::iterator it = rowspanlist.find(currow, curcol);
if (it == rowspanlist.end())
{
//保存当前item的矩形
m_itemrectmap[currow][curcol] = header_opt.rect;
itemdelegate()->paint(&painter, opt, model->index(currow, curcol, qmodelindex()));
painter.setpen(qcolor("#e5e5e5"));
painter.drawline(opt.rect.bottomleft(), opt.rect.bottomright());
}
else
{
//如果是跨越多行1列的情况，采用默认的paint
}
}
}
//painter.drawline(viewport()->rect().bottomleft(), viewport()->rect().bottomright());
}
b、列宽发生变化
void hheaderview::onsectionresized(int logicalindex, int oldsize, int newsize)
{
if (0 == newsize)
{
//过滤掉隐藏列导致的resize
viewport()->update();
return;
}
static bool selfemitflag = false;
if (selfemitflag)
{
return;
}
int minwidth = 99999;
qfontmetrics metrics(font());
//获取这列上最小的字体宽度，移动的长度不能大于最小的字体宽度
hheadermodel * model = qobject_cast<hheadermodel *> (this->model());
for (int i = 0; i < model->rowcount(qmodelindex()); ++i)
{
qstring text = model->item(i, logicalindex);
if (text.isempty())
continue;
int textwidth = metrics.width(text);
if (minwidth > textwidth)
{
minwidth = textwidth;
}
}
if (newsize < minwidth)
{
selfemitflag = true;
resizesection(logicalindex, oldsize);
selfemitflag = false;
}
viewport()->update();
}
3、qstyleditemdelegate绘制代理
既然说到了自绘，那么有必要说下qt自绘相关的一些东西。
a、paintevent
paintevent是qwidget提供的自绘函数，当界面刷新时该接口就会被调用。
b、复杂控件自绘
对于一些比较复杂的控件为了达到更好的定制型，qt把paintevent函数中的绘制过程进行了更为详细的切割，也可以让我们进行布局的重写。
比如今天说到的树控件，当paintevent函数调用时，其实内部真正进行绘制的是如下3个函数，重写如下三个函数可以为我们带来更友好的定制性，并且很大程度上减轻了我们自己去实现的风险。
virtual void drawbranches(qpainter *painter, const qrect &rect, const qmodelindex &index) const virtual void drawrow(qpainter *painter, const qstyleoptionviewitem &option, const qmodelindex &index) const void drawtree(qpainter *painter, const qregion ®ion) const
c、qstyleditemdelegate绘制代理
为了更好的代码管理和接口抽象，qt在处理一些超级变态的控件时提供了绘制代理这个类，即使在一些力度很小的绘制函数中依然是调用的绘制代理去绘图。
刚好我们今天说的这个表头绘制就是如此。如下代码所示，是一部分的hheaderitemdelegate::paint函数展示，主要是针对表头排序进行了定制。
void hheaderitemdelegate::paint(qpainter * painter, const qstyleoptionviewitem & option, const qmodelindex & index) const
{
int row = index.row();
int col = index.column();
const int textmargin = qapplication::style()->pixelmetric(qstyle::pm_focusframehmargin) + 1;
qstyleoptionheader header_opt;
header_opt.rect = option.rect;
header_opt.position = qstyleoptionheader::middle;
header_opt.textalignment = qt::aligncenter;
header_opt.state = option.state;
//header_opt.state |= qstyle::state_hasfocus;//qstyle::state_enabled | qstyle::state_horizontal | qstyle::state_none | qstyle::state_raised;
if (hheaderview::instance->isitempress(row, col))
{
header_opt.state |= qstyle::state_sunken; //按钮按下效果
}
// if ((qapplication::mousebuttons() && (qt::leftbutton || qt::rightbutton)))
// header_opt.state |= qstyle::state_sunken;
painter->save();
qapplication::style()->drawcontrol(qstyle::ce_header, &header_opt, painter);
painter->restore();
}
五、测试代码
把需要合并的列和行进行合并，即可达到多级表头的效果，如下是设置表格model合并接口展示。
horizontalheadermodel->setspan(0, 0, 1, 4); horizontalheadermodel->setspan(0, 4, 1, 3); horizontalheadermodel->setspan(0, 7, 1, 3); horizontalheadermodel->setspan(0, 10, 2, 1); horizontalheadermodel->setspan(0, 11, 2, 1); //不支持跨越多行多列的情况 }
model设置完毕后只要把model设置给qheaderview类即可。
六、相关文章
值得一看的优秀文章：
如果您觉得文章不错，不妨给个打赏，写作不易，感谢各位的支持。您的支持是我最大的动力，谢谢！！！
很重要--转载声明
本站文章无特别说明，皆为原创，版权所有，转载时请用链接的方式，给出原文出处。同时写上原作者： or twowords
如要转载，请原文转载，如在转载时修改本文，请事先告知，谢绝在转载时通过修改本文达到有利于转载者的目的。
上一篇： 人参的茎叶有哪些作用和功效