Windows UI Library 2.4

WinUI 2.4 is the latest official release of the Windows UI Library (WinUI).

WinUI is an open source project hosted on GitHub at Windows UI Library repo. Please register all bug reports, feature requests, and community code contributions in this repo.

WinUI Releases: GitHub release page

WinUI packages can be added to Visual Studio projects through the NuGet package manager. For more information, see Getting Started with the Windows UI Library.

NuGet package download: Microsoft.UI.Xaml

New Features

RadialGradientBrush

A RadialGradientBrush is drawn within an ellipse defined by Center, RadiusX, and RadiusY properties. Colors for the gradient start at the center of the ellipse and end at the radius.

Radial gradient brush
Radial gradient brush

Usage guidelines

API reference

ProgressRing

The ProgressRing control is used for modal interactions where the user is blocked until the ProgressRing disappears. Use this control if an operation requires that most interaction with the app be suspended until the operation is complete.

ProgressRing control
ProgressRing control

Usage guidelines

API reference

TabView updates

The TabView control updates provide you with more control over how to render tabs.

You can set the width of unselected tabs and show just an icon to save screen space:

TabView control tab sizes
TabView control tab sizes

You can also hide the close button on unselected tabs until the user hovers over the tab (in previous versions it was always shown):

TabView control hover to close
TabView control hover to close

Usage guidelines

API reference

Dark theme updates to TextBox family of controls

When dark theme is enabled, the background color of TextBox family controls remains dark by default on text insertion (in previous versions, the background color changes to white during text insertion).

Before After
TextBox dark theme updates (before)
TextBox dark theme updates (before)
TextBox dark theme updates (after)
TextBox dark theme updates (after)
TextBox dark theme updates (before)
TextBox dark theme updates (before)
TextBox dark theme updates (after)
TextBox dark theme updates (after)

The following are some of the controls included in the TextBox family of controls:

Hierarchical navigation

The NavigationView control now supports hierarchical navigation and includes Left, Top, and LeftCompact display modes. A hierarchical NavigationView is useful for displaying categories of pages, identifying pages with related child-pages, or using within apps that have hub-style pages linking to many other pages.

Hierarchical NavigationView control
Hierarchical NavigationView control

Usage guidelines

API reference

Samples

Examples of each of the WinUI 2.4 features described are available in the XAML Controls Gallery.

If you don't have the XAML Controls Gallery app installed, get it from the Microsoft Store.

You can also view the XAML Controls Gallery source code on GitHub.