ListView<\/code> now correctly announces when a group is expanded or collapsed.<\/li>\n- More controls now provide UI Automation support:\n
\nTreeView<\/code><\/li>\nDateTimePicker<\/code><\/li>\nToolStripContainer<\/code> and ToolStripPanel<\/code><\/li>\nFlowLayoutPanel<\/code>, TableLayoutPanel<\/code> and SplitContainer<\/code><\/li>\nPrintPreviewControl<\/code><\/li>\nWebBrowser<\/code><\/li>\n<\/ul>\n<\/li>\n- Multiple memory leaks resulting from running Windows Forms applications under assistive tools (e.g., Narrator) have been fixed. Specifically, some controls and their corresponding accessible objects would remain in memory after a form that hosted those controls was closed.<\/li>\n
- Assistive tools now accurately draw focus indicators and report correct bounding rectangles for nested forms and some elements of composite controls, such as
DataGridView<\/code>, ListView<\/code>, TabControl<\/code> and others.<\/li>\n- ExpandCollapse Control Pattern<\/a> support in
ListView<\/code>, TreeView<\/code> and PropertyGrid<\/code> controls has been corrected to activate only for expandable items.<\/li>\n- Various color contrast ratio corrections in
Button<\/code>, DataGridView<\/code> and PropertyGrid<\/code> controls.<\/li>\n- Visibility improvements for
ToolStripTextBox<\/code> and ToolStripButton<\/code> in high-contrast themes.<\/li>\n<\/ul>\n![\"Accessibility](\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2022\/11\/accessibility.png\")
<\/p>\n
High DPI and scaling improvements<\/h2>\n
Throughout the .NET 7 release we continued our work on improving the high DPI support in multi-monitor scenarios (that is, PerMonitorV2<\/code>). Most notably, the Windows Forms runtime now can:<\/p>\n\n- Correctly scale nested controls (e.g., a button which resides in panel, which itself is placed on a tabpage). This class of layout issues was caused by the different order of Windows messages \u2013 in
PerMonitorV2<\/code> mode, a parent control receive the WM_DPICHANGED<\/code><\/a> message after<\/em> all its children have received the message and scaled themselves.<\/li>\n- Scale
Form.MaximumSize<\/code><\/a> and Form.MinimumSize<\/code><\/a> properties based on the current monitor DPI settings for applications that run ApplicationHighDpiMode<\/code><\/a> set to PerMonitorV2<\/code>.<\/li>\n<\/ul>\nThe progress is slow because any changes in the layout engine carry a very high risk. To help reduce the risk we have (re-)introduced “feature switches” back into Windows Forms runtime. This will allow us to add new features and functionality with an escape plan, if those don’t work out for our developers.<\/p>\n
In .NET 7 we added the first switch System.Windows.Forms.ScaleTopLevelFormMinMaxSizeForDpi<\/code> that controls whether the form’s MaximumSize<\/code> and MinimumSize<\/code> properties are scaled whenever WM_DPICHANGED<\/code><\/a> message is received.<\/p>\nIn .NET 7 the new scaling behaviour is disabled<\/em> by default, but in .NET 8 it will be on by default<\/em>. The switch can be configured via runtimeconfig.json<\/a> like so:<\/p>\n{\r\n \"runtimeOptions\": {\r\n \"tfm\": \"net7.0\",\r\n \"frameworks\": [\r\n ...\r\n ],\r\n \"configProperties\": {\r\n \"System.Windows.Forms.ScaleTopLevelFormMinMaxSizeForDpi\": true,\r\n }\r\n }\r\n}<\/code><\/pre>\nDatabinding improvements<\/h2>\n
We want to help Windows Forms developers to modernize their existing apps and to adopt new cloud-based technologies. One way to modernize is the ability to move business logic of a typical line-of-business (LOB) application away from the Windows Forms code-behind pattern towards more modern patterns like Model-View-ViewModel<\/a> (MVVM), which can be easily reused and tested. We also wanted to provide an incentive to pivot away from the 15-year-old Typed DataSets. They have very limited support in the Windows Forms out-of-process designer<\/a> because Visual Studio no longer supports Data Source Provider Service for the .NET runtime. The feedback to the proposed new Binding strategy<\/a> was very positive and indicated that we’re on the right track with that.<\/p>\nWindows Forms already had a powerful binding engine, but to achieve the above goals we introduced support for a more modern form of data binding with data contexts and command patterns, similar to data binding provided by WPF.<\/p>\n
![\"Databinding,](\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2022\/11\/databinding.png\")
<\/p>\n
The new API surface is as follows:<\/p>\n
public class Control {\r\n+ [BindableAttribute(true)]\r\n+ public virtual object DataContext { get; set; }\r\n+ [BrowsableAttribute(true)]\r\n+ public event EventHandler DataContextChanged;\r\n+ protected virtual void OnDataContextChanged(EventArgs e);\r\n+ protected virtual void OnParentDataContextChanged(EventArgs e);\r\n }\r\n\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public abstract class BindableComponent : Component, IBindableComponent, IComponent, IDisposable {\r\n+ protected BindableComponent();\r\n+ public BindingContext? BindingContext { get; set; }\r\n+ public ControlBindingsCollection DataBindings { get; }\r\n+ public event EventHandler BindingContextChanged;\r\n+ protected virtual void OnBindingContextChanged(EventArgs e);\r\n+ }\r\n\r\n public abstract class ButtonBase : Control {\r\n+ [BindableAttribute(true)]\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public ICommand? Command { get; set; }\r\n+ [BindableAttribute(true)]\r\n+ public object? CommandParameter { [RequiresPreviewFeaturesAttribute] get; [RequiresPreviewFeaturesAttribute] set; }\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public event EventHandler? CommandCanExecuteChanged;\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public event EventHandler? CommandChanged;\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public event EventHandler? CommandParameterChanged;\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnCommandCanExecuteChanged(EventArgs e);\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnCommandChanged(EventArgs e);\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnCommandParameterChanged(EventArgs e);\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnRequestCommandExecute(EventArgs e);\r\n }\r\n\r\n+ public abstract class ToolStripItem : BindableComponent, IComponent, IDisposable, IDropTarget {\r\n+ [BindableAttribute(true)]\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public ICommand Command { get; set; }\r\n+ [BindableAttribute(true)]\r\n+ public object CommandParameter { [RequiresPreviewFeaturesAttribute] get; [RequiresPreviewFeaturesAttribute] set; }\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public event EventHandler CommandCanExecuteChanged;\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public event EventHandler CommandChanged;\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ public event EventHandler CommandParameterChanged;\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnCommandCanExecuteChanged(EventArgs e);\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnCommandChanged(EventArgs e);\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnCommandParameterChanged(EventArgs e);\r\n+ [RequiresPreviewFeaturesAttribute]\r\n+ protected virtual void OnRequestCommandExecute(EventArgs e);\r\n }<\/code><\/pre>\nThe new data binding features allows you to fully embrace the MVVM pattern and the use of object-relational mappers from ViewModels in Windows Forms much easier than before. This, in turn, makes it possible to reduce code in the code-behind files, and opens new testing possibilities. More importantly, it enables code share between Windows Forms and other .NET GUI frameworks such as WPF, UWP\/WinUI and MAUI. (To preempt any questions, there are no plans to introduce support for XAML into Windows Forms.)<\/p>\n
It’s important to add that these new binding features are only available under “preview” status<\/a> in .NET 7, so that we can react to developer feedback and tweak the binding during the .NET 8 development cycle. We expect that the new binding functionality will become generally available in .NET 8.<\/p>\nTo enable the new binding, you need to add <EnablePreviewFeatures>true<\/EnablePreviewFeatures><\/code> to your project file. This is supported for both C# and<\/em> Visual Basic from the start.<\/p>\nComWrappers and native AOT<\/h2>\n
In .NET 7 as part of a wider experiment we replaced the selected Windows Forms built-in COM interops with ComWrappers<\/a>.<\/p>\n– What’s the difference?<\/em> – you may ask. Mostly it’s that the built-in COM gets completely disabled in trimming\/native AOT scenarios. That was one of the reasons why trimming was disabled for Windows Forms in .NET 5.<\/p>\n– Why does this matter for Windows Forms which disables trimming during dotnet publish<\/code> step?<\/em> – you may ask again. Even if trimming is disabled it still works, and the migration work allows for further experiments. As an example, it greatly simplifies the ability to run code in native AOT<\/a> without additional customizations. In addition, if you provide a global ComWrappers implementation for the missing accessibility COM objects, you could run a Windows Forms application under native AOT.<\/p>\n:warning: This work is still highly experimental, and some scenarios are rough and require manual work. Mostly this comes from the native AOT limitations<\/a> and trimming quirks<\/a>. Please keep in mind that you need to test your application after you publish.<\/p>\nIf you feel adventurous and wish to experiment or just like to know more about ComWrappers and native AOT for Windows Forms, see @kant2002<\/a>‘s post on Medium “Again WinForms and NativeAOT”<\/a> and his GitHub repository<\/a>.<\/p>\nOther notable changes<\/h2>\n
In no particular order:<\/p>\n
\n- dotnet\/winforms#6576<\/a> enhanced drag-and-drop handling to match the Windows drag-and-drop functionality with richer display effects with an icon and a text label.\n
![\"Drag-and-drop](\"https:\/\/devblogs.microsoft.com\/dotnet\/wp-content\/uploads\/sites\/10\/2022\/11\/dragndrop.png\")
<\/li>\n
- dotnet\/winforms#6244<\/a> brought the file and folder dialogs options to parity with the options available in Windows dialogs<\/a>, such as don’t add to recent, ok button needs interaction, force show hidden, and more.<\/li>\n
- dotnet\/winforms#7403<\/a> made
TreeView<\/code> control respect the DoubleBuffer<\/code> property.<\/li>\n- dotnet\/winforms#6234<\/a> extended
ErrorProvider<\/code> with HasErrors<\/code> property.<\/li>\n- dotnet\/winforms#6335<\/a> fixed the
Form<\/code>‘s snap layout in Windows 11.<\/li>\n<\/ul>\nAnd we have some very cool new UI integration tests<\/a> as a direct result of some of these changes.<\/p>\nBreaking Changes<\/h2>\n
While we intend to maintain backward compatibility with .NET Framework and previous .NET releases as much as possible, it is not always prudent. Follow the link to see the list of breaking changes<\/a>.<\/p>\nCommunity contributions<\/h2>\n
The community continues to play an important part in the life of Windows Forms runtime and the SDK. In .NET 7 timeframe we have merged over 700 pull requests (excluding the automated pull requests) in dotnet\/winforms<\/a> repository with almost 60% of those pull requests authored by the community. All these contributions \u2013 big and small \u2013 are really appreciated.<\/p>\nWe’d like to call out a few community contributors:<\/p>\n
\n- @gpetrou<\/a> has been tirelessly helping with nullable reference types annotations. This work isn’t over, but as you can see from the API diff<\/a> the progress is substantial.<\/li>\n
- @kant2002<\/a> has been driving the ComWrappers and Windows Forms native AOT stories.<\/li>\n
- @willibrandon<\/a> has helped modernizing the drag and drop and the dialogs functionality, as well as writing very elaborate tests for the drag and drop scenarios.<\/li>\n
- @kirsan31<\/a> has taken interest in perf-related issues and removed redundant finalizers, as well as helped stabilizing flaky tests.<\/li>\n
- @jbhensley<\/a> spent some time fixing various control rendering issues (some of which date back to .NET Framework).<\/li>\n<\/ul>\n
Looking ahead<\/h2>\n
We are committed to providing the complete support for PerMonitorV2<\/code> mode. We will continue to work on the scaling-related issues (e.g., dotnet\/winforms#7973<\/a>). We’re also working on a new layout and anchor calculation mechanisms, which are not only expected to address the anchoring issues but should also deliver performance improvements. You can learn more about the new achor layout at dotnet\/winforms#7956<\/a>. In addition, we’ve been considering how we can improve the designer-related developer experience in this area.<\/p>\nWe are also set to continue our modernization journey and to closer align our functionality with Windows. We have started replacing our manually created interop code with the source-generated interops produced by CsWin32 project<\/a>. This not only reduces the maintenance burden for the team, but also opens up new possibilities (e.g., support Windows 11 dark mode<\/a>). We also expect that it may help advancing the trimming and the native AOT stories.<\/p>\nFurthermore, we will continue our work to migrate built-in COM to ComWrapper and bypass the .NET COM interop layer, where possible. And, hopefully, next time around, we will have a significantly better story for self-contained, single-file Windows Forms applications.<\/p>\n
Reporting bugs and suggesting features<\/h2>\n
If you have any comments, suggestions or faced some issues, please let us know! Submit Visual Studio and Designer related issues via Visual Studio Feedback<\/strong> (look for a button in the top right corner in Visual Studio), and Windows Forms runtime related issues at dotnet\/winforms<\/a> repository.<\/p>\nWe also consider API proposals that further enrich Windows Forms SDK and make it easier to build Windows applications. And if you champion a proposal – there is a high chance that you will see it in the Windows Forms SDK.<\/p>\n
You can also become a contributor to the Windows Forms code base! Our repository has items marked “help wanted”<\/a> and API approved for implementation<\/a>, we would really appreciate your help implementing them!<\/p>\nHappy coding!<\/p>\n","protected":false},"excerpt":{"rendered":"
Read about the new features that are in Windows Forms in .NET 7 including new accessibility features, High DPI, UI Automation, and more.<\/p>\n","protected":false},"author":13586,"featured_media":43251,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[685,7163],"tags":[7611,7342,7221,319],"class_list":["post-43042","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-dotnet","category-winforms","tag-dotnet-7","tag-designer","tag-windows-forms","tag-winforms"],"acf":[],"blog_post_summary":"
Read about the new features that are in Windows Forms in .NET 7 including new accessibility features, High DPI, UI Automation, and more.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/43042","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/users\/13586"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/comments?post=43042"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/posts\/43042\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media\/43251"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/media?parent=43042"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/categories?post=43042"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet\/wp-json\/wp\/v2\/tags?post=43042"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}