欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

Qt实现表格树控件-支持多级表头

程序员文章站 2023-11-19 19:31:28
[TOC] 原文链接: "Qt实现表格树控件 支持多级表头" 一、概述 之前写过一篇关于表格控件多级表头的文章,喜欢的话可以参考 "Qt实现表格控件 支持多级列表头、多级行表头、单元格合并、字体设置等" 。今天这篇文章带来了比表格更加复杂的控件 树控件多级表头实现。 在Qt中,表格控件包含有水平和垂 ......

原文链接:qt实现表格树控件-支持多级表头

一、概述

之前写过一篇关于表格控件多级表头的文章,喜欢的话可以参考qt实现表格控件-支持多级列表头、多级行表头、单元格合并、字体设置等。今天这篇文章带来了比表格更加复杂的控件-树控件多级表头实现。

在qt中,表格控件包含有水平和垂直表头,但是常规使用模式下都是只能实现一级表头,而树控件虽然包含有了branch分支,这也间接的削弱了他自身的表头功能,细心的同学可能会发现qt自带的qtreeview树控件只包含有水平表头,没有了垂直表头。

既然qt自带的控件中没有这个功能,那么我们只能自己去实现了。

要实现多级表头功能方式也多种多样,之前就看到过几篇关于实现多级表头的文章,总体可以分为如下两种方式

  1. 表头使用一个表格来模拟
  2. 通过给表头自定义model

今天这篇文章我们是通过方式2来实现多级表头。如效果图所示,实现的是一个树控件的多级表头,并且他还包含了垂直列头,实现这个控件所需要完成的代码量还是比较多的。本篇文章可以算作是一个开头吧,后续会逐步把关键功能的实现方式分享出来。

二、效果展示

Qt实现表格树控件-支持多级表头

三、实现方式

本篇文章中的控件看起来是一个树控件,但是他又具备了表格控件该有的一些特性,比如垂直表头、多级水平表头等等。要实现这样的树控件,我们有两个大的方向可以去考虑

  1. 重写表格控件,实现branch
  2. 表格控件+树控件

方式1重写表格控件实行branch的工作量是比较大的,而且需要把qt原本的代码迁出来,工作量会比加大,个人选择了发你。

方式2是表格控件+树控件的实现方式,说白了就是表格控件提供水平和垂直表头,树控件提供内容展示,听起来好像没毛病,那么还等什么,直接干呗。

既然大方向定了,那么接下来可能就是一些细节问题的确定。

  1. 多级水平表头
  2. 垂直列头拖拽时,实现树控件行高同步变动
  3. 自绘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 &region) 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类即可。

六、相关文章

值得一看的优秀文章:

  1. qt定制控件列表
  2. 牛逼哄哄的qt库

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

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

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

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

  5. qt之表格控件蚂蚁线

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





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








Qt实现表格树控件-支持多级表头 Qt实现表格树控件-支持多级表头






很重要--转载声明

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

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