syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-circular-progressbar
syncfusion-wpf-circular-progressbar
VerifiedImplement Syncfusion WPF SfCircularProgressBar for circular and radial progress indicators. Use this when building circular progress displays, determinate or indeterminate progress animations, buffer/secondary progress, segmented progress rings, or arc-shaped progress with custom center content. Covers RangeColors, StartAngle, EndAngle, SegmentCount, and ProgressContent using Syncfusion.SfProgressBar.WPF.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.6 KB |
| references/appearance.md | markdown | 8.9 KB |
| references/getting-started.md | markdown | 3.5 KB |
| references/segments-and-custom-content.md | markdown | 7.2 KB |
| references/states.md | markdown | 4.1 KB |
references/states.md
View on GitHub# States
## Overview
`SfCircularProgressBar` supports three states that control how progress is visualized. Choose the state based on whether the progress amount is known, unknown, or has a secondary (buffer) component.
---
## Decision Guide
| Scenario | State to Use |
|---|---|
| Progress percentage is known | **Determinate** (default) |
| Progress duration is unknown | **Indeterminate** |
| Download with buffering (primary + buffer) | **Buffer** |
---
## Determinate
**Default state.** Displays a fixed arc that fills proportionally to the `Progress` value (0–100).
Enable the numeric percentage display with `ShowProgressValue`:
```xaml
<Syncfusion:SfCircularProgressBar
Progress="70"
ShowProgressValue="True"
Width="150" Height="150" />
```
```csharp
SfCircularProgressBar circular = new SfCircularProgressBar();
circular.Progress = 70;
circular.ShowProgressValue = true;
grid.Children.Add(circular);
```
**Use when:** File upload, installation steps, form completion, or any task where progress percentage can be calculated.
**Note:** `ShowProgressValue="True"` renders the percentage text in the center. If you want custom center content instead, use `ProgressContent` (see `segments-and-custom-content.md`) and set `ShowProgressValue="False"`.
---
## Indeterminate
When the progress duration cannot be estimated, enable `IsIndeterminate` to show a continuous spinning animation:
```xaml
<Syncfusion:SfCircularProgressBar
Progress="70"
IsIndeterminate="True"
ShowProgressValue="False"
Width="150" Height="150" />
```
```csharp
SfCircularProgressBar circular = new SfCircularProgressBar();
circular.Progress = 70;
circular.IsIndeterminate = true;
grid.Children.Add(circular);
```
**Use when:** API calls, database queries, background operations where total duration is unknown.
**Animation control:**
- `AnimationDuration` — sets one full cycle time (default: `3000ms`)
- `AnimationEasing` — applies easing function to the animation
```xaml
<Syncfusion:SfCircularProgressBar IsIndeterminate="True" AnimationDuration="00:00:01" />
```
See `appearance.md` for full `AnimationDuration` and `AnimationEasing` examples.
---
## Buffer
Displays two concentric progress arcs simultaneously — a primary progress and a secondary (buffer) progress. Useful for media streaming, downloads, or any task with pre-loading ahead.
```xaml
<Syncfusion:SfCircularProgressBar
Progress="65"
SecondaryProgress="75"
Width="150" Height="150" />
```
```csharp
SfCircularProgressBar circular = new SfCircularProgressBar();
circular.Progress = 65;
circular.SecondaryProgress = 75;
grid.Children.Add(circular);
```
**Customize buffer color:**
```xaml
<Syncfusion:SfCircularProgressBar
Progress="65"
SecondaryProgress="75"
SecondaryProgressColor="LightBlue" />
```
| Property | Purpose |
|---|---|
| `Progress` | Primary progress arc (0–100) |
| `SecondaryProgress` | Buffer arc (0–100, typically ≥ `Progress`) |
| `SecondaryProgressColor` | Color of the buffer arc |
**Use when:** Video buffering, file download pre-caching, or any scenario where a "ready ahead" indicator is needed alongside current progress.
---
## Switching States Dynamically
Toggle states at runtime by binding `IsIndeterminate`:
```xaml
<Syncfusion:SfCircularProgressBar
Progress="{Binding UploadProgress}"
IsIndeterminate="{Binding IsLoading}"
ShowProgressValue="{Binding IsNotLoading}" />
```
```csharp
// Start indeterminate while connecting
IsLoading = true;
await ConnectAsync();
// Switch to determinate once progress is trackable
IsLoading = false;
for (int i = 0; i <= 100; i++)
{
UploadProgress = i;
await Task.Delay(50);
}
```
---
## Gotchas
- **`IsIndeterminate` ignores `Progress`** — the arc animates continuously regardless of the `Progress` value when indeterminate.
- **`ShowProgressValue` and `ProgressContent` conflict** — if both are set, `ProgressContent` takes visual precedence; set `ShowProgressValue="False"` when using custom content.
- **`SecondaryProgress` should be ≥ `Progress`** — setting it lower than `Progress` results in overlapping arcs that look incorrect.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |