## ProgressBar
```cpp
ZSignal<float> ValueChanged;
void SetValue(float); // 归一化到 [0,1]
void SetRange(float min,float max); void SetRangeValue(float); // [min,max]
void SetIndeterminate(bool); void SetIndeterminateBlockWidth(float); void SetIndeterminateSpeed(float);
inline static float DefaultValueAnimDuration; // 数值缓动时长(秒),默认 0.22
```
###block_red_start
**易错**
- `SetValue` 是 `[0,1]`,`SetRangeValue` 是 `[min,max]`,**别混用**。
###block_red_end
- **`版本`**:`v1.21.0` 起数值变化有**缓动**(内部 `displayValue_` 时长驱动,填充条与 `%` 文字同步,到点即停);同版本修**拉伸后内填充圆角与外框对不上**(轨道/裁剪/边框原用成员 `height_`,改用 `arrangedRect_.height/2`)。
## ProgressRing
```cpp
void SetValue(float); void SetIndeterminate(bool); void SetThickness(float);
bool UseCache() const override { return false; } // 每帧重绘
```
- **`版本`**:`v1.12.0`;`UseCache=false` `v1.12.2`;NaN/Inf 守卫 `v1.14.0`。进度
ProgressBar、ProgressRing
ProgressBar
cpp
ZSignal<float> ValueChanged;
void SetValue(float); // 归一化到 [0,1]
void SetRange(float min,float max); void SetRangeValue(float); // [min,max]
void SetIndeterminate(bool); void SetIndeterminateBlockWidth(float); void SetIndeterminateSpeed(float);
inline static float DefaultValueAnimDuration; // 数值缓动时长(秒),默认 0.22
易错
SetValue是[0,1],SetRangeValue是[min,max],别混用。
版本:v1.21.0起数值变化有缓动(内部displayValue_时长驱动,填充条与%文字同步,到点即停);同版本修拉伸后内填充圆角与外框对不上(轨道/裁剪/边框原用成员height_,改用arrangedRect_.height/2)。
ProgressRing
cpp
void SetValue(float); void SetIndeterminate(bool); void SetThickness(float);
bool UseCache() const override { return false; } // 每帧重绘
版本:v1.12.0;UseCache=falsev1.12.2;NaN/Inf 守卫v1.14.0。