Skip to content

syncfusion/wpf-ui-components-skills / skills/syncfusion-wpf-circular-progressbar

syncfusion-wpf-circular-progressbar

Verified

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.

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

<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>
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

  • 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

  • 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

  • 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

  • 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

PropertyTypeDefaultPurpose
Progressdouble0Current progress value (0–100)
ShowProgressValueboolfalseDisplay numeric % in center
IsIndeterminateboolfalseIndeterminate spinning animation
SecondaryProgressdouble0Buffer/secondary progress value
StartAngledouble-90Arc start angle in degrees
EndAngledouble270Arc end angle in degrees
SegmentCountint0Number of segments (0 = none)
ProgressColorBrushthemeColor of the progress arc
TrackColorBrushthemeColor of the track arc
IndicatorCornerRadiusdouble0Rounded ends on the progress arc
AnimationDurationTimeSpan3000msIndeterminate animation cycle time
ProgressContentobjectnullCustom 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"
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
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: 196kUpdated Claude CodeCodexVerifiedInstall