一、前言
有时我们需要在表格（qtablewidget）、树状栏（qtreewidget）中直观显示任务进度或消耗百分比，达到报表显示的形式，可通过重写qlabel的方式实现。
1、进度条控件功能
1）可设置值动态变化
2）可设置警戒值
3）可设置正常颜色和报警颜色
4）可设置边框渐变颜色
5）可设置变化时每次移动的步长
6）可设置错误时显示错误描述
7）可设置显示值保留小数的位数
8）可设置边框圆角角度/背景进度圆角角度/头部圆角角度
2、实现效果
二、实现过程
1、运行环境qt5.5 vs2013
2、继承qlabel重写progresslabel控件
1 /***********************************************************************
2 作者：liangtianmanyue(qq:1660941209) 2021-05-30
3 功能：进度控件
4 1、可设置值动态变化
5 2、可设置警戒值
6 3、可设置正常颜色和报警颜色
7 4、可设置边框渐变颜色
8 5、可设置变化时每次移动的步长
9 6、可设置错误时显示错误描述
10 6、可设置显示值保留小数的位数
11 8、可设置边框圆角角度/背景进度圆角角度/头部圆角角度
12 ************************************************************************/
13
14 #ifndef progress_label_h
15 #define progress_label_h
16
17 #include <qlabel>
18 #include <qwidget>
19
20 #ifdef plugin
21 #if (qt_version < qt_version_check(5,7,0))
22 #include <qtdesigner/qdesignerexportwidget>
23 #else
24 #include <qtuiplugin/qdesignerexportwidget>
25 #endif
26
27 class qdesigner_widget_export progresslabel : public qlabel
28 #else
29 class progresslabel : public qlabel
30 #endif
31 {
32 q_object
33 q_property(double minvalue read getminvalue write setminvalue)
34 q_property(double maxvalue read getmaxvalue write setmaxvalue)
35 q_property(double value read getvalue write setvalue)
36 q_property(double alarmvalue read getalarmvalue write setalarmvalue)
37
38 q_property(double step read getstep write setstep)
39 q_property(int decimals read getdecimals write setdecimals)
40 q_property(int borderradius read getborderradius write setborderradius)
41 q_property(int bgradius read getbgradius write setbgradius)
42 q_property(int headradius read getheadradius write setheadradius)
43
44 q_property(qcolor bordercolorstart read getbordercolorstart write setbordercolorstart)
45 q_property(qcolor bordercolorend read getbordercolorend write setbordercolorend)
46
47 q_property(qcolor alarmcolorstart read getalarmcolorstart write setalarmcolorstart)
48 q_property(qcolor alarmcolorend read getalarmcolorend write setalarmcolorend)
49
50 q_property(qcolor normalcolorstart read getnormalcolorstart write setnormalcolorstart)
51 q_property(qcolor normalcolorend read getnormalcolorend write setnormalcolorend)
52
53 public:
54 explicit progresslabel(qwidget *parent = 0);
55 ~progresslabel();
56
57 protected:
58 void paintevent(qpaintevent *);
59 void drawbg(qpainter *painter);
60
61 private slots:
62 void updatevalue();
63
64 public:
65 double getminvalue() const;
66 double getmaxvalue() const;
67 double getvalue() const;
68 double getalarmvalue() const;
69
70 double getstep() const;
71 int getborderradius() const;
72 int getbgradius() const;
73 int getheadradius() const;
74
75 qcolor getbordercolorstart() const;
76 qcolor getbordercolorend() const;
77
78 qcolor getalarmcolorstart() const;
79 qcolor getalarmcolorend() const;
80
81 qcolor getnormalcolorstart() const;
82 qcolor getnormalcolorend() const;
83
84 qsize sizehint() const;
85 qsize minimumsizehint() const;
86
87 public q_slots:
88 //设置范围值
89 void setrange(double minvalue, double maxvalue);
90 void setrange(int minvalue, int maxvalue);
91
92 //设置最大最小值
93 void setminvalue(double minvalue);
94 void setmaxvalue(double maxvalue);
95
96 //设置显示值
97 void setvalue(double value);
98 void setvalue(int value);
99
100 //设置警戒值
101 void setalarmvalue(double alarmvalue);
102 void setalarmvalue(int alarmvalue);
103
104 //设置步长
105 void setstep(double step);
106 void setstep(int step);
107
108 //小数点位数
109 int getdecimals();
110 void setdecimals(int decimals);
111
112 //设置边框圆角角度
113 void setborderradius(int borderradius);
114 //设置背景圆角角度
115 void setbgradius(int bgradius);
116 //设置头部圆角角度
117 void setheadradius(int headradius);
118
119 //设置边框渐变颜色
120 void setbordercolorstart(const qcolor &bordercolorstart);
121 void setbordercolorend(const qcolor &bordercolorend);
122
123 //设置报警时的渐变颜色
124 void setalarmcolorstart(const qcolor &alarmcolorstart);
125 void setalarmcolorend(const qcolor &alarmcolorend);
126
127 //设置正常时的渐变颜色
128 void setnormalcolorstart(const qcolor &normalcolorstart);
129 void setnormalcolorend(const qcolor &normalcolorend);
130
131 //正常、异常显示
132 void setnormalstate();
133 void seterrortext(const qstring &text);
134
135 q_signals:
136 void valuechanged(double value);
137
138 private:
139 bool m_iserror; //是否出错
140 qstring m_errortext; //错误描述
141
142 double minvalue; //最小值
143 double maxvalue; //最大值
144 double value; //目标电量
145 double alarmvalue; //警戒值
146 int decimals; //显示小数点后位数
147 double step; //每次移动的步长
148 int borderradius; //边框圆角角度
149 int bgradius; //背景进度圆角角度
150 int headradius; //头部圆角角度
151
152 qcolor bordercolorstart; //边框渐变开始颜色
153 qcolor bordercolorend; //边框渐变结束颜色
154
155 qcolor alarmcolorstart; //超警戒值时的渐变开始颜色
156 qcolor alarmcolorend; //超警戒值时的渐变结束颜色
157
158 qcolor normalcolorstart; //正常时的渐变开始颜色
159 qcolor normalcolorend; //正常时的渐变结束颜色
160
161 bool isforward; //是否往前移
162 double currentvalue; //当前值
163 qrectf mainrect; //主体区域
164 qtimer *timer; //绘制定时器
165 };
166
167 #endif // progress_label_h
3、重写paintevent事件，根据是否有出错，绘制出错信息或值
1 void progresslabel::paintevent(qpaintevent *)
2 {
3 //绘制准备工作,启用反锯齿
4 qpainter painter(this);
5 painter.setrenderhints(qpainter::antialiasing | qpainter::textantialiasing);
6
7 //获取边框区域
8 qpointf topleft(2, 2);
9 qpointf bottomright(width() - 4, height() - 2);
10 mainrect = qrectf(topleft, bottomright);
11 //绘制背景
12 drawbg(&painter);
13 }
14
15 void progresslabel::drawbg(qpainter *painter)
16 {
17 if(!m_iserror)
18 {
19 painter->save();
20 qlineargradient gradient(qpointf(0, 0), qpointf(0, height()));
21 if (currentvalue >= alarmvalue)
22 {
23 gradient.setcolorat(0.0, alarmcolorstart);
24 gradient.setcolorat(1.0, alarmcolorend);
25 }
26 else
27 {
28 gradient.setcolorat(0.0, normalcolorstart);
29 gradient.setcolorat(1.0, normalcolorend);
30 }
31
32 double min = qmin(width(), height());
33 int margin = min / 20;
34 double unit = (mainrect.width() - (margin * 2)) / 100;
35 double width = currentvalue * unit;
36 qpointf topleft(mainrect.topleft().x() + margin, mainrect.topleft().y() + margin);
37 qpointf bottomright(width + margin + 5, mainrect.bottomright().y() - margin);
38 qrectf rect(topleft, bottomright);
39
40 painter->setpen(qt::nopen);
41 painter->setbrush(gradient);
42 painter->drawroundedrect(rect, bgradius, bgradius);
43 painter->restore();
44 }
45
46 //写进度
47 painter->save();
48 qpen pen(qt::solidline);
49 pen.setwidth(1);
50 if(m_iserror)
51 pen.setcolor(qt::red);
52 else
53 pen.setcolor(qt::black);
54 painter->setpen(pen);
55 painter->setbrush(qt::nobrush);
56 if(m_iserror)
57 painter->drawtext(mainrect, qt::aligncenter, m_errortext);
58 else
59 painter->drawtext(mainrect, qt::aligncenter, qstring("%1%").arg(currentvalue, 0, 'f', decimals));
60 painter->restore();
61 }
4、刷新值时采用定时器定时刷新方式，达到动态效果
1 timer = new qtimer(this); 2 timer->setinterval(10); 3 connect(timer, signal(timeout()), this, slot(updatevalue()));
1 void progresslabel::updatevalue()
2 {
3 if (isforward)
4 {
5 currentvalue -= step;
6
7 if (currentvalue <= value)
8 {
9 timer->stop();
10 currentvalue = value;//保持真实性
11 }
12 }
13 else
14 {
15 currentvalue += step;
16
17 if (currentvalue >= value)
18 {
19 timer->stop();
20 currentvalue = value;//保持真实性
21 }
22 }
23
24 this->update();
25 }
5、外部设置值的时候，清除错误标志，并启动定时器
1 void progresslabel::setvalue(double value)
2 {
3 m_iserror = false;
4 //值和当前值一致则无需处理
5 if (value == this->value)
6 return;
7
8 //值小于最小值则取最小值,大于最大值则取最大值
9 if (value < minvalue)
10 value = minvalue;
11 else if (value > maxvalue)
12 value = maxvalue;
13
14 if (value > currentvalue)
15 isforward = false;
16 else if (value < currentvalue)
17 isforward = true;
18 else
19 return;
20
21 this->value = value;
22 this->update();
23 emit valuechanged(value);
24 timer->start();
25 }
