WindowsCommunityToolkit Versions Save

The Windows Community Toolkit is a collection of helpers, extensions, and custom controls. It simplifies and demonstrates common developer tasks building .NET apps with UWP and the Windows App SDK / WinUI 3 for Windows 10 and Windows 11. The toolkit is part of the .NET Foundation.

v7.1.3

1 year ago

Latest hotfix update to Microsoft.Toolkit.Uwp.* packages for UWP with some fixes since we've been working on Windows Community Toolkit Labs (see #4487) earlier this year.

Reminder the .NET Community Toolkit and the MVVM Toolkit code and packages have been migrated to new repositories and versions (8.1 preview coming soon). You should at least immediately update to leverage the optimizations done in the 8.0 release of CommunityToolkit.Mvvm if you are still on the 7.x packages for performance when used within Visual Studio. New issues and discussions should be opened in that new repository, and not here.

We plan to start porting code over to our new infrastructure for an upcoming 8.0 release (more info to be shared soon as we solidify our plans), look for updates in #4488. Some of this work will be done with Windows Community Toolkit Labs immediately (for instance the new GridSplitter is already there), while other work may be done in a new location or branch here (TBD).

Changes:

Animations :izakaya_lantern::

  • #4719: Animation action changes
  • #4695: StopAnimationActivity and StartAnimationAction dependency properties are incorrectly registered
  • #4466: Fixed DependencyProperty assign exception.
  • #4397: Optimize Visual size sync through RelativeSizeAdjustment over expression animations

Controls :control_knobs::

  • #4792: ColorPicker Slider Circle Accessibility Fix
  • #4786: Fix Text initialization and updating for TokenizingTextBox
  • #4730: fix: Fix color picker button binding failure issue
  • #4749: TokenizingTextBox Text property cannot be set manually from code behind in Release mode
  • #4787: RadialGauge and WeakEventListener optimizations
  • #4784: Fix/Optimization of RadialGauge event handlers
  • #4456: Update RadialGauge to use KeyboardAccelerators
  • #4720: Fixed ImageCropper AspectRatio not updating on image load
  • #4738: ListDetailsView.ListPaneWidth Null check fix
  • #4520: Added FlowDirection override to RadialProgressBar and RadialGauge default style
  • #4424: Fixed InAppNotification not dismissing programmatically after cancelling closing event
  • #4423: InAppNotification can no longer be dismissed after canceling the Closing event
  • #4372: Fix ColorPickerButton SelectedColor bug
  • #4381: Improved opacity support in Radial Gauge
  • #4328: Support AccessibilityView in MetadataControl
  • #4367: ColorPickerButton SelectedColor binding not updating correctly

Extensions :zap::

See More
  • #4510: TextIconExtension to use Segoe Fluent Icons by default
  • #4404: Clip inner content from AttachedCardShadow using CompositionMaskBrush
  • #4333: Feature/extended tree helpers

Documentation :page_with_curl::

  • #4563: Update Readme and add mention of Windows 11 and WinUI 3
  • #4455: Fix linter issues with ReadMe
  • #4392: Fixed broken example code in AnimationBuilder.Create docs
  • #4413: Converted issue templates to use Forms
  • #4177: [Feature] Update Issue Templates to use Issue Form template GitHub feature

Improvements :sparkles::

  • #4764: Fixed StringFormatConverter ignoring Language parameter, cleanup
  • #4553: Make Microsoft.Toolkit.Uwp.Notifications linker-friendly

Helpers :raised_hand::

  • #4790: TaskResultConverter returns default value when task not set
  • #4505: TaskResultConverter causes an InvalidCastException (can't cast COM object to T)

Bugs :bug::

  • #4757: AttachedDropShadowCrashFix
  • #4760: Updated expired UI Test certificate. Expires 9/8/2023.
  • #4549: Fix AttachedDropShadow size changes abnormally
  • #4588: Ryken100/attached card shadow composition mask brush resize fix
  • #4518: Fixed left/right key input for Carousel in RTL Flow Direction
  • #4501: Bump Notifications test project to .NET Core 3.1
  • #4476: Fix DataGrid crash in Sample App
  • #4451: Resolve issue #4432 with release note text overlap
  • #4432: The Release Notes section of the WCT Sample App has overlapping text.

Others:

  • #4789: Update NuGet Version in build pipeline
  • #4589: Migrate FabricBot Tasks to Config-as-Code
  • #4727: Fixed StickyHeaderBehavior HeaderElementProperty owner type / summary
  • #4464: Add tests for toast scenario
  • #4452: Fixed typos in settings.xamlstyler
  • #4403: Remove excessive namespace declarations
  • #4395: .NET Standard extraction

This list of changes was auto generated.

See project tracking board for this release here.

winui-7.1.2

2 years ago

We have shipped another hotfix for 7.1.x as 7.1.2 which supports UWP via our Microsoft.Toolkit.Uwp.* packages and the WinAppSDK/WinUI 3 v1.0 via our CommunityToolkit.WinUI packages. (If you need to use the Toolkit with the 0.8.x releases of the WindowsAppSDK/Project Reunion, please continue to use v7.0.3 of our CommunityToolkit.WinUI packages.)

This includes some minor changes and fixes as well as unifying our version numbers. We're still in the process of migrating code to the .NET Community Toolkit, but expect this to be the last update to the Microsoft.Toolkit based .NET packages as we continue migration to the CommunityToolkit.* identity. We'll share more info as our process progresses in this space.

Changes:

Animations :izakaya_lantern::

  • #4354: Fixed parameter order

Controls :control_knobs::

  • #4362: Fix Radial Gauge ScaleTickBrush color assignment

Bugs :bug::

  • #4364: AttachedCardShadow not working (WinUI 3 WinAppSDK 1.0 Preview 3)
  • #3374: DataGrid fixes for WinUI 3 usage

Others:

  • #4386: Fix app domain unloading issue on .NET Framework
  • #4357: ListDetailsView not working with WinUI3/WindowsAppSDK 1.0.0-preview3

This list of changes was auto generated.

v7.1.2

2 years ago

Placeholder for Tag. See full notes and discussion here.

See More ## Changes:

Animations :izakaya_lantern::

  • #4354: Fixed parameter order

Controls :control_knobs::

  • #4362: Fix Radial Gauge ScaleTickBrush color assignment

Others:

  • #4386: Fix app domain unloading issue on .NET Framework

This list of changes was auto generated.

winui-7.1.1-preview3.1

2 years ago

Small update with fixes address issues with ListDetailsView and AttachedCardShadow in WinUI 3.

Changes:

Bug Fixes :bug::

  • #4357: ListDetailsView not working with WinUI3/WindowsAppSDK 1.0.0-preview3
  • #4364: AttachedCardShadow not working (WinUI 3 WinAppSDK 1.0 Preview 3)

Animations :izakaya_lantern::

  • #4354: Fixed parameter order

Controls :control_knobs::

  • #4362: Fix Radial Gauge ScaleTickBrush color assignment

This list of changes was auto generated.

Main discussion is here.

winui-7.1.1-preview3

2 years ago

We've released a version of the Toolkit for the WindowsAppSDK 1.0-preview3 release on NuGet! 🎉

We've tested checked this release with VS 2022 RC as recommended for the best tooling support in the WASDK documentation. Our instructions for how to get started from our original blog post can be found here. They have been updated and verified against this release.

If you're still using 0.8.x of the Toolkit, please continue using the 7.0.3 version for 0.8.x.

For full details of changes, see release notes from our 7.1.1 Toolkit release: https://github.com/CommunityToolkit/WindowsCommunityToolkit/releases/tag/v7.1.1

Also see notes from main 7.1.0 release here.

v7.1.1

2 years ago

Also see notes from main 7.1.0 release here.

Changes:

Animations :izakaya_lantern::

  • #4311: Fixed incorrect default easing for XAML animation types
  • #4274: Bugfix/implicit animations reset

Extensions :zap::

  • #4294: Fixed the debounce extension in order to update to the last action pa…

Bugs :bug::

  • #4327: Fixed exception type for Guard.IsNotNullOr[Empty|WhiteSpace]
  • #4321: Aspect Ratio: Add implicit converter for integer
  • #4320: Add Property panel for ViewportBehavior
  • #4309: Fix for 4308 (OnDeviceExtension Sample)
  • #4317: Fix to issue #4316 - error in duration to frequency calculation.
  • #4316: OneEuroFilter incorrectly translates from duration to frequency.
  • #4310: Fix Missing Resources Exception leading to VS Designer crash
  • #4293: DispatcherQueueTimerExtensions bug
  • #4285: Fix MVVM Toolkit build errors when using C# < 9.0
  • #4282: Fix MVVM Toolkit LINQ expression issues on .NET Framework
  • #4280: Fixed incorrect paths for pipeline sample resources

This list of changes was auto generated.

v7.1.0

2 years ago

Packages available on NuGet

Read Release Blog here

Video Overview Promotional Video here

Highlights 🌟

On the Horizon 🌅

Changes 📝

💥 Important Notes 💥

  • The style for ListDetailsView style was changed to incorporate TwoPaneView
  • The Graph helpers/controls have been revamped since their earlier preview releases in the Microsoft.Toolkit.Graph* packages and now ship as CommunityToolkit.Authentication* and CommunityToolkit.Graph* packages. Find out more with our docs here.

Known Issues 🐞

  • Some PipelineBrush effects are not working in the sample app including the ImageBlendBrush, currently investigating... (Issue # TBD)

Animations :izakaya_lantern::

  • #4265: Fixed crashes for shadow animations on unloaded items
  • #4183: Clear ReferenceNode ParamNames before serializing each expression string to avoid collisions

Controls :control_knobs::

  • #4249: Upgraded Dismiss button to be legible at 225% text display setting
  • #4255: ListDetailsView unfocus content on SelectedIndex changed.
  • #4253: Fixed culture sensitivity when parsing AspectRatio components
  • #4031: RangeSelector: Moving past second handle
  • #4101: Fix TokenizingTextBox header to behave like normal text control headers
  • #4203: Refactor RichSuggestBox
See More
  • #4134: Color picker fixes
  • #4197: ListDetailsView now uses the Two-Pane View
  • #3607: [Feature] Add DropShadowPanel Support for Grid & Border content with Translucent Brushes & Round Corners
  • #3693: [Feature] Developers should be able to provide custom AlphaMasks to DropShadowPanel for their controls
  • #3650: Implement RichSuggestBox
  • #3649: [Feature] RichSuggestBox control
  • #4169: Add Value Coercion to ConstrainedBox

Extensions :zap::

  • #4230: Fix #4214 - Update AttachedDropShadow visual on layout/visibility
  • #4214: AttachedDropShadow Doesn't Update on Position or Visibility changed
  • #4179: Attached Shadows (Composition and Win2D + Animations)

Documentation :page_with_curl::

  • #4267: Modify DispatcherQueueTimer source for XML docs output
  • #4260: Update AttachedShadow example and future doc links
  • #4251: Various 7.1 Clean-up Fixes
  • #4210: New 7.1 Controls missing from package descriptions
  • #4158: Add ThirdPartyNotice file to packages

Improvements :sparkles::

  • #4173: Enable item renaming and add tests for ApplicationDataStorageHelper

Helpers :raised_hand::

  • #4243: Added DispatcherQueue dispatching for high contrast theme change
  • #3253: Accessible_HighContrastChanged threading issue in dev/7.0.0 impl of ThemeListener
  • #3867: Adding control size trigger

Bugs :bug::

  • #4268: Small Sample updates 7.1
  • #4221: Fixed ValidateAllProperties generation for generated properties
  • #4227: Fixed generated properties within regions
  • #4225: MVVM Source Generators: CS1038 Error if [ObservableProperty] attribute is in a #region block
  • #4242: Fixed [AlsoNotifyChangeFor] attribute definition
  • #4231: Add C# language version diagnostic
  • #3794: Convert DesignTools projects to Sdk-style
  • #4206: fix: Prevent focus reset for DataGridTemplateColumn
  • #2493: DataGrid DataGridTemplateColumn CalendarDatePicker and DatePicker Flash Then Desappear!
  • #4220: Improving ComboBoxColumn behavior to prevent triple click behavior
  • #4219: Fixed [ObservableProperty] for fields named "value"
  • #4191: Fix for ConstrainedBox test in high DPI

Others:

  • #4264: samples.json: Fix Graph doc url
  • #4261: Fix samples.json values.
  • #4259: Remove NotificationsVisualizerLibrary from sample app
  • #4256: Update to WinUI 2.7
  • #4125: Fix most build warnings from the projects
  • #4248: TokenizingTextBox exposes InterspersedObservableCollection instead of ObservableCollection
  • #4189: Prevent floats from being represented in scientific notation in expression animation strings
  • #4198: Fix and enable MVVM Toolkit source generator unit tests
  • #4226: UITests: Remove ref to incorrect version of winui
  • #4200: Add design metadata for RichSuggestBox
  • #4023: Test IncrementalLoadingCollection itemsPerPage ctor param
  • #4204: Update UI Test certificate, now expires 8/30/2022
  • #3122: [Feature] Shadow Receiver XAML Helpers
  • #3516: DropDownShadow doesn't reponse to CornerRadius property
  • #4182: Update winui ref to 2.6.2

This list of changes was auto generated.

v7.1.0-rc2

2 years ago

Follow-on from rc1 with a few more bug fixes.

Changes:

Animations :izakaya_lantern::

  • #4183: Clear ReferenceNode ParamNames before serializing each expression string to avoid collisions

Controls :control_knobs::

  • #4249: Upgraded Dismiss button to be legible at 225% text display setting
  • #4255: ListDetailsView unfocus content on SelectedIndex changed.
  • #4253: Fixed culture sensitivity when parsing AspectRatio components
  • #4031: RangeSelector: Moving past second handle
  • #4101: Fix TokenizingTextBox header to behave like normal text control headers
  • #4203: Refactor RichSuggestBox
  • #4134: Color picker fixes
See More
  • #4197: ListDetailsView now uses the Two-Pane View
  • #3607: [Feature] Add DropShadowPanel Support for Grid & Border content with Translucent Brushes & Round Corners
  • #3693: [Feature] Developers should be able to provide custom AlphaMasks to DropShadowPanel for their controls
  • #3650: Implement RichSuggestBox
  • #3649: [Feature] RichSuggestBox control
  • #4169: Add Value Coercion to ConstrainedBox
  • #4163: Added support for limiting max tokens in TokenizingTextBox
  • #3891: Added TokenizingTextBox automation peer

Extensions :zap::

  • #4230: Fix #4214 - Update AttachedDropShadow visual on layout/visibility
  • #4214: AttachedDropShadow Doesn't Update on Position or Visibility changed
  • #4179: Attached Shadows (Composition and Win2D + Animations)

Documentation :page_with_curl::

  • #4251: Various 7.1 Clean-up Fixes
  • #4210: New 7.1 Controls missing from package descriptions
  • #4158: Add ThirdPartyNotice file to packages
  • #4069: Fixup, Format and Update Markdown files
  • #4170: Fix typo in ConnectionInformation class.

Improvements :sparkles::

  • #4173: Enable item renaming and add tests for ApplicationDataStorageHelper

Helpers :raised_hand::

  • #4243: Added DispatcherQueue dispatching for high contrast theme change
  • #3253: Accessible_HighContrastChanged threading issue in dev/7.0.0 impl of ThemeListener
  • #3867: Adding control size trigger

Bugs :bug::

  • #4221: Fixed ValidateAllProperties generation for generated properties
  • #4227: Fixed generated properties within regions
  • #4225: MVVM Source Generators: CS1038 Error if [ObservableProperty] attribute is in a #region block
  • #4242: Fixed [AlsoNotifyChangeFor] attribute definition
  • #4231: Add C# language version diagnostic
  • #3794: Convert DesignTools projects to Sdk-style
  • #4206: fix: Prevent focus reset for DataGridTemplateColumn
  • #2493: DataGrid DataGridTemplateColumn CalendarDatePicker and DatePicker Flash Then Desappear!
  • #4220: Improving ComboBoxColumn behavior to prevent triple click behavior
  • #4219: Fixed [ObservableProperty] for fields named "value"
  • #4191: Fix for ConstrainedBox test in high DPI
  • #4070: Add missing controls to Visual Studio Toolbox
  • #4168: Fixed nullability attributes generation on .NET Standard targets

Others:

  • #4256: Update to WinUI 2.7
  • #4125: Fix most build warnings from the projects
  • #1234: ScrollHeader: Removed tabstop from ScrollHeader
  • #4248: TokenizingTextBox exposes InterspersedObservableCollection instead of ObservableCollection
  • #4189: Prevent floats from being represented in scientific notation in expression animation strings
  • #4198: Fix and enable MVVM Toolkit source generator unit tests
  • #4226: UITests: Remove ref to incorrect version of winui
  • #4200: Add design metadata for RichSuggestBox
  • #4023: Test IncrementalLoadingCollection itemsPerPage ctor param
  • #4204: Update UI Test certificate, now expires 8/30/2022
  • #3122: [Feature] Shadow Receiver XAML Helpers
  • #3516: DropDownShadow doesn't reponse to CornerRadius property
  • #4182: Update winui ref to 2.6.2
  • #3620: [Follow-up] Remaining Items TODO for DesignTools Refactor
  • #4160: New behavior KeyDownTriggerBehavior

This list of changes was auto generated.

v7.1.0-rc1

2 years ago

See an overview in our blog 7.1-preview post here.

This release also includes Attached Shadow helpers (for Composition and Win2D) and the RichSuggestBox control!

Changes:

Animations :izakaya_lantern::

  • #4112: Generate shorter expression animation strings from ExpressionNode

Controls :control_knobs::

  • #3650: Implement RichSuggestBox
  • #3649: [Feature] RichSuggestBox control (RichSuggestBox Sample directory)
  • #4134: Color picker fixes
  • #4197: ListDetailsView now uses the Two-Pane View
  • #4169: Add Value Coercion to ConstrainedBox
  • #4163: Added support for limiting max tokens in TokenizingTextBox
  • #3891: Added TokenizingTextBox automation peer
  • #4166: MultipleX and MultipleY are missing the ConstraintPropertyChanged callback
  • #4104: Add initial ConstrainedBox control for AspectRatio and Scaling
  • #4132: Updated TabbedCommandBar for WinUI 2.6

Extensions :zap::

See More

Documentation :page_with_curl::

  • #4069: Fixup, Format and Update Markdown files
  • #4170: Fix typo in ConnectionInformation class.

Improvements :sparkles::

  • #4173: Enable item renaming and add tests for ApplicationDataStorageHelper
  • #4135: Improved nullability annotations in MVVM Toolkit
  • #4129: Changed SmoothScrollIntoView method to be truly asynchronous

Helpers :raised_hand::

  • #3867: Adding control size trigger

Bugs :bug::

  • #4191: Fix for ConstrainedBox test in high DPI
  • #4070: Add missing controls to Visual Studio Toolbox
  • #4168: Fixed nullability attributes generation on .NET Standard targets
  • #4138: Fixes DataGrid colors not updating on theme switch
  • #4119: DataGridRowGroupHeader background and theme changes
  • #4151: Forced AnyCPU on builds.
  • #4085: TabbedCommandBar not working Windows App SDK 0.8

Others:

  • #4023: Test IncrementalLoadingCollection itemsPerPage ctor param
  • #4204: Update UI Test certificate, now expires 8/30/2022
  • #3122: [Feature] Shadow Receiver XAML Helpers
  • #3607: [Feature] Add DropShadowPanel Support for Grid & Border content with Translucent Brushes & Round Corners
  • #3516: DropDownShadow doesn't reponse to CornerRadius property
  • #3693: [Feature] Developers should be able to provide custom AlphaMasks to DropShadowPanel for their controls
  • #1234: ScrollHeader: Removed tabstop from ScrollHeader
  • #4182: Update winui ref to 2.6.2
  • #3620: [Follow-up] Remaining Items TODO for DesignTools Refactor
  • #4160: New behavior KeyDownTriggerBehavior
  • #4156: Add WinUI 2.6 Dependency to UnitTests.UWP App
  • #4142: Fix warnings in HighPerformance/Mvvm unit tests
  • #4157: Controls.Media update winui version

This list of changes was auto generated.

v7.1.0-preview1

2 years ago

See an overview in our blog post here.

Changes:

Important Note:

  • #4092: Update all relevant WinUI 2.5 revs to 2.6
See Full Details

Controls :control_knobs::

  • #4104: Add initial ConstrainedBox control for AspectRatio and Scaling
  • #4132: Updated TabbedCommandBar for WinUI 2.6
  • #4131: Update string reliance on WinUI NavigationView
  • #4107: Add custom alpha mask support to DropShadowPanel

Extensions :zap::

  • #4048: TextBoxMask TextChanging fix for #3279
  • #3279: TextBoxMask TextChanging event handler bug
  • #3222: SmoothScrollIntoView ListView Extension

Improvements :sparkles::

  • #4135: Improved nullability annotations in MVVM Toolkit
  • #4129: Changed SmoothScrollIntoView method to be truly asynchronous
  • #4102: ObjectStorage enhancements
  • #3903: [Feature] Migrate ObjectStorage interfaces to *.Toolkit package to enable NetStandard consumption
  • #4050: WeakReferenceMessenger automatic cleanup
  • #4099: Improve FocusBehavior: support list view lazy render. support control x:load
  • #3894: Update package titles and consolidate build logic
  • #4090: 🧪 Add UI Tests for Gridsplitter

Bugs :bug::

  • #4151: Forced AnyCPU on builds.
  • #4085: TabbedCommandBar not working Windows App SDK 0.8
  • #4095: Check style.Ignore if style is not null.

Others:

  • #4157: Controls.Media update winui version
  • #4146: Updated Windows SDK locator script to make it more resilient to x86 vs x64 environments.
  • #4145: Added a parameter for configuration(Debug/Release) on the cake build script
  • #4072: Upgrade Cake Build and its dependencies
  • #1234: ScrollHeader: Removed tabstop from ScrollHeader
  • #3873: MVVM Toolkit vNext: source generators
  • #4126: Update Readme (test CI)
  • #4117: Org rename: windows-toolkit -> CommunityToolkit

This list of changes was auto generated.