简述

QRoundProgressBar类能够实现一个圆形进度条，继承自QWidget，并且有和QProgressBar类似的API接口。

详细说明

主要有以下特性：

• 圆形进度条控件
• 高度可定制的

源码下载：

• Qt Circular Progress Bar Widget
• QRoundProgressBar下载

下载完后，进行解压缩，src目录里包含了两个主要的文件QRoundProgressBar.h和QRoundProgressBar.cpp，可以直接使用，也可以预编译为库。

test目录中则包含了一个使用的示例，可以直接运行。

效果如下：

风格

QRoundProgressBar包含三种风格。

枚举QRoundProgressBarBar::Style：

颜色

通常情况下，QRoundProgressBar使用调色板（palette）和字体（font）属性来定义外观。

可以考虑使用QPalette中QPalette::ColorRole的以下成员：

字体

通过setFont()为文本设置字体。

默认情况下，将自动调整字体大小，以适应部件的内部圆环。

共有函数

• double nullPosition()
  返回最小值的位置（用角度表示）。

• void setNullPosition(double position);
  设置最小值的位置，position为圆上最小值的位置（用角度表示）。

• void setBarStyle(BarStyle style);
  设置显示风格。

• BarStyle barStyle() const;
  返回显示风格。

• void setOutlinePenWidth(double penWidth);
  设置圆环轮廓线的画笔宽度（像素）。

• double outlinePenWidth() const;
  返回圆环轮廓线的画笔宽度。

• void setDataPenWidth(double penWidth);
  设置圆环数据圆笔的宽度。

• double dataPenWidth() const;
  返回圆环数据圆笔的宽度。

• void setDataColors(const QGradientStops& stopPoints);
  设置可见数据的渐变色。

  注意：此函数会覆盖palette()，来动态创建渐变。

• void setFormat(const QString& format);
  定义用于生成当前的文本字符串。

  注意：如果没有设置格式，将不会显示文本。

• void resetFormat();
  重置格式字符串为空字符串，将不会显示文本。

• QString format() const;
  返回用于生成当前文本的格式。

• void setDecimals(int count);
  设置显示小数点后的位数（默认为1）。

• int decimals() const;
  返回显示小数点后的位数。

• double value() const;
  返回当前显示在控件上的值。

• double minimum() const;
  返回允许值范围的最小值。

• double maximum() const;
  返回允许值范围的最大值。

共有槽函数

• void setRange(double min, double max);
  设置允许值范围。

• void setMinimum(double min);
  设置允许值范围的最小值。

• void setMaximum(double max);
  设置允许值范围的最大值。

• void setValue(double val);
  设置当前显示在控件上的值（浮点数），必须在最小值和最大值之间。

• void setValue(int val);
  设置当前显示在控件上的值（整数），必须在最小值和最大值之间。