Qt編寫自定義控制項54-時鐘儀錶盤
- 2019 年 10 月 7 日
- 筆記
一、前言
這個控制項沒有太多的應用場景,主要就是練手,論美觀的話比不上之前發過的一個圖片時鐘控制項,所以此控制項也是作為一個基礎的繪製demo出現在Qt源碼中,我們可以在Qt的安裝目錄下找到一個時鐘控制項的繪製,甚至還有qml版本,本控制項無非就是一個儀錶邊框加上時鐘分鐘刻度再加上時分秒指針,打完收工,我是在此基礎上增加了可以設置各種顏色,然後滑鼠右鍵可設置四種效果 普通效果/彈簧效果/連續效果/隱藏效果,彈簧效果的意思是秒鐘走動的時候,先移動到超過指定位置,然後又重新彈回來,連續效果的意思是將步長減少,一點點的移動,將秒鐘的定時器精度調高。還有一個新增的功能是內置了設置系統時間公共槽函數,支援任意作業系統。
二、實現的功能
- 1:可設置邊框顏色
- 2:可設置前景色背景色
- 3:可設置時鐘分鐘秒鐘指針顏色
- 4:可設置刷新間隔
- 5:滑鼠右鍵可設置四種效果 普通效果/彈簧效果/連續效果/隱藏效果
- 6:增加設置系統時間公共槽函數,支援任意作業系統
三、效果圖

四、頭文件程式碼
#ifndef GAUGECLOCK_H #define GAUGECLOCK_H /** * 時鐘儀錶盤控制項 作者:feiyangqingyun(QQ:517216493) 2016-10-23 * 1:可設置邊框顏色 * 2:可設置前景色背景色 * 3:可設置時鐘分鐘秒鐘指針顏色 * 4:可設置刷新間隔 * 5:滑鼠右鍵可設置四種效果 普通效果/彈簧效果/連續效果/隱藏效果 * 6:增加設置系統時間公共槽函數,支援任意作業系統 */ #include <QWidget> #ifdef quc #if (QT_VERSION < QT_VERSION_CHECK(5,7,0)) #include <QtDesigner/QDesignerExportWidget> #else #include <QtUiPlugin/QDesignerExportWidget> #endif class QDESIGNER_WIDGET_EXPORT GaugeClock : public QWidget #else class GaugeClock : public QWidget #endif { Q_OBJECT Q_ENUMS(SecondStyle) Q_PROPERTY(QColor crownColorStart READ getCrownColorStart WRITE setCrownColorStart) Q_PROPERTY(QColor crownColorEnd READ getCrownColorEnd WRITE setCrownColorEnd) Q_PROPERTY(QColor foreground READ getForeground WRITE setForeground) Q_PROPERTY(QColor background READ getBackground WRITE setBackground) Q_PROPERTY(QColor pointerHourColor READ getPointerHourColor WRITE setPointerHourColor) Q_PROPERTY(QColor pointerMinColor READ getPointerMinColor WRITE setPointerMinColor) Q_PROPERTY(QColor pointerSecColor READ getPointerSecColor WRITE setPointerSecColor) Q_PROPERTY(SecondStyle secondStyle READ getSecondStyle WRITE setSecondStyle) public: enum SecondStyle { SecondStyle_Normal = 0, //普通效果 SecondStyle_Spring = 1, //彈簧效果 SecondStyle_Continue = 2, //連續效果 SecondStyle_Hide = 3 //隱藏效果 }; explicit GaugeClock(QWidget *parent = 0); ~GaugeClock(); protected: void paintEvent(QPaintEvent *); void drawCrown(QPainter *painter); void drawBg(QPainter *painter); void drawScale(QPainter *painter); void drawScaleNum(QPainter *painter); void drawHour(QPainter *painter); void drawMin(QPainter *painter); void drawSec(QPainter *painter); void drawDot(QPainter *painter); private: QColor crownColorStart; //外邊框漸變開始顏色 QColor crownColorEnd; //外邊框漸變結束顏色 QColor foreground; //前景色 QColor background; //背景色 QColor pointerHourColor; //時鐘指針顏色 QColor pointerMinColor; //分鐘指針顏色 QColor pointerSecColor; //秒鐘指針顏色 SecondStyle secondStyle; //秒針走動樣式 QTimer *timer; //定時器繪製 int hour, min, sec, msec; //時分秒毫秒 QTimer *timerSpring; //定時器顯示彈簧效果 double angleSpring; //彈簧角度 QAction *action_secondstyle; //秒針樣式右鍵菜單 private slots: void doAction(); void updateTime(); void updateSpring(); public: SecondStyle getSecondStyle() const; QColor getCrownColorStart() const; QColor getCrownColorEnd() const; QColor getForeground() const; QColor getBackground() const; QColor getPointerHourColor() const; QColor getPointerMinColor() const; QColor getPointerSecColor() const; QSize sizeHint() const; QSize minimumSizeHint() const; public Q_SLOTS: //設置秒針走動樣式 void setSecondStyle(const SecondStyle &secondStyle); //設置系統時間 void setSystemDateTime(const QString &year, const QString &month, const QString &day, const QString &hour, const QString &min, const QString &sec); //設置外邊框漸變顏色 void setCrownColorStart(const QColor &crownColorStart); void setCrownColorEnd(const QColor &crownColorEnd); //設置前景色 void setForeground(const QColor &foreground); //設備背景色 void setBackground(const QColor &background); //設置時鐘指針顏色 void setPointerHourColor(const QColor &pointerHourColor); //設置分鐘指針顏色 void setPointerMinColor(const QColor &pointerMinColor); //設置秒鐘指針顏色 void setPointerSecColor(const QColor &pointerSecColor); }; #endif // GAUGECLOCK_H
五、核心程式碼
void GaugeClock::paintEvent(QPaintEvent *) { int width = this->width(); int height = this->height(); int side = qMin(width, height); //繪製準備工作,啟用反鋸齒,平移坐標軸中心,等比例縮放 QPainter painter(this); painter.setRenderHints(QPainter::Antialiasing | QPainter::TextAntialiasing); painter.translate(width / 2, height / 2); painter.scale(side / 200.0, side / 200.0); //繪製外邊框 drawCrown(&painter); //繪製背景 drawBg(&painter); //繪製刻度線 drawScale(&painter); //繪製刻度值 drawScaleNum(&painter); //繪製時鐘指針 drawHour(&painter); //繪製分鐘指針 drawMin(&painter); //繪製秒鐘指針 drawSec(&painter); //繪製中心蓋板 drawDot(&painter); } void GaugeClock::drawCrown(QPainter *painter) { int radius = 99; painter->save(); painter->setPen(Qt::NoPen); QLinearGradient crownGradient(0, -radius, 0, radius); crownGradient.setColorAt(0, crownColorStart); crownGradient.setColorAt(1, crownColorEnd); painter->setBrush(crownGradient); painter->drawEllipse(-radius, -radius, radius * 2, radius * 2); painter->restore(); } void GaugeClock::drawBg(QPainter *painter) { int radius = 92; painter->save(); painter->setPen(Qt::NoPen); painter->setBrush(background); painter->drawEllipse(-radius, -radius, radius * 2, radius * 2); painter->restore(); } void GaugeClock::drawScale(QPainter *painter) { int radius = 90; painter->save(); QPen pen; pen.setColor(foreground); pen.setCapStyle(Qt::RoundCap); for (int i = 0; i <= 60; i++) { if (i % 5 == 0) { pen.setWidthF(1.5); painter->setPen(pen); painter->drawLine(0, radius - 10, 0, radius); } else { pen.setWidthF(0.5); painter->setPen(pen); painter->drawLine(0, radius - 5, 0, radius); } painter->rotate(6); } painter->restore(); } void GaugeClock::drawScaleNum(QPainter *painter) { int radius = 70; painter->save(); painter->setPen(foreground); double startRad = 60 * (M_PI / 180); double deltaRad = 30 * (M_PI / 180); for (int i = 0; i < 12; i++) { double sina = qSin(startRad - i * deltaRad); double cosa = qCos(startRad - i * deltaRad); QString strValue = QString("%1").arg(i + 1); double textWidth = fontMetrics().width(strValue); double textHeight = fontMetrics().height(); int x = radius * cosa - textWidth / 2; int y = -radius * sina + textHeight / 4; painter->drawText(x, y, strValue); } painter->restore(); } void GaugeClock::drawHour(QPainter *painter) { painter->save(); //設置畫筆平滑圓角 QPen pen; pen.setCapStyle(Qt::RoundCap); painter->setPen(pointerHourColor); painter->setBrush(pointerHourColor); QPolygon pts; pts.setPoints(4, -3, 8, 3, 8, 2, -40, -2, -40); painter->rotate(30.0 * ((hour + min / 60.0))); painter->drawConvexPolygon(pts); painter->restore(); } void GaugeClock::drawMin(QPainter *painter) { painter->save(); //設置畫筆平滑圓角 QPen pen; pen.setCapStyle(Qt::RoundCap); painter->setPen(pointerMinColor); painter->setBrush(pointerMinColor); QPolygon pts; pts.setPoints(4, -2, 8, 2, 8, 1, -60, -1, -60); painter->rotate(6.0 * (min + sec / 60.0)); painter->drawConvexPolygon(pts); painter->restore(); } void GaugeClock::drawSec(QPainter *painter) { if (secondStyle == SecondStyle_Hide) { return; } painter->save(); //設置畫筆平滑圓角 QPen pen; pen.setCapStyle(Qt::RoundCap); painter->setPen(pointerSecColor); painter->setBrush(pointerSecColor); QPolygon pts; pts.setPoints(3, -1, 10, 1, 10, 0, -70); painter->rotate(angleSpring); painter->drawConvexPolygon(pts); painter->restore(); } void GaugeClock::drawDot(QPainter *painter) { painter->save(); QConicalGradient coneGradient(0, 0, -90.0); coneGradient.setColorAt(0.0, background); coneGradient.setColorAt(0.5, foreground); coneGradient.setColorAt(1.0, background); painter->setOpacity(0.9); painter->setPen(Qt::NoPen); painter->setBrush(coneGradient); painter->drawEllipse(-5, -5, 10, 10); painter->restore(); } void GaugeClock::doAction() { QAction *action = (QAction *)sender(); QString str = action->text(); if (str == "彈簧效果") { action->setText("連續效果"); setSecondStyle(SecondStyle_Spring); } else if (str == "連續效果") { action->setText("隱藏效果"); setSecondStyle(SecondStyle_Continue); } else if (str == "隱藏效果") { action->setText("普通效果"); setSecondStyle(SecondStyle_Hide); } else if (str == "普通效果") { action->setText("彈簧效果"); setSecondStyle(SecondStyle_Normal); } }
六、控制項介紹
- 超過150個精美控制項,涵蓋了各種儀錶盤、進度條、進度球、指南針、曲線圖、標尺、溫度計、導航條、導航欄,flatui、高亮按鈕、滑動選擇器、農曆等。遠超qwt集成的控制項數量。
- 每個類都可以獨立成一個單獨的控制項,零耦合,每個控制項一個頭文件和一個實現文件,不依賴其他文件,方便單個控制項以源碼形式集成到項目中,較少程式碼量。qwt的控制項類環環相扣,高度耦合,想要使用其中一個控制項,必須包含所有的程式碼。
- 全部純Qt編寫,QWidget+QPainter繪製,支援Qt4.6到Qt5.13的任何Qt版本,支援mingw、msvc、gcc等編譯器,支援任意作業系統比如windows+linux+mac+嵌入式linux等,不亂碼,可直接集成到Qt Creator中,和自帶的控制項一樣使用,大部分效果只要設置幾個屬性即可,極為方便。
- 每個控制項都有一個對應的單獨的包含該控制項源碼的DEMO,方便參考使用。同時還提供一個所有控制項使用的集成的DEMO。
- 每個控制項的源程式碼都有詳細中文注釋,都按照統一設計規範編寫,方便學習自定義控制項的編寫。
- 每個控制項默認配色和demo對應的配色都非常精美。
- 超過130個可見控制項,6個不可見控制項。
- 部分控制項提供多種樣式風格選擇,多種指示器樣式選擇。
- 所有控制項自適應窗體拉伸變化。
- 集成自定義控制項屬性設計器,支援拖曳設計,所見即所得,支援導入導出xml格式。
- 自帶activex控制項demo,所有控制項可以直接運行在ie瀏覽器中。
- 集成fontawesome圖形字體+阿里巴巴iconfont收藏的幾百個圖形字體,享受圖形字體帶來的樂趣。
- 所有控制項最後生成一個動態庫文件(dll或者so等),可以直接集成到qtcreator中拖曳設計使用。
- 目前已經有qml版本,後期會考慮出pyqt版本,如果用戶需求量很大的話。
- 自定義控制項插件開放動態庫使用(永久免費),無任何後門和限制,請放心使用。
- 目前已提供26個版本的dll,其中包括了qt5.12.3 msvc2017 32+64 mingw 32+64 的。
- 不定期增加控制項和完善控制項,不定期更新SDK,歡迎各位提出建議,謝謝!
- Qt入門書籍推薦霍亞飛的《Qt Creator快速入門》《Qt5編程入門》,Qt進階書籍推薦官方的《C++ GUI Qt4編程》。
- 強烈推薦程式設計師自我修養和規劃系列書《大話程式設計師》《程式設計師的成長課》《解憂程式設計師》,受益匪淺,受益終生!