Microsoft.Toolkit.Uwp.UI

This library provides various common UI helpers. It is a part of the Windows Community Toolkit. AdvancedCollectionView: It's a collection view implementation that support filtering, sorting and incremental loading. It's meant to be used in a viewmodel. CacheBase: Provides methods and tools to cache files in a folder. Converters: Commonly used converters that allow the data to be modified as it passes through the binding engine. Extensions: - ApplicationViewExtensions: Provides attached properties for interacting with the ApplicationView on a window (app view). - AttachedDropShadow: Provides a composition based shadow effect which supports masking. - FrameworkElementExtensions: Provides attached dependency properties for the FrameworkElement. - ListViewExtensions: Provides attached dependency properties for the ListViewBase - LogicalTree: Defines a collection of extensions methods for UI. - MatrixExtensions: Provides a set of extensions to the Matrix struct. - MatrixHelperEx: Static helper methods for Matrix. - Mouse: Helper class for easily changing the mouseover cursor type. - NullableBool: Custom MarkupExtension which can provide nullable bool values. - RotateTransformExtensions: Extension methods for RotateTransform. - ScaleTransformExtensions: Extension methods for ScaleTransform. - ScrollViewerExtensions: Provides attached dependency properties for the ListViewBase - SkewTransformExtensions: Extension methods for SkewTransform. - SurfaceDialTextbox: Helper class that provides attached properties to enable any TextBox with the Surface Dial. - TextBoxMask: TextBox mask property allows a user to more easily enter fixed width text in TextBox control. - TextBoxRegex: TextBoxRegex allows text validation using a regular expression. - TitleBarExtensions: Provides attached dependency properties for interacting with the ApplicationViewTitleBar on a window (app view). - TranslateTransformExtensions: Extension methods for TranslateTransform. - VisualExtensions: Extension methods and attached properties for Visual objects - VisualTree: Defines a collection of extensions methods for UI. Helpers: - BindableValueHolder: Holds the value. Can be used to change several objects' properties at a time. - DependencyPropertyWatcher: Used to Track Changes of a Dependency Property - ThemeListener: Class which listens for changes to Application Theme or High Contrast Modes and Signals an Event when they occur. Triggers: Various Visual State Triggers to help trigger VisualStates in a wide variety of scenarios.


Keywords
.NET, ApplicationView, Community, Converters, Extensions, FrameworkElement, Helpers, ListView, Matrix, Mouse, SurfaceDial, TextBoxMask, TitleBar, Toolkit, UI, UWP, VisualTree, WCT, Windows, XAML, csharp, dotnet, mvvm, uwp-apps, uwp-toolkit, visual-studio, windows-10, windows-app-sdk, windows-sdk, windows-toolkit, windowsappsdk, winforms, winui, winui3, wpf, xaml-islands
License
MIT
Install
Install-Package Microsoft.Toolkit.Uwp.UI -Version 7.1.3

Documentation

✨ New Repository ✨

❗ We moved development to a new repository, 'Windows'. It contains the new infrastructure and codebase for the 8.0+ versions of the Windows Community Toolkit that contains a single-codebase for UWP/WinUI2, WindowsAppSDK/WinUI3, and Uno Platform compatible components. Please visit it for the latest information.

πŸ“ You can find out more about this latest release on our blog post here. The Sample Gallery has also been updated in the Microsoft Store.

πŸ§ͺ For new feature discussion and development, see Windows Community Toolkit Labs

🐞 For new issues, please try and reproduce on the latest packages, and then open a discussion or issue in the new repository.

πŸ“Ό This repo contains the prior 7.x UWP-only based code for the Windows Community Toolkit's prior releases; the Windows App SDK compatible code is in the winui branch. Much of this code has been merged and ported to the single-codebase version in the new repository; however, this repo will be archived for history and reference to enable migrating other components or issues, if needed.

🧰 Windows Community Toolkit 7.x

The Windows Community Toolkit is a collection of helper functions, custom controls, and app services. It simplifies and demonstrates common developer patterns when building experiences for Windows 10 and Windows 11. It contains components and helpers for both UWP and WinUI 3/WinAppSDK applications. Find out more about our support for WinUI 3 here.

Note: Our general helpers for .NET are now the .NET Community Toolkit, including the MVVM Toolkit.

Target Branch Status Recommended package version
Production (UWP) rel/7.1.2 Build Status NuGet
Production (WinAppSDK/WinUI 3) rel/winui/7.1.2 Build Status NuGet
Previews main Build Status DevOps

πŸ“’ Windows Community Toolkit v8

The toolkit has been migrated to new infrastructure in this repository.

Read the original blog post that explained this here, but see latest information at the top of this file.

πŸ§ͺ Windows Community Toolkit Labs πŸ’»

Labs makes it easy to contribute to the Windows Community Toolkit, try out new features still in development, and collaborate with others.

Find out more here.

πŸ™Œ Getting Started

Please read the Getting Started with the Windows Community Toolkit page for more detailed information about using the toolkit.

πŸ“ƒ Documentation

All documentation for the toolkit is hosted on Microsoft Docs. All API documentation can be found at the .NET API Browser.

πŸ“± Windows Community Toolkit Sample App

Want to see the toolkit in action before jumping into the code? Download and play with the Windows Community Toolkit Sample App from the Store.

⁉ Support

If you need help with something or have an idea, feel free to start a Discussion or find us on Discord. If you have detailed repro steps, open an issue here instead.

πŸš€ Contribution

Do you want to contribute? Check out our Windows Community Toolkit Wiki page to learn more about contribution and guidelines.

πŸ“¦ NuGet Packages

NuGet is a standard package manager for .NET applications which is built into Visual Studio. When you open solution in Visual Studio, choose the Tools menu > NuGet Package Manager > Manage NuGet packages for solution… Enter one of the package names mentioned in Windows Community Toolkit NuGet Packages table to search for it online.

πŸ“« Features

The Features list refers to all the currently available features that can be found in the Windows Community Toolkit. Most features should work with the October 2018 Update (1809) SDK 17763 and above; however, refer to specific documentation on each feature for more information.

πŸ’  Principles

  1. The toolkit will be kept simple.
  2. As soon as a comparable feature is available in the Windows SDK for Windows, it will be marked as deprecated.
  3. All features will be supported for two Windows SDK for Windows release cycles or until another principle supersedes it.

🌍 Roadmap

See our 2022 Plans here.

Read what we plan for next iterations, and feel free to ask questions.

Check out our Preview Packages Wiki Page to learn more about updating your NuGet sources in Visual Studio, then you can also get pre-release packages of upcoming versions to try.

πŸ“„ Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

🏒 .NET Foundation

This project is supported by the .NET Foundation.

πŸ† Contributors

Toolkit Contributors

Made with contrib.rocks.