如何為Qt視圖中的文字實現(xiàn)彩虹漸變效果

更新時間：2019年03月10日 11:01:54 作者：apocelipes

這篇文章主要給大家介紹了關于如何為Qt視圖中的文字實現(xiàn)彩虹漸變效果的相關資料，文中通過示例代碼介紹的非常詳細，對大家的學習或者使用Qt具有一定的參考學習價值，需要的朋友們下面來一起學習學習吧

前言

將view中的文本內(nèi)容用自定義的顏色顯示是一種十分常見的需求。今天我們稍微改變些“花樣”。下面話不多說了，來一起看看詳細的介紹吧

需求定義

我們的需求很簡單，現(xiàn)在有一些在view中的text內(nèi)容需要使用彩色顯示，而且不使用單一的一種顏色，而是多種顏色漸變實現(xiàn)的彩虹效果。

文字描述可能比較抽象，所以我們先給出預想的效果圖：

現(xiàn)在讓我們想辦法實現(xiàn)圖中的效果。

需求分析

好在Qt的Model/View機制對于用戶自定義的外觀控制提供了極為豐富的支持，因此我們可以輕松地實現(xiàn)許多獨特的顯示效果。

通常情況下，對于像按特定顏色顯示內(nèi)容的需求只需要在model的data接口中根據(jù)調(diào)用時的Qt::ItemDataRole返回對應的數(shù)據(jù)即可，比如控制文本顏色時我們只需要對Qt::ForegroundRole返回指定的QBrush對象就可以。

但是仔細思考之后你就會發(fā)現(xiàn)這種辦法并不能解決我們的需求。

我們想要實現(xiàn)漸變效果是不能只返回單一的一種顏色的，需要用到QLinearGradient，并且需要指定線性填充的坐標及大小。而我們光從Qt::ItemDataRole是拿不到文字的顯示范圍的，因此我們就不能指定漸變填充的范圍了。

不過正如本節(jié)開頭所說，Qt提供了足夠多的途徑讓你控制元素的外觀。所以我們很快就把目光投向了delegate，一種經(jīng)常用來控制model中數(shù)據(jù)顯示的工具。

雖然delegate更多的是充當了顯示非文本數(shù)據(jù)以及控制顯示格式的責任，但是只要實現(xiàn)了它的paint方法。我們一樣可以繪制想要的效果。特別的，paint方法還會將待繪制區(qū)域的信息從參數(shù)中傳入，因此我們有充足的條件使用QLinearGradient實現(xiàn)文字的漸變效果了。

現(xiàn)在已經(jīng)清楚實現(xiàn)我們的需求的思路了，接下來我們看看如何用代碼實現(xiàn)它。

代碼實現(xiàn)

我們只需要繼承QStyledItemDelegate并重寫它的paint和sizeHint方法：

class ColorDelegate : public QStyledItemDelegate {
public:
 void paint(QPainter *painter, const QStyleOptionViewItem &option,
    const QModelIndex &index) const override;

 QSize sizeHint(const QStyleOptionViewItem &option,
     const QModelIndex &index) const override;
};

其中paint用來繪制我們的顯示效果，而sizeHint則返回item的大小。

對于sizeHint沒有什么特別的操作，單純計算文字的長度和高度，然后基于這連個值指定item的大?。?/p>

QSize ColorDelegate::sizeHint(const QStyleOptionViewItem &option,
        const QModelIndex &index) const {
 auto text = index.data().toString();
 auto width = option.fontMetrics.width(text) + 20;
 return QSize{width, option.fontMetrics.height()};
}

下面就要進入重點了：

void ColorDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option,
       const QModelIndex &index) const {
 auto text = index.data().toString();
 auto myOpt = option;
 myOpt.displayAlignment = Qt::AlignCenter;
 auto sWidth = myOpt.fontMetrics.width(text);
 auto sHeight = myOpt.fontMetrics.height();
 // 計算文字所在的范圍，因為是居中對齊，所以需要計算相應的起始位置
 auto sRect = QRectF(myOpt.rect.x() + (myOpt.rect.width() - sWidth) / 2.0,
      myOpt.rect.y() + ((myOpt.rect.height() - sHeight) / 2.0), sWidth, sHeight);

 // 將漸變填充的范圍設置成文字所在的范圍
 QLinearGradient l(sRect.x(), sRect.y(), sRect.x() + sRect.width(),
      sRect.y() + sRect.height());

 // 設置彩虹色漸變效果，彩虹由赤橙黃綠青藍紫的顏色組成
 // 因此我們除去起始點為紅色，每隔1/6就設置一種顏色
 l.setColorAt(0, Qt::red);
 l.setColorAt(1.0 / 6, QColor(255, 97, 0));
 l.setColorAt(2.0 / 6, QColor(255, 255, 0));
 l.setColorAt(3.0 / 6, Qt::green);
 l.setColorAt(4.0 / 6, Qt::cyan);
 l.setColorAt(5.0 / 6, Qt::blue);
 l.setColorAt(1, QColor(255, 0, 255));

 // 這里并不使用painter，只需要QStyle即可實現(xiàn)效果
 // QPalette::Text為文本顯示效果的role
 auto role = QPalette::Text;
 if (option.state & QStyle::State_Selected) {
  // 當前item被選中時繪制高亮的選中框
  role = QPalette::HighlightedText;
  painter->fillRect(option.rect, option.palette.highlight());
 }
 myOpt.palette.setBrush(role, QBrush(l));
 // 注意最后一個參數(shù)role，只有設置了它才能讓QStyle正確地繪制自定義的文本顯示效果
 QApplication::style()->drawItemText(painter, myOpt.rect, myOpt.displayAlignment,
          myOpt.palette, true, text, role);
}

需要注意的都已經(jīng)在注釋中說明，可以看到paint的邏輯實際上并不復雜，只需要正確計算文字的顯示范圍后調(diào)用相應的繪制接口即可。

可能你會有些疑惑，為什么要計算文本的范圍？答案是因為如果將整個item作為填充范圍的話，那么文本之外的空白部分也會被計算進去，因此文本的顯示效果會被view的拉伸的縮小所影響，顯然不是我們希望的結(jié)果，因此只填充文本所在的范圍就很有必要了。

至于delegate的其他功能，我們選擇繼續(xù)使用父類的默認實現(xiàn)，因為我們只是使用delegate控制顯示效果的功能，并不需要實現(xiàn)和數(shù)據(jù)的交互。

下面我們測試下自定義的ColorDelegate：

#include <QApplication>
#include <QStandardItemModel>
#include <QListView>
#include <QVBoxLayout>

#include "ColorDelegate.h"

int main(int argc, char **argv) {
 QApplication app(argc, argv);

 auto win = new QWidget{};
 auto model = new QStandardItemModel{win};
 model->appendRow(new QStandardItem{"C++"});
 model->appendRow(new QStandardItem{"GoLang"});
 model->appendRow(new QStandardItem{"JavaScript"});
 model->appendRow(new QStandardItem{"Object C"});
 model->appendRow(new QStandardItem{"Rust"});
 model->appendRow(new QStandardItem{"這是一串非常非常長的被作為測試用例的樣本字符串。"});
 model->appendRow(new QStandardItem{"██████████████████"});
 auto view = new QListView{};
 view->setModel(model);
 view->setItemDelegate(new ColorDelegate{}); // 設置自定義delegate

 auto layout = new QVBoxLayout{};
 layout->addWidget(view);
 win->setLayout(layout);
 win->show();

 app.exec();
}

運行之后你就會看到如下圖的界面：