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/getting-started.md
View on GitHub# Getting Started with SfCircularProgressBar
## Table of Contents
- [Installation](#installation)
- [Assembly References](#assembly-references)
- [XAML Namespace Setup](#xaml-namespace-setup)
- [Adding via XAML](#adding-via-xaml)
- [Adding via Code-Behind](#adding-via-code-behind)
- [Theme Integration](#theme-integration)
---
## Installation
Install the NuGet package in your WPF project:
```
Syncfusion.SfProgressBar.WPF
```
Via Package Manager Console:
```powershell
Install-Package Syncfusion.SfProgressBar.WPF
```
The package can also be added by dragging `SfCircularProgressBar` from the Visual Studio Toolbox — the assembly reference is added automatically.
---
## Assembly References
If adding manually (without NuGet), reference:
```
Syncfusion.SfProgressBar.WPF.dll
```
---
## XAML Namespace Setup
Two options for the XAML namespace:
**Option 1 — Syncfusion schema (recommended):**
```xaml
xmlns:Syncfusion="http://schemas.syncfusion.com/wpf"
```
**Option 2 — CLR namespace:**
```xaml
xmlns:Syncfusion="clr-namespace:Syncfusion.UI.Xaml.ProgressBar;assembly=Syncfusion.SfProgressBar.WPF"
```
Both work identically. The schema form is shorter and commonly used in Syncfusion docs.
---
## Adding via XAML
Full minimal window example:
```xaml
<Window
x:Class="MyApp.MainWindow"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:Syncfusion="http://schemas.syncfusion.com/wpf"
Title="MainWindow" Height="300" Width="400">
<Grid x:Name="grid">
<Syncfusion:SfCircularProgressBar
Progress="50"
ShowProgressValue="True"
Width="150"
Height="150" />
</Grid>
</Window>
```
**Minimum required property:** `Progress` (double, 0–100).
---
## Adding via Code-Behind
```csharp
using Syncfusion.UI.Xaml.ProgressBar;
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
SfCircularProgressBar circular = new SfCircularProgressBar();
circular.Progress = 50;
circular.ShowProgressValue = true;
circular.Width = 150;
circular.Height = 150;
grid.Children.Add(circular);
}
}
```
---
## Theme Integration
Apply a Syncfusion theme using `SfSkinManager`:
```xaml
<!-- Add reference: Syncfusion.SfSkinManager.WPF -->
<Window
xmlns:Syncfusion="http://schemas.syncfusion.com/wpf"
xmlns:syncfusion="clr-namespace:Syncfusion.SfSkinManager;assembly=Syncfusion.SfSkinManager.WPF">
<Syncfusion:SfCircularProgressBar
syncfusion:SfSkinManager.Theme="{syncfusion:SkinManagerExtension ThemeName=FluentDark}"
Progress="70"
Width="150" Height="150" />
</Window>
```
Available themes: `FluentLight`, `FluentDark`, `MaterialLight`, `MaterialDark`, `Office2019Colorful`, and others.
Alternatively, refer to [ThemeStudio](https://help.syncfusion.com/wpf/themes/theme-studio) for creating a custom theme.
---
## Gotchas
- **`Progress` range is 0–100** — values outside this range may produce unexpected visual results.
- **`Width` and `Height` should be equal** for a perfect circle; unequal values produce an ellipse.
- **`ShowProgressValue`** shows a numeric percentage in the center of the ring. Set to `false` if using `ProgressContent` for custom center UI to avoid overlapping content.
- **Designer toolbox** — dragging from toolbox automatically adds only `Syncfusion.SfProgressBar.WPF`; other Syncfusion assemblies must be added manually if needed.
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 |