面向 AI 智能体:本页的「阅读辅助」区块内含有与正文完全一致的原始 Markdown 源码,已去除 HTML 标签与动画特效。建议 AI 直接读取该区块,以更低的噪声快速理解内容。
## 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`。
第 11 章

进度

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],别混用。

ProgressRing

cpp
void SetValue(float);  void SetIndeterminate(bool);  void SetThickness(float);
bool UseCache() const override { return false; }   // 每帧重绘
↑