Mekumiao.WPF-UI 3.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package Mekumiao.WPF-UI --version 3.0.0                
NuGet\Install-Package Mekumiao.WPF-UI -Version 3.0.0                
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="Mekumiao.WPF-UI" Version="3.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Mekumiao.WPF-UI --version 3.0.0                
#r "nuget: Mekumiao.WPF-UI, 3.0.0"                
#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 Mekumiao.WPF-UI as a Cake Addin
#addin nuget:?package=Mekumiao.WPF-UI&version=3.0.0

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

WPF UI Banner Dark WPF UI Banner Light

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.

Discord GitHub license Nuget Nuget VS 2022 Downloads Sponsors

ua

Deliver humanitarian aid directly to Ukraine.

https://bank.gov.ua/en/about/humanitarian-aid-to-ukraine

Refugees in Poland

Many forms of support for refugees from Ukraine and organizations supporting them are available on the Polish government website
https://pomagamukrainie.gov.pl/chce-pomoc/prywatnie/pomoc-finansowa

ua

🚀 Getting started

For a starter guide see our documentation.

WPF UI Gallery is a free application available in the Microsoft Store, with which you can test all functionalities.
https://apps.microsoft.com/store/detail/wpf-ui/9N9LKV8R9VGM?cid=windows-lp-hero

$ winget install 'WPF UI'

WPF UI is delivered via NuGet package manager. You can find the package here:
https://www.nuget.org/packages/wpf-ui/

Visual Studio
The plugin for Visual Studio 2022 let you easily create new projects using WPF UI.
https://marketplace.visualstudio.com/items?itemName=lepo.wpf-ui

📁 What's included?

Name Framework
Wpf.Ui<br />Library that allows you to use all features in your own application NET7 NET6<br/>NETCore3<br/>NETFramework48<br/>NETFramework472<br/>NETFramework462
Wpf.Ui.Gallery<br />Application with all controls. NET7-win
Wpf.Ui.Demo.Mvvm<br />An MVVM app written in WPF .NET 6 where you can test the features. NET7-win
Wpf.Ui.Demo.Simple<br />Simple .NET 7 app with navigation. NET7-win
Wpf.Ui.FontMapper<br />Console app for generating Fluent System Icons enums. NET7
Wpf.Ui.Extension<br />Project for Visual Studio 2022 extension. NETFramework48

📷 Screenshots

Demo App Sample

Monaco Editor

Text Editor Sample

Store App Sample

🏗ī¸ Works with Visual Studio Designer

VS2022 Designer Preview

🏁 Virtualized panels for displaying thousands controls

WPF UI virtualized wrap panels

❤ī¸ Custom Tray icon and menu in pure WPF

WPF UI Tray menu in WPF

⚓ Custom Windows 11 SnapLayout available for TitleBar.

WPF UI Snap Layout for WPF

🕹ī¸ Radiograph

Radiograph is a computer hardware monitoring app that uses WPF UI.

Radiograph screenshot

<img src="https://github.com/lepoco/wpfui/blob/main/.github/assets/microsoft-badge.png?raw=true" width="120">

📖 Documentation

Documentation can be found at https://wpfui.lepo.co/. We also have a tutorial over there for newcomers.

🚧 Development

If you want to propose a new functionality or submit a bugfix, create a Pull Request for the branch development.

📐 How to use?

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

<Application
  ...
  xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml">
  <Application.Resources>
    <ResourceDictionary>
      <ResourceDictionary.MergedDictionaries>
        <ui:ThemesDictionary Theme="Dark" />
        <ui:ControlsDictionary />
      </ResourceDictionary.MergedDictionaries>
    </ResourceDictionary>
  </Application.Resources>
</Application>

If your application does not have MyApp\App.xaml file, use ApplicationThemeManager.Apply(frameworkElement) to apply/update the theme resource in the frameworkElement.

public partial class MainWindow
{
    public MainWindow()
    {
        InitializeComponent();
        ApplicationThemeManager.Apply(this);
    }
}

Now you can create fantastic apps, e.g. with one button:

<ui:UiWindow
  ...
  xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml">
  <Grid>
    <ui:Button
      Content="Hello World"
      Icon="Fluent24"/>
  </Grid>
</ui:UiWindow>

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 Wpf.Ui.Gallery app includes icons from Microsoft WinUI 3 Gallery app. They are used here as an example of creating tools for Microsoft systems.

Segoe Fluent Icons

WPF UI uses Fluent System Icons. Although this font was also created by Microsoft, it does not contain all the icons for Windows 11. If you need the missing icons, add Segoe Fluent Icons to your application.
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.

Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community.

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 net6.0-windows7.0 is compatible.  net7.0-windows was computed.  net7.0-windows7.0 is compatible.  net8.0-windows was computed.  net8.0-windows7.0 is compatible. 
.NET Framework net462 is compatible.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  net48 was computed.  net481 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETFramework 4.6.2

  • .NETFramework 4.7.2

    • No dependencies.
  • .NETFramework 4.8.1

    • No dependencies.
  • net6.0-windows7.0

    • No dependencies.
  • net7.0-windows7.0

    • No dependencies.
  • net8.0-windows7.0

    • No dependencies.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Mekumiao.WPF-UI:

Package Downloads
Mekumiao.WPF-UI.Tray

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

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
3.0.0.4 286 2/15/2024
3.0.0.1 169 2/14/2024
3.0.0 343 2/7/2024
3.0.0-preview.15 77 1/25/2024
3.0.0-preview.14 57 1/25/2024
3.0.0-preview.13 68 1/22/2024