BetterProgressBar.WinUI3 0.6.0

BetterProgressBar.WinUI3

An enhanced WinUI 3 ProgressBar control published by ZipGenius. It mirrors the full API of the standard WinUI 3 ProgressBar and adds a rich set of opt-in features, including predefined themes that replicate the classic Windows 7, Windows 10 and Windows 11 progress bar looks.

Features

Requirements

• Windows App SDK 1.8+
• .NET 8, 9, or 10
• Windows 10 1809 (build 17763) or later

Installation

dotnet add package BetterProgressBar.WinUI3

Or search for BetterProgressBar.WinUI3 in the NuGet Package Manager inside Visual Studio.

Quick start

1. Merge the resource dictionary in App.xaml

<Application.Resources>
    <ResourceDictionary>
        <ResourceDictionary.MergedDictionaries>
            <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls" />
            <ResourceDictionary Source="ms-appx:///BetterProgressBar.WinUI3/Themes/Generic.xaml" />
        </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
</Application.Resources>

2. Add the XML namespace

xmlns:ctrl="using:ZipGenius.BetterProgressBar"

3. Drop the control into your XAML

<ctrl:BetterProgressBar Value="65" />


<ctrl:BetterProgressBar Value="40"
                        Theme="Windows11"
                        BarHeight="14"
                        Ticks="Both"
                        TickFrequency="10"
                        ShowPercentage="True" />


<ctrl:BetterProgressBar Value="80" ProgressState="Warning" />


<ctrl:BetterProgressBar ProgressState="Indeterminate" />

4. Taskbar integration (code-behind)

// In your MainWindow constructor, after the window is created:
using WinRT.Interop;

nint hwnd = WindowNative.GetWindowHandle(this);
MyBar.SetTaskbarOwnerWindow(hwnd);
MyBar.SyncTaskbar = true;

From this point any change to Value or ProgressState is automatically reflected in the Windows taskbar button.

Themes

BetterProgressBar ships with three predefined visual themes that replicate the classic Windows progress bar looks. Set the Theme property to activate one; individual appearance properties can still override specific values afterwards.

<ctrl:BetterProgressBar Value="60" Theme="Windows11" />


<ctrl:BetterProgressBar Value="60" Theme="Windows10" />


<ctrl:BetterProgressBar Value="60" Theme="Windows7" />


<ctrl:BetterProgressBar Value="60"
                        Theme="None"
                        BarHeight="12"
                        FillBrush="#FF008080"
                        TrackBrush="#FFDDDDDD" />

ProgressBarTheme enum

All five states

<ctrl:BetterProgressBar Value="65" ProgressState="Normal" />
<ctrl:BetterProgressBar Value="45" ProgressState="Warning" />
<ctrl:BetterProgressBar Value="80" ProgressState="Error" />
<ctrl:BetterProgressBar Value="50" ProgressState="Disabled" />
<ctrl:BetterProgressBar            ProgressState="Indeterminate" />

ProgressBarState enum

Tick marks

<ctrl:BetterProgressBar Value="40" Ticks="Above" TickFrequency="10" />


<ctrl:BetterProgressBar Value="75"
                        Ticks="Both"
                        TickFrequency="5"
                        ShowPercentage="True" />

TickFrequency sets the number of equal divisions (1–10). Endpoint ticks (0 % and 100 %) are tallest, the midpoint tick (50 %) is medium height, and all intermediate ticks are the shortest.

FillThickness

FillThickness lets you create a thin fill stripe inside a taller track:

<ctrl:BetterProgressBar Value="55"
                        Theme="None"
                        BarHeight="20"
                        FillThickness="4" />

When FillThickness is 0 (default) the fill occupies the full BarHeight.

Properties reference

Range

State

Theme

Taskbar

void SetTaskbarOwnerWindow(nint hwnd)

Tick marks

Percentage label

Appearance

Events

MyBar.ValueChanged += (sender, e) =>
{
    Debug.WriteLine($"Value changed: {e.OldValue} → {e.NewValue}");
};

Full customization example

<ctrl:BetterProgressBar Value="55"
                        Theme="None"
                        BarHeight="16"
                        FillThickness="10"
                        Ticks="Both"
                        TickFrequency="5"
                        ShowPercentage="True"
                        FillBrush="#FF008080"
                        TrackBrush="#FFFFE0F0"
                        WarningBrush="#FFFF6600"
                        ErrorBrush="#FFB00020"
                        TickBrush="#FF606060" />

License

MIT © ZipGenius