From 1130808ce6d2ed96ccbd21ee16e82cc87527b5a1 Mon Sep 17 00:00:00 2001 From: Andy De George <67293991+adegeo@users.noreply.github.com> Date: Mon, 9 Nov 2020 09:09:00 -0800 Subject: [PATCH] Add what's new in WinForms article (#114) * Add toc entry * temp * Add whats new article * Minor updates * Update cards * Update cards * Update cards * Another link * Acro * Apply suggestions from code review Co-authored-by: Tom Dykstra Co-authored-by: Tom Dykstra --- dotnet-desktop-guide/net/winforms/index.yml | 12 +++- .../net/winforms/migration/index.md | 2 +- .../net/winforms/overview/index.md | 4 ++ dotnet-desktop-guide/net/winforms/toc.yml | 2 + .../net/winforms/whats-new/index.md | 62 +++++++++++++++++++ 5 files changed, 78 insertions(+), 4 deletions(-) create mode 100644 dotnet-desktop-guide/net/winforms/whats-new/index.md diff --git a/dotnet-desktop-guide/net/winforms/index.yml b/dotnet-desktop-guide/net/winforms/index.yml index 453ee08..f6f644e 100644 --- a/dotnet-desktop-guide/net/winforms/index.yml +++ b/dotnet-desktop-guide/net/winforms/index.yml @@ -16,10 +16,10 @@ landingContent: # Card - title: Learn about Windows Forms linkLists: - - linkListType: download + - linkListType: whats-new links: - - text: Visual Studio 2019 version 16.8 Preview - url: https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019+desktopguide+winforms + - text: What's new + url: whats-new/index.md - linkListType: overview links: - text: Windows Forms overview @@ -28,6 +28,12 @@ landingContent: links: - text: Create a new app url: get-started/create-app-visual-studio.md + - text: Migrate from .NET Framework + url: migration/index.md + - linkListType: download + links: + - text: Visual Studio 2019 version 16.8 + url: https://visualstudio.microsoft.com/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019+desktopguide+winforms - title: Controls linkLists: diff --git a/dotnet-desktop-guide/net/winforms/migration/index.md b/dotnet-desktop-guide/net/winforms/migration/index.md index c588031..9028218 100644 --- a/dotnet-desktop-guide/net/winforms/migration/index.md +++ b/dotnet-desktop-guide/net/winforms/migration/index.md @@ -221,7 +221,7 @@ After you've finished migrating your app, test it! ## Next steps -- Learn about [breaking changes from .NET Framework to .NET Core](/dotnet/core/compatibility/fx-core#windows-forms). +- Learn about [breaking changes in Windows Forms](/dotnet/core/compatibility/winforms). - Read more about the [Windows Compatibility Pack][compat-pack]. [compat-pack]: /dotnet/core/porting/windows-compat-pack diff --git a/dotnet-desktop-guide/net/winforms/overview/index.md b/dotnet-desktop-guide/net/winforms/overview/index.md index 0362e6a..b42c52b 100644 --- a/dotnet-desktop-guide/net/winforms/overview/index.md +++ b/dotnet-desktop-guide/net/winforms/overview/index.md @@ -32,6 +32,10 @@ With Windows Forms, you develop graphically rich apps that are easy to deploy, u To learn how to create a Windows Forms app, see [Tutorial: Create a new WinForms app (Windows Forms .NET)](../get-started/create-app-visual-studio.md). +## Why migrate from .NET Framework + +Windows Forms for .NET 5.0 provides new features and enhancements over .NET Framework. For more information, see [What's new (Windows Forms.NET)](../whats-new/index.md). To learn how to migrate an app, see [How to migrate a Windows Forms desktop app to .NET 5](../migration/index.md). + ## Build rich, interactive user interfaces Windows Forms is a UI technology for .NET, a set of managed libraries that simplify common app tasks such as reading and writing to the file system. When you use a development environment like Visual Studio, you can create Windows Forms smart-client apps that display information, request input from users, and communicate with remote computers over a network. diff --git a/dotnet-desktop-guide/net/winforms/toc.yml b/dotnet-desktop-guide/net/winforms/toc.yml index ed3f2a0..4a9b6f9 100644 --- a/dotnet-desktop-guide/net/winforms/toc.yml +++ b/dotnet-desktop-guide/net/winforms/toc.yml @@ -1,6 +1,8 @@ items: - name: Windows Forms for .NET href: index.yml +- name: What's new + href: whats-new/index.md - name: Get started items: - name: Overview diff --git a/dotnet-desktop-guide/net/winforms/whats-new/index.md b/dotnet-desktop-guide/net/winforms/whats-new/index.md new file mode 100644 index 0000000..3b7b591 --- /dev/null +++ b/dotnet-desktop-guide/net/winforms/whats-new/index.md @@ -0,0 +1,62 @@ +--- +title: What's new in Windows Forms +description: Learn about what's new in Windows Forms for .NET. Windows Forms. .NET provides new features and enhancements over .NET Framework. +ms.date: 11/05/2020 +ms.topic: conceptual +--- + +# What's new (Windows Forms.NET) + +Windows Forms for .NET 5.0 adds the following features and enhancements over .NET Framework. + +There are a few breaking changes you should be aware of when migrating from .NET Framework to .NET 5.0. For more information, see [Breaking changes in Windows Forms](/dotnet/core/compatibility/winforms). + +## Enhanced features + +- Microsoft UI Automation patterns work better with accessibility tools like Narrator and Jaws. +- Improved performance and reliability. +- Better support for high DPI resolutions such as 4k monitors. +- The default font matches the current Windows design recommendations. + + > [!CAUTION] + > This may impact the layout of apps migrated from .NET Framework. + +## New controls + +The following controls have been added since Windows Forms was ported to .NET Framework: + +- + + A task dialog is a dialog box that can be used to display information and receive simple input from the user. Like a message box, it's formatted by the operating system according to parameters you set. Task dialog has more features than a message box. For more information, see the [Task dialog sample](https://github.com/dotnet/samples/tree/master/windowsforms/TaskDialogDemo). + +- + + A new web browser control with modern web support. Based on Edge (Chromium). For more information, see [Getting started with WebView2 in Windows Forms](/microsoft-edge/webview2/gettingstarted/winforms). + +## Enhanced controls + +- + + - Supports collapsible groups. + - Footers + - Group subtitle, task, title images, and collapse/expand functionality. + +- + + This dialog has been upgraded to use the modern Windows experience instead of the old Windows 7 experience. + +- + + - Added support for . + + `ClientGuid` enables a calling application to associate a GUID with a dialog's persisted state. A dialog's state can include factors such as the last visited folder and the position and size of the dialog. Typically, this state is persisted based on the name of the executable file. With `ClientGuid`, an application can persist different states of the dialog within the same application. + +- + + Support added for to enhance performance of rendering text. + +## See also + +- [Breaking changes in Windows Forms](/dotnet/core/compatibility/winforms) +- [Tutorial: Create a new WinForms app (Windows Forms .NET)](../get-started/create-app-visual-studio.md) +- [How to migrate a Windows Forms desktop app to .NET 5](../migration/index.md)