QT 圖標字體類IconHelper封裝支持Font Awesome 5

IconHelper 類封裝支持Font Awesome5 Solid、Regular、BrandsRegular。兼容Font Awesome4

在這裏插入圖片描述
最近使用Font Awesome封裝類的時候發現只支持到Font Awesome4.7。有個換膚圖標找了半天沒找到,在官網找了一下Font Awesome5.10已經有了這個圖標。但是我使用的IconHelper這個網上封裝的類。於是自己重新封裝了一下。使它支持Font Awesome5各個版本,同時兼容Font Awesome4.7字體庫,默認使用Font Awesome5 Solid,可以自己改成默認4.7的字庫,需要自己下載字庫後,把字體庫導入圖片資源文件,然後修改一下下面的IconHelper類的構造函數裏面的字體庫路徑即可,直接上代碼:

iconhelper.h

#ifndef ICONHELPER_H
#define ICONHELPER_H

#include <QtCore>
#include <QtGui>
#if (QT_VERSION > QT_VERSION_CHECK(5,0,0))
    #include <QtWidgets>
#endif

enum FontType_E
{
    FontAwesome4,
    FontAwesome5BrandsRegular,
    FontAwesome5FreeRegular,
    FontAwesome5FreeSolid,
};


//圖形字體處理類
class IconHelper : public QObject
{
    Q_OBJECT

public:
    static IconHelper *Instance();
    explicit IconHelper(QObject *parent = 0);

    //默認字體使用FontAwesome4.7,默認字體大小12
    void setIcon(QLabel *lab, const QChar &str, FontType_E fontType = FontAwesome5FreeSolid, quint32 size = 12);
    void setIcon(QAbstractButton *btn, const QChar &str, FontType_E fontType = FontAwesome5FreeSolid, quint32 size = 12);
    QPixmap getPixmap(const QColor &color, const QChar &str, FontType_E fontType = FontAwesome5FreeSolid,  quint32 size = 12,
                      quint32 pixWidth = 15, quint32 pixHeight = 15, int flags = Qt::AlignCenter);
    //下面會使用上面的getPixmap接口獲取圖標字體。


    //根據按鈕獲取該按鈕對應的圖標
    QPixmap getPixmap(QToolButton *btn, bool normal);

    //指定導航面板樣式,不帶圖標
    static void setStyle(QWidget *widget, const QString &type = "left", int borderWidth = 3,
                         const QString &borderColor = "#029FEA",
                         const QString &normalBgColor = "#292F38",
                         const QString &darkBgColor = "#1D2025",
                         const QString &normalTextColor = "#54626F",
                         const QString &darkTextColor = "#FDFDFD");

    //指定導航面板樣式,帶圖標和效果切換
    void setStyle(QWidget *widget, QList<QToolButton *> btns, QList<int> pixChar, FontType_E fontType = FontAwesome5FreeSolid,
                  quint32 iconSize = 12, quint32 iconWidth = 15, quint32 iconHeight = 15,
                  const QString &type = "left", int borderWidth = 3,
                  const QString &borderColor = "#029FEA",
                  const QString &normalBgColor = "#292F38",
                  const QString &darkBgColor = "#1D2025",
                  const QString &normalTextColor = "#54626F",
                  const QString &darkTextColor = "#FDFDFD");

    //指定導航按鈕樣式,帶圖標和效果切換
    void setStyle(QFrame *frame, QList<QToolButton *> btns, QList<int> pixChar, FontType_E fontType = FontAwesome5FreeSolid,
                  quint32 iconSize = 12, quint32 iconWidth = 15, quint32 iconHeight = 15,
                  const QString &normalBgColor = "#2FC5A2",
                  const QString &darkBgColor = "#3EA7E9",
                  const QString &normalTextColor = "#EEEEEE",
                  const QString &darkTextColor = "#FFFFFF");


protected:
    bool eventFilter(QObject *watched, QEvent *event);

private:
    static QScopedPointer<IconHelper> self;
    QFont iconFont;             //圖形字體FontAwesome4.7
    QFont iconFontBrandsRegular;//圖形字體FontAwesome5BrandsRegular
    QFont iconFontFreeRegular;  //圖形字體FontAwesome5FreeRegular
    QFont iconFontFreeSolid;    //圖形字體FontAwesome5FreeSolid

    QList<QToolButton *> btns;  //按鈕隊列
    QList<QPixmap> pixNormal;   //正常圖片隊列
    QList<QPixmap> pixDark;     //加深圖片隊列
};
#endif // ICONHELPER_H

iconhelper.cpp

#include "iconhelper.h"

QScopedPointer<IconHelper> IconHelper::self;
IconHelper *IconHelper::Instance()
{
    if (self.isNull())
    {
        QMutex mutex;
        QMutexLocker locker(&mutex);
        if (self.isNull())
        {
            self.reset(new IconHelper);
        }
    }

    return self.data();
}

IconHelper::IconHelper(QObject *parent) : QObject(parent)
{
    //判斷圖形字體是否存在,不存在則加入
    QFontDatabase fontDb;
    if (!fontDb.families().contains("FontAwesome"))
    {
        int fontId = QFontDatabase::addApplicationFont(":/image/fontawesome-webfont.ttf");
        QStringList fontName = QFontDatabase::applicationFontFamilies(fontId);
        if (fontName.count() == 0)
        {
            qDebug() << "load fontawesome-webfont.ttf error";
        }
    }

    if (!fontDb.families().contains("Font Awesome 5 Brands Regular"))
    {
        int fontId = QFontDatabase::addApplicationFont(":/image/Font Awesome 5 Brands-Regular-400.otf");
        QStringList fontName = QFontDatabase::applicationFontFamilies(fontId);
        if (fontName.count() == 0)
        {
            qDebug() << "load Font Awesome 5 Brands-Regular-400.otf error";
        }
    }

    if (!fontDb.families().contains("Font Awesome 5 Free Regular"))
    {
        int fontId = QFontDatabase::addApplicationFont(":/image/Font Awesome 5 Free-Regular-400.otf");
        QStringList fontName = QFontDatabase::applicationFontFamilies(fontId);
        if (fontName.count() == 0)
        {
            qDebug() << "load Font Awesome 5 Free-Regular-400.otf error";
        }
    }

    if (!fontDb.families().contains("Font Awesome 5 Free Solid"))
    {
        int fontId = QFontDatabase::addApplicationFont(":/image/Font Awesome 5 Free-Solid-900.otf");
        QStringList fontName = QFontDatabase::applicationFontFamilies(fontId);
        if (fontName.count() == 0)
        {
            qDebug() << "load Font Awesome 5 Free-Solid-900.otf error";
        }
    }


    if (fontDb.families().contains("FontAwesome"))
    {
        iconFont = QFont("FontAwesome");
    }

    if (fontDb.families().contains("Font Awesome 5 Brands Regular"))
    {
        iconFontBrandsRegular = QFont("Font Awesome 5 Brands Regular");
    }

    if (fontDb.families().contains("Font Awesome 5 Free Regular"))
    {
        iconFontFreeRegular = QFont("Font Awesome 5 Free Regular");
    }

    if (fontDb.families().contains("Font Awesome 5 Free Solid"))
    {
        iconFontFreeSolid = QFont("Font Awesome 5 Free Solid");
    }
}

void IconHelper::setIcon(QLabel *lab, const QChar &str, FontType_S fontType, quint32 size)
{
    if(fontType == FontAwesome5BrandsRegular)
    {
        iconFontBrandsRegular.setPixelSize(size);
        lab->setFont(iconFontBrandsRegular);
    }
    else if(fontType == FontAwesome5FreeRegular)
    {
        iconFontFreeRegular.setPixelSize(size);
        lab->setFont(iconFontFreeRegular);
    }
    else if(fontType == FontAwesome5FreeSolid)
    {
        iconFontFreeSolid.setPixelSize(size);
        lab->setFont(iconFontFreeSolid);
    }
    else
    {
        iconFont.setPixelSize(size);
        lab->setFont(iconFont);
    }

    lab->setText(str);
}

void IconHelper::setIcon(QAbstractButton *btn, const QChar &str, FontType_S fontType,  quint32 size)
{
    if(fontType == FontAwesome5BrandsRegular)
    {
        iconFontBrandsRegular.setPixelSize(size);
        btn->setFont(iconFontBrandsRegular);
    }
    else if(fontType == FontAwesome5FreeRegular)
    {
        iconFontFreeRegular.setPixelSize(size);
        btn->setFont(iconFontFreeRegular);
    }
    else if(fontType == FontAwesome5FreeSolid)
    {
        iconFontFreeSolid.setPixelSize(size);
        btn->setFont(iconFontFreeSolid);
    }
    else
    {
        iconFont.setPixelSize(size);
        btn->setFont(iconFont);
    }

    btn->setText(str);
}

QPixmap IconHelper::getPixmap(const QColor &color, const QChar &str, FontType_S fontType,
                              quint32 size, quint32 pixWidth, quint32 pixHeight, int flags)
{
    QPixmap pix(pixWidth, pixHeight);
    pix.fill(Qt::transparent);

    QPainter painter;
    painter.begin(&pix);
    painter.setRenderHints(QPainter::Antialiasing | QPainter::TextAntialiasing);
    painter.setPen(color);

    if(fontType == FontAwesome5BrandsRegular)
    {
        iconFontBrandsRegular.setPixelSize(size);
        painter.setFont(iconFontBrandsRegular);
    }
    else if(fontType == FontAwesome5FreeRegular)
    {
        iconFontFreeRegular.setPixelSize(size);
        painter.setFont(iconFontFreeRegular);
    }
    else if(fontType == FontAwesome5FreeSolid)
    {
        iconFontFreeSolid.setPixelSize(size);
        painter.setFont(iconFontFreeSolid);
    }
    else
    {
        iconFont.setPixelSize(size);
        painter.setFont(iconFont);
    }

    painter.drawText(pix.rect(), flags, str);
    painter.end();

    return pix;
}

QPixmap IconHelper::getPixmap(QToolButton *btn, bool normal)
{
    QPixmap pix;
    int index = btns.indexOf(btn);

    if (index >= 0)
    {
        if (normal)
        {
            pix = pixNormal.at(index);
        }
        else
        {
            pix = pixDark.at(index);
        }
    }

    return pix;
}

void IconHelper::setStyle(QWidget *widget, const QString &type, int borderWidth, const QString &borderColor,
                          const QString &normalBgColor, const QString &darkBgColor,
                          const QString &normalTextColor, const QString &darkTextColor)
{
    QString strBorder;
    if (type == "top")
    {
        strBorder = QString("border-width:%1px 0px 0px 0px;padding:%1px %2px %2px %2px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }
    else if (type == "right")
    {
        strBorder = QString("border-width:0px %1px 0px 0px;padding:%2px %1px %2px %2px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }
    else if (type == "bottom")
    {
        strBorder = QString("border-width:0px 0px %1px 0px;padding:%2px %2px %1px %2px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }
    else if (type == "left")
    {
        strBorder = QString("border-width:0px 0px 0px %1px;padding:%2px %2px %2px %1px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }

    QStringList qss;
    qss.append(QString("QWidget[flag=\"%1\"] QAbstractButton{border-style:none;border-radius:0px;padding:5px;color:%2;background:%3;}")
               .arg(type).arg(normalTextColor).arg(normalBgColor));

    qss.append(QString("QWidget[flag=\"%1\"] QAbstractButton:hover,"
                       "QWidget[flag=\"%1\"] QAbstractButton:pressed,"
                       "QWidget[flag=\"%1\"] QAbstractButton:checked{"
                       "border-style:solid;%2border-color:%3;color:%4;background:%5;}")
               .arg(type).arg(strBorder).arg(borderColor).arg(darkTextColor).arg(darkBgColor));

    widget->setStyleSheet(qss.join(""));
}

void IconHelper::setStyle(QWidget *widget, QList<QToolButton *> btns, QList<int> pixChar, FontType_S fontType,
                          quint32 iconSize, quint32 iconWidth, quint32 iconHeight,
                          const QString &type, int borderWidth, const QString &borderColor,
                          const QString &normalBgColor, const QString &darkBgColor,
                          const QString &normalTextColor, const QString &darkTextColor)
{
    int btnCount = btns.count();
    int charCount = pixChar.count();
    if (btnCount <= 0 || charCount <= 0 || btnCount != charCount)
    {
        return;
    }

    QString strBorder;
    if (type == "top")
    {
        strBorder = QString("border-width:%1px 0px 0px 0px;padding:%1px %2px %2px %2px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }
    else if (type == "right")
    {
        strBorder = QString("border-width:0px %1px 0px 0px;padding:%2px %1px %2px %2px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }
    else if (type == "bottom")
    {
        strBorder = QString("border-width:0px 0px %1px 0px;padding:%2px %2px %1px %2px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }
    else if (type == "left")
    {
        strBorder = QString("border-width:0px 0px 0px %1px;padding:%2px %2px %2px %1px;")
                    .arg(borderWidth).arg(borderWidth * 2);
    }

    //如果圖標是左側顯示則需要讓沒有選中的按鈕左側也有加深的邊框,顏色爲背景顏色
    QStringList qss;
    if (btns.at(0)->toolButtonStyle() == Qt::ToolButtonTextBesideIcon)
    {
        qss.append(QString("QWidget[flag=\"%1\"] QAbstractButton{border-style:solid;border-radius:0px;%2border-color:%3;color:%4;background:%5;}")
                   .arg(type).arg(strBorder).arg(normalBgColor).arg(normalTextColor).arg(normalBgColor));
    }
    else
    {
        qss.append(QString("QWidget[flag=\"%1\"] QAbstractButton{border-style:none;border-radius:0px;padding:5px;color:%2;background:%3;}")
                   .arg(type).arg(normalTextColor).arg(normalBgColor));
    }

    qss.append(QString("QWidget[flag=\"%1\"] QAbstractButton:hover,"
                       "QWidget[flag=\"%1\"] QAbstractButton:pressed,"
                       "QWidget[flag=\"%1\"] QAbstractButton:checked{"
                       "border-style:solid;%2border-color:%3;color:%4;background:%5;}")
               .arg(type).arg(strBorder).arg(borderColor).arg(darkTextColor).arg(darkBgColor));

    qss.append(QString("QWidget#%1{background:%2;}").arg(widget->objectName()).arg(normalBgColor));

    qss.append(QString("QWidget>QToolButton{border-width:0px;}"));
    qss.append(QString("QWidget>QToolButton{background-color:%1;color:%2;}")
               .arg(normalBgColor).arg(normalTextColor));
    qss.append(QString("QWidget>QToolButton:hover,QWidget>QToolButton:pressed,QWidget>QToolButton:checked{background-color:%1;color:%2;}")
               .arg(darkBgColor).arg(darkTextColor));

    widget->setStyleSheet(qss.join(""));

    for (int i = 0; i < btnCount; i++)
    {
        //存儲對應按鈕對象,方便鼠標移上去的時候切換圖片
        QPixmap pixNormal = getPixmap(normalTextColor, QChar(pixChar.at(i)), fontType, iconSize, iconWidth, iconHeight);
        QPixmap pixDark = getPixmap(darkTextColor, QChar(pixChar.at(i)), fontType, iconSize, iconWidth, iconHeight);

        btns.at(i)->setIcon(QIcon(pixNormal));
        btns.at(i)->setIconSize(QSize(iconWidth, iconHeight));
        btns.at(i)->installEventFilter(this);

        this->btns.append(btns.at(i));
        this->pixNormal.append(pixNormal);
        this->pixDark.append(pixDark);
    }
}

void IconHelper::setStyle(QFrame *frame, QList<QToolButton *> btns, QList<int> pixChar, FontType_S fontType,
                          quint32 iconSize, quint32 iconWidth, quint32 iconHeight,
                          const QString &normalBgColor, const QString &darkBgColor,
                          const QString &normalTextColor, const QString &darkTextColor)
{
    int btnCount = btns.count();
    int charCount = pixChar.count();
    if (btnCount <= 0 || charCount <= 0 || btnCount != charCount)
    {
        return;
    }

    QStringList qss;
    qss.append(QString("QFrame>QToolButton{border-style:none;border-width:0px;}"));
    qss.append(QString("QFrame>QToolButton{background-color:%1;color:%2;}")
               .arg(normalBgColor).arg(normalTextColor));
    qss.append(QString("QFrame>QToolButton:hover,QFrame>QToolButton:pressed,QFrame>QToolButton:checked{background-color:%1;color:%2;}")
               .arg(darkBgColor).arg(darkTextColor));

    frame->setStyleSheet(qss.join(""));

    for (int i = 0; i < btnCount; i++)
    {
        //存儲對應按鈕對象,方便鼠標移上去的時候切換圖片
        QPixmap pixNormal = getPixmap(normalTextColor, QChar(pixChar.at(i)), fontType,  iconSize, iconWidth, iconHeight);
        QPixmap pixDark = getPixmap(darkTextColor, QChar(pixChar.at(i)), fontType,  iconSize, iconWidth, iconHeight);

        btns.at(i)->setIcon(QIcon(pixNormal));
        btns.at(i)->setIconSize(QSize(iconWidth, iconHeight));
        btns.at(i)->installEventFilter(this);

        this->btns.append(btns.at(i));
        this->pixNormal.append(pixNormal);
        this->pixDark.append(pixDark);
    }
}

bool IconHelper::eventFilter(QObject *watched, QEvent *event)
{
    if (watched->inherits("QToolButton"))
    {
        QToolButton *btn = (QToolButton *)watched;
        int index = btns.indexOf(btn);
        if (index >= 0)
        {
            if (event->type() == QEvent::Enter)
            {
                btn->setIcon(QIcon(pixDark.at(index)));
            }
            else if (event->type() == QEvent::Leave)
            {
                if (btn->isChecked())
                {
                    btn->setIcon(QIcon(pixDark.at(index)));
                }
                else
                {
                    btn->setIcon(QIcon(pixNormal.at(index)));
                }
            }
        }
    }

    return QObject::eventFilter(watched, event);
}

使用方法見下,對應的字符編碼去官網找
FontAwesome4:https://fontawesome.com/v4.7.0/icons/
FontAwesome5:https://fontawesome.com/icons:

    IconHelper::Instance()->setIcon(ui->labIco, QChar(0xf21a), FontAwesome5FreeSolid, 30);      //如需指定大小則需填寫字體類型
    IconHelper::Instance()->setIcon(ui->btnMenu_Min, QChar(0xf553), FontAwesome5FreeSolid, 12);
    IconHelper::Instance()->setIcon(ui->btnMenu_Max, QChar(0xf2d0));                            //默認使用FontAwesome5 Solid 大小12
    IconHelper::Instance()->setIcon(ui->btnMenu_Close, QChar(0xf00d));

效果如下
在這裏插入圖片描述

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章