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 |
SKILL.md
View on GitHub---
name: syncfusion-wpf-circular-progressbar
description: Implement 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.
metadata:
author: "Syncfusion Inc"
version: "34.1.29"
---
# Implementing SfCircularProgressBar (WPF)
## When to Use This Skill
Use this skill when:
- Displaying circular/radial progress for a known task (determinate)
- Showing an indeterminate spinner while progress is unknown
- Visualizing primary + secondary (buffer) progress simultaneously
- Splitting progress into segments (e.g., steps in a workflow)
- Customizing arc angles (semi-circle, full circle, partial arc)
- Styling progress ring colors, gradients, or range-based colors
- Placing custom content (text, buttons, images) at the center of the ring
**Assembly:** `Syncfusion.SfProgressBar.WPF`
**Namespace:** `Syncfusion.UI.Xaml.ProgressBar`
**XAML Schema:** `http://schemas.syncfusion.com/wpf`
**Key Class:** `SfCircularProgressBar`
---
## Quick Start
```xaml
<Window
xmlns:Syncfusion="http://schemas.syncfusion.com/wpf">
<Grid>
<!-- Determinate: shows 70% progress -->
<Syncfusion:SfCircularProgressBar
Progress="70"
ShowProgressValue="True"
Width="150" Height="150" />
</Grid>
</Window>
```
```csharp
using Syncfusion.UI.Xaml.ProgressBar;
SfCircularProgressBar circular = new SfCircularProgressBar();
circular.Progress = 70;
circular.ShowProgressValue = true;
circular.Width = 150;
grid.Children.Add(circular);
```
---
## Documentation and Navigation Guide
### Getting Started
π **Read:** [references/getting-started.md](references/getting-started.md)
- NuGet/assembly installation (`Syncfusion.SfProgressBar.WPF`)
- XAML namespace and schema declaration
- Declaring the control in XAML and code-behind
- Setting the `Progress` property
- Theme integration via SfSkinManager
### States
π **Read:** [references/states.md](references/states.md)
- Determinate state (default) with `ShowProgressValue`
- Indeterminate state (`IsIndeterminate="True"`) for unknown progress
- Buffer state (`SecondaryProgress`, `SecondaryProgressColor`)
- Decision guide: which state to use when
### Appearance & Customization
π **Read:** [references/appearance.md](references/appearance.md)
- Arc shape via `StartAngle` / `EndAngle`
- Radius and thickness: `IndicatorOuterRadius`, `IndicatorInnerRadius`, `TrackOuterRadius`, `TrackInnerRadius`
- Solid color: `ProgressColor`, `TrackColor`
- Range-based colors: `RangeColor` with `Start`, `End`, `Color`
- Gradient effect: `RangeColor.IsGradient`
- Rounded ends: `IndicatorCornerRadius`
- Animation: `AnimationDuration`, `AnimationEasing`
### Segments & Custom Content
π **Read:** [references/segments-and-custom-content.md](references/segments-and-custom-content.md)
- `SegmentCount` to split ring into discrete steps
- `ProgressContent` for center UI (text, buttons, images)
- Binding center text to `Progress` value
- Play/Pause button with `DispatcherTimer` pattern
---
## Key Properties
| Property | Type | Default | Purpose |
|---|---|---|---|
| `Progress` | `double` | `0` | Current progress value (0β100) |
| `ShowProgressValue` | `bool` | `false` | Display numeric % in center |
| `IsIndeterminate` | `bool` | `false` | Indeterminate spinning animation |
| `SecondaryProgress` | `double` | `0` | Buffer/secondary progress value |
| `StartAngle` | `double` | `-90` | Arc start angle in degrees |
| `EndAngle` | `double` | `270` | Arc end angle in degrees |
| `SegmentCount` | `int` | `0` | Number of segments (0 = none) |
| `ProgressColor` | `Brush` | theme | Color of the progress arc |
| `TrackColor` | `Brush` | theme | Color of the track arc |
| `IndicatorCornerRadius` | `double` | `0` | Rounded ends on the progress arc |
| `AnimationDuration` | `TimeSpan` | `3000ms` | Indeterminate animation cycle time |
| `ProgressContent` | `object` | `null` | Custom center content |
---
## Common Use Cases
- **File upload indicator** β determinate with `ShowProgressValue="True"`
- **Loading spinner** β indeterminate (`IsIndeterminate="True"`)
- **Media player** β `ProgressContent` with play/pause button
- **Step tracker** β `SegmentCount` matching total steps
- **CPU/memory gauge** β `RangeColors` mapping green/yellow/red zones
- **Semi-circle gauge** β `StartAngle="180"` `EndAngle="360"`
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 |