For AI agents: the "Reading aid" section on this page contains the raw Markdown source identical to the rendered content, with HTML markup and animations removed. AI is advised to read that section directly to understand the content quickly and with less noise.
## ProgressBar

```cpp
ZSignal<float> ValueChanged;
void SetValue(float);          // normalized to [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;   // value animation duration (s), default 0.22
```

###block_red_start
**Pitfall**

- `SetValue` is `[0,1]`, `SetRangeValue` is `[min,max]` — do not mix.
###block_red_end

- **`Version`**: since `v1.21.0` value changes are **eased** (internal `displayValue_`, duration-driven; the fill and the `%` text move together and stop on time). The same version fixes the **inner fill radius not matching the outer frame after stretching** (track/clip/border used the member `height_`; now all use `arrangedRect_.height / 2`).

## ProgressRing

```cpp
void SetValue(float);  void SetIndeterminate(bool);  void SetThickness(float);
bool UseCache() const override { return false; }
```
- **`Version`**: `v1.12.0`; `UseCache=false` `v1.12.2`; NaN/Inf guard `v1.14.0`.
Chapter 11

Progress

ProgressBar, ProgressRing

ProgressBar

cpp
ZSignal<float> ValueChanged;
void SetValue(float);          // normalized to [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;   // value animation duration (s), default 0.22

Pitfall

  • SetValue is [0,1], SetRangeValue is [min,max] — do not mix.

ProgressRing

cpp
void SetValue(float);  void SetIndeterminate(bool);  void SetThickness(float);
bool UseCache() const override { return false; }
↑