Qt實現表格樹控制項-支持多級表頭

来源:https://www.cnblogs.com/swarmbees/archive/2019/08/04/11167659.html
-Advertisement-
Play Games

[TOC] 原文鏈接： "Qt實現表格樹控制項 支持多級表頭" 一、概述 之前寫過一篇關於表格控制項多級表頭的文章，喜歡的話可以參考 "Qt實現表格控制項 支持多級列表頭、多級行表頭、單元格合併、字體設置等" 。今天這篇文章帶來了比表格更加複雜的控制項 樹控制項多級表頭實現。 在Qt中，表格控制項包含有水平和垂 ...


目錄

原文鏈接：Qt實現表格樹控制項-支持多級表頭

一、概述

之前寫過一篇關於表格控制項多級表頭的文章，喜歡的話可以參考Qt實現表格控制項-支持多級列表頭、多級行表頭、單元格合併、字體設置等。今天這篇文章帶來了比表格更加複雜的控制項-樹控制項多級表頭實現。

在Qt中，表格控制項包含有水平和垂直表頭，但是常規使用模式下都是只能實現一級表頭，而樹控制項雖然包含有了branch分支，這也間接的削弱了他自身的表頭功能，細心的同學可能會發現Qt自帶的QTreeView樹控制項只包含有水平表頭，沒有了垂直表頭。

既然Qt自帶的控制項中沒有這個功能，那麼我們只能自己去實現了。

要實現多級表頭功能方式也多種多樣，之前就看到過幾篇關於實現多級表頭的文章，總體可以分為如下兩種方式

  1. 表頭使用一個表格來模擬
  2. 通過給表頭自定義Model

今天這篇文章我們是通過方式2來實現多級表頭。如效果圖所示，實現的是一個樹控制項的多級表頭，並且他還包含了垂直列頭，實現這個控制項所需要完成的代碼量還是比較多的。本篇文章可以算作是一個開頭吧，後續會逐步把關鍵功能的實現方式分享出來。

二、效果展示

三、實現方式

本篇文章中的控制項看起來是一個樹控制項，但是他又具備了表格控制項該有的一些特性，比如垂直表頭、多級水平表頭等等。要實現這樣的樹控制項，我們有兩個大的方向可以去考慮

  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. 財聯社-產品展示
  2. 廣聯達-產品展示
  3. Qt定製控制項列表
  4. 牛逼哄哄的Qt庫

  1. Qt實現表格控制項-支持多級列表頭、多級行表頭、單元格合併、字體設置等

  2. Qt高仿Excel表格組件-支持凍結列、凍結行、內容自適應和合併單元格

  3. 屬性瀏覽器控制項QtTreePropertyBrowser編譯成動態庫(設計師插件)

  4. 超級實用的屬性瀏覽器控制項--QtTreePropertyBrowser

  5. Qt之表格控制項螞蟻線

  6. QRowTable表格控制項-支持hover整行、checked整行、指定列排序等





如果您覺得文章不錯，不妨給個打賞，寫作不易，感謝各位的支持。您的支持是我最大的動力，謝謝！！！













很重要--轉載聲明

  1. 本站文章無特別說明，皆為原創，版權所有，轉載時請用鏈接的方式，給出原文出處。同時寫上原作者：朝十晚八 or Twowords

  2. 如要轉載，請原文轉載，如在轉載時修改本文，請事先告知，謝絕在轉載時通過修改本文達到有利於轉載者的目的。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • RocketMQ中Broker的啟動源碼分析（二）
    接著上一篇博客 【RocketMQ中Broker的啟動源碼分析（一）】 在完成準備工作後，調用start方法： 這裡最主要的是通過BrokerController 的start方法來完成啟動 BrokerController的start方法： 首先通過messageStore啟動messageSto ...
  • Java8 Optional
    Java8 新增了 Optional 類，可以更加優雅地解決空指針的問題。 構造器 Optional 的構造器是私有的，不能通過 new 的方式來創建 Optional 對象，因此，Optional 提供了三個靜態方法創建 Optional 對象，分別為 /`of(T value) ofNullab ...
  • SpringIOC源碼解析（上）
    註意，看完這篇文章需要很長很長很長時間。。。 準備工作 本文會分析Spring的IOC模塊的整體流程，分析過程需要使用一個簡單的demo工程來啟動Spring，demo工程我以備好，需要的童鞋自行在下方鏈接下載： 1 https://github.com/shiyujun/spring-framew ...
  • 【Vue的路由，SPA概念】
    前言 本章是為了以後實現前端頁面的搭建而寫的， 重點在於如何實現 單頁Web應用 因為相對於以前的傳統多頁面web，有很大的缺陷。 那麼就必須瞭解一下Vue的路由設置。 SPA的概念 總的而言，我們知道之前的話都是用的是許多jsp,或html頁面來組成我們的項目的。 那麼這樣有什麼缺點呢？ 所以，在 ...
  • C++中const關鍵字用法總結
    先發個標題，明天再碼 ...
  • F#周報2019年第31期
    新聞 "現在開始接受FSSF的第七次師友計劃申請" "Xamarin播客：XAML熱重載" "TorchSharp：將PyTorch引擎帶入.NET" 視頻及幻燈片 "F 中的非同步編程2/3——實現非同步工作流" "ML.NET中的異常檢測轉換" 博客 "使用F 腳本進行互動式開發" "在AWS La ...
  • 圖解數據結構樹之AVL樹
    AVL樹(平衡二叉樹)： AVL樹本質上是一顆二叉查找樹，但是它又具有以下特點：它是一棵空樹或它的左右兩個子樹的高度差的絕對值不超過1，並且左右兩個子樹都是一棵平衡二叉樹。在AVL樹中任何節點的兩個子樹的高度最大差別為一，所以它也被稱為平衡二叉樹。下麵是平衡二叉樹和非平衡二叉樹對比的例圖： 平衡因數 ...
  • 學習python基礎規則
    前面應該是記流水賬的方式，畢竟學習的內容不多無法產出什麼有效的內容。 這兩天從開始下載Python開始學習，一路順暢冒的問題，直到開始學習python的游戲規則，嚴格縮進、註釋及‘’的使用等感覺還不錯，多看幾遍都可以記下來，但是沒實操過還是有點記憶較差。 python對象，也就是列表等使用規則和特征 ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發（一）：使用.NET MAUI開發第一個安卓APP
    移動開發（一）：使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說，近來想嘗試開發一款安卓APP，考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP，畢竟是使用Visual Studio開發工具，使用起來也比較的順手，結合微軟官方的教程進行了安卓 ...
  • wpf ToggleButton選中效果和一個登錄界面
    前言 QuestPDF 是一個開源 .NET 庫，用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫，它徹底改變了我們生成 PDF 文檔的方 ...
  • 彈幕樹洞項目功能新增篇
    項目地址 項目後端地址： https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址： ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址： http://tree ...
  • 第27篇 sqlserver2022詳細安裝步驟
    話不多說，直接開乾 一.下載 1.官方鏈接下載： https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe，運行開始下載SQL server； 二. ...
  • .NET 開源高性能 MQTT 類庫
    前言 隨著物聯網（IoT）技術的迅猛發展，MQTT（消息隊列遙測傳輸）協議憑藉其輕量級和高效性，已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫，為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog文檔翻譯系列（六） - 可用的接收器、增強器、格式化輸出
    Serilog支持多種接收器用於日誌存儲，增強器用於添加屬性，LogContext管理動態屬性，支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項，適用於不同需求。 ...
  • 警惕 Visual Studio 屬性求值副作用導致邏輯不符合預期
    目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據，爬取信息時需要模擬瀏覽器行為，否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下： 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • [使用目前最新版]HybridCLR6.9.0+YooAsset2.2.4實現純C# Unity熱更新方案 (一)
    1.前言 什麼是熱更新 游戲或者軟體更新時，無需重新下載客戶端進行安裝，而是在應用程式啟動的情況下，在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR，Xlua，ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles，Addressable， ...
  • 在 ASP.NET Core Web API 中使用操作篩選器統一處理通用操作
    本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺，其實像阿裡雲，騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後，它會送 ...
  • 第28篇 如何.net中實現高效可靠數據同步api
    通過以下方式可以高效，並保證數據同步的可靠性 1.API設計 使用RESTful設計，確保API端點明確，並使用適當的HTTP方法（如POST用於創建，PUT用於更新）。 設計清晰的請求和響應模型，以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證，確保接收到的數據符合預期格 ...
所有分類