WPF-UI 1.2.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package WPF-UI --version 1.2.1                
NuGet\Install-Package WPF-UI -Version 1.2.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="WPF-UI" Version="1.2.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add WPF-UI --version 1.2.1                
#r "nuget: WPF-UI, 1.2.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install WPF-UI as a Cake Addin
#addin nuget:?package=WPF-UI&version=1.2.1

// Install WPF-UI as a Cake Tool
#tool nuget:?package=WPF-UI&version=1.2.1                

WPF UI

Created with ❤ in Poland by lepo.co
A simple way to make your application written in WPF keep up with modern design trends. Library changes the base elements like Page, ToggleButton or List, and also includes additional controls like Navigation, NumberBox, Dialog or Snackbar.

GitHub license Nuget Nuget (with prereleases) Nuget Size Sponsors

📁 What's included?

Name Framework Build Status
WPFUI<br />Library that allows you to use all features in your own application NET6 NET5<br/>NETCore3<br/>NETFramework48<br/>NETFramework47<br/>NETFramework46 Build status
WPFUI.Demo<br />An application written in WPF .NET 6 where you can test the features. NET6win Build status

📷 Screenshots

Screen-4

Screen-1

Screen-5

Screen-6

🛠️ Custom controls

Control Namespace Description
NumberBox WPFUI.Controls Text field for entering numbers with the possibility of setting a mask.
Button WPFUI.Controls Custom button with additional parameters like an icon.
CardAction WPFUI.Controls Inherited from the Button interactive card styled according to Fluent Design.
CardCollapse WPFUI.Controls Inherited from the ContentControl control which can hide the collapsable content.
CardControl WPFUI.Controls Inherited from the Button control which displays an additional control on the right side of the card.
CardProfile WPFUI.Controls Simple element that displays an image in a circular frame like in default applications for Windows 11.
CodeBlock WPFUI.Controls Formats and display a fragment of the source code.
Dialog WPFUI.Controls Displays a large card with a slightly transparent background and two action buttons.
Snackbar WPFUI.Controls Animated card with a notification displayed at the bottom of the application.
FontIcon WPFUI.Controls Represents a text element containing an icon glyph with selectable font family.
Hyperlink WPFUI.Controls Button that opens a URL in a web browser.
Icon WPFUI.Controls Represents a text element containing an icon glyph.
Navigation WPFUI.Controls Navigation styled as UWP apps.
NavigationStore WPFUI.Controls Navigation styled as Windows 11 Store app
NavigationFluent WPFUI.Controls Navigation styled as Windows 11 Settings app.
TitleBar WPFUI.Controls A set of buttons that can replace the default window navigation, giving it a new, modern look.

🧩 Custom classes and tools

Class Namespace Description
Manager WPFUI.Theme Allows to manage available color themes from the library.
Watcher WPFUI.Theme Listens for SystemParameters changes while waiting for StaticPropertyChanged to change, then switches theme with Manager.Switch.
Progress WPFUI.Taskbar Allows to change the status of the displayed notification in the application icon on the TaskBar.
Mica WPFUI.Background Mica is a material that appears on the backdrop of your application — behind all other content.

🖌️ XAML styles for use in the application.

Resource usage Description
<Window Style="{StaticResource UiWindow}"/> Add a custom appearance to the window and removes the navigation buttons.
<Page Style="{StaticResource UiPage}"/> Add a custom appearance to the page.
<Page Style="{StaticResource UiPageScrollable}"/> Add a custom appearance to the page and automatic display of scrolling if the content is too long.

📐 How to use?

First, your application needs to load custom styles, add in the MyApp\App.xaml file:

<Application>
  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ResourceDictionary Source="pack://application:,,,/WPFUI;component/Styles/Theme/Dark.xaml" />
        <ResourceDictionary Source="pack://application:,,,/WPFUI;component/Styles/WPFUI.xaml" />
      </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
  </Application.Resources>
</Application>

Now, you can customize your views, for example by adding a non-standard look to the main window and navigation buttons

<Window
  xmlns:wpfui="clr-namespace:WPFUI.Controls;assembly=WPFUI"
  Style="{StaticResource UiWindow}">
  <Grid>
    <Grid.RowDefinitions>
      <RowDefinition Height="Auto" />
      <RowDefinition Height="*" />
    </Grid.RowDefinitions>

    <wpfui:TitleBar Grid.Row="0" ApplicationNavigation="True" />

    <Grid Grid.Row="1" Margin="12,6,12,12">
      <Grid.ColumnDefinitions>
        <ColumnDefinition Width="Auto" />
        <ColumnDefinition Width="*" />
      </Grid.ColumnDefinitions>

      <wpfui:NavigationFluent Grid.Column="0" Margin="0,0,12,0" />

      <Frame Grid.Column="1" />
    </Grid>
  </Grid>
</Window>

Special thanks

Crafting apps for .NET without the creators of tools like ReSharper or XAML Styler would never be such a fantastic adventure.

Microsoft Property

Design of the interface, choice of colors and the appearance of the controls were inspired by projects made by Microsoft for Windows 11.
The WPFUI.Demo app includes icons from Shell32 for Windows 11. These icons are the legal property of Microsoft and you may not use them in your own app without permission. They are used here as an example of creating tools for Microsoft systems.

Segoe Fluent Icons

According to the EULA of Segoe Fluent Icons we cannot ship a copy of it with this dll. Segoe Fluent Icons is installed by default on Windows 11, but if you want these icons in an application for Windows 10 and below, you must manually add the font to your application's resources.
https://docs.microsoft.com/en-us/windows/apps/design/style/segoe-fluent-icons-font
https://docs.microsoft.com/en-us/windows/apps/design/downloads/#fonts

In the app dictionaries, you can add an alternate path to the font

<FontFamily x:Key="SegoeFluentIcons">pack://application:,,,/;component/Fonts/#Segoe Fluent Icons</FontFamily>

Compilation

Use Visual Studio 2022 and invoke the .sln.

Visual Studio
WPF UI is an Open Source project. You are entitled to download and use the freely available Visual Studio Community Edition to build, run or develop for WPF UI. As per the Visual Studio Community Edition license, this applies regardless of whether you are an individual or a corporate user.

License

WPF UI is free and open source software licensed under MIT License. You can use it in private and commercial projects.
Keep in mind that you must include a copy of the license in your project.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net5.0-windows7.0 is compatible.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net6.0-windows7.0 is compatible.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.1 is compatible. 
.NET Framework net46 is compatible.  net461 was computed.  net462 was computed.  net463 was computed.  net47 is compatible.  net471 was computed.  net472 was computed.  net48 is compatible.  net481 was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (20)

Showing the top 5 NuGet packages that depend on WPF-UI:

Package Downloads
WPF-UI.Tray

Native tray menu icon support for WPF using the WPF UI library.

MyNet.Wpf

This library is a comprehensive class library designed to simplify the implementation of common GUI functionalities in .NET applications.

WPF-UI.Violeta

WPF UI Violeta is based on WPF UI, and provides the Fluent experience in your known and loved WPF framework. Some new immersive controls like like `Toast`, `Flyout`, `ContentDialog`, `MessageBox` and etc.

Hsm.Ui.Core

UI Core library for Ham Station Master

LYSoft.Libs.Wpf.WpfUI

Package Description

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on WPF-UI:

Repository Stars
microsoft/PowerToys
Windows system utilities to maximize productivity
Version Downloads Last updated
4.0.0-rc.2 3,600 8/11/2024
4.0.0-rc.1 427 7/24/2024
3.0.5 31,292 7/24/2024
3.0.4 34,919 4/14/2024 3.0.4 is deprecated because it has critical bugs.
3.0.3 8,655 3/24/2024 3.0.3 is deprecated because it is no longer maintained.
3.0.2 2,202 3/19/2024
3.0.1 3,564 3/13/2024
3.0.0 24,765 2/4/2024
2.1.0 34,918 8/19/2023 2.1.0 is deprecated because it is no longer maintained and has critical bugs.
2.0.3 66,816 9/25/2022 2.0.3 is deprecated because it is no longer maintained and has critical bugs.
2.0.2 10,088 7/18/2022 2.0.2 is deprecated because it is no longer maintained and has critical bugs.
2.0.1 3,821 6/18/2022 2.0.1 is deprecated because it is no longer maintained and has critical bugs.
2.0.0 1,610 6/16/2022 2.0.0 is deprecated because it is no longer maintained and has critical bugs.
1.2.7 7,229 5/7/2022 1.2.7 is deprecated because it is no longer maintained and has critical bugs.
1.2.6 1,719 5/2/2022 1.2.6 is deprecated because it is no longer maintained and has critical bugs.
1.2.4 2,335 4/20/2022 1.2.4 is deprecated because it is no longer maintained and has critical bugs.
1.2.3 1,261 4/16/2022 1.2.3 is deprecated because it is no longer maintained and has critical bugs.
1.2.2 2,773 3/20/2022 1.2.2 is deprecated because it is no longer maintained and has critical bugs.
1.2.1 3,429 12/22/2021 1.2.1 is deprecated because it is no longer maintained and has critical bugs.
1.2.0 884 12/22/2021 1.2.0 is deprecated because it has critical bugs.
1.1.0 1,181 11/12/2021 1.1.0 is deprecated because it has critical bugs.
1.0.0 1,541 10/3/2021 1.0.0 is deprecated because it has critical bugs.