Add "Window to Visual" in "Windowed vs. Visual hosting of WebView2"

microsoft-edge/webview2/concepts/windowed-vs-visual-hosting.md

@@ -10,13 +10,17 @@ ms.date: 10/24/2022
 ---
 # Windowed vs. visual hosting of WebView2
 
-There are two options for hosting the Microsoft Edge WebView2 control in your app: windowed hosting and visual hosting.
+There are three options for hosting the Microsoft Edge WebView2 control in your app:
+* Windowed Hosting
+* Window to Visual Hosting
+* Visual Hosting
 
-If you use windowed hosting, which is a good starting point for most apps, you don't need to read this article.  If you want to provide a more custom user experience (UX), and want to use visual hosting, read this article.
+If you use windowed hosting, which is a good starting point for most apps, you don't need to read this article. If you want to provide a more custom user experience (UX) and want to use visual hosting, or if you are using windowed mode in specific scenarios and are experiencing persistent issues with DPI and scaling, read this article.
 
 | Approach | Description | Optimized for |
 |---|---|---|
 | Windowed hosting | The WebView2 control takes input from the operating system (OS).  The OS sends the input to the WebView2. | Displaying web content quickly and easily, without having to include features for inputs, outputs, and accessibility. |
+| Window to Visual hosting | A combination of windowed and visual modes. Similar to windowed mode except that it outputs content to a visual that is hosted in a window rather than hosting content in a window directly. | A developer experience nearly identical to windowed mode but with improved DPI/scaling handling and the caveat that pen input and handwriting is unsupported. |
 | Visual hosting | Your host app takes spatial input (such as mouse or touch input) from the user.  Your app sends this input to the WebView2 control. | More granular control over layout.  For example, you can control the positioning of the WebView2 control in the page.  The app needs to do specific handling of window management and rendering APIs. |
 
 These approaches have different requirements, constraints, and benefits.  Windowed hosting is simpler to implement than visual hosting.  Visual hosting requires all the API calls that Windowed hosting requires, and visual hosting has additional requirements for it to render properly.  The API calls are listed in [Windowed hosting](#windowed-hosting) and [Visual hosting](#visual-hosting), below.
@@ -32,8 +36,13 @@ Both approaches for hosting the WebView2 control in your app are similar in func
 
 "Windowed" means that in your app, an HWND inherits many default properties from the operating system.
 
-There are instances where you might want to focus on displaying web content as quickly and easily as possible in your app.  Windowed hosting allows for a solution that quickly displays web content without having to include features for inputs, outputs, and accessibility.
+There are instances where you might want to focus on displaying web content as quickly and easily as possible in your app.  Windowed hosting allows for a solution that quickly displays web content without having to include features for inputs, outputs, and accessibility.  However this hosting mode can run into DPI issues in specific scenarios such as sharing a user data folder across different applications.
 
+#### Window to Visual hosting: For a similar experience to Windowed hosting with some added benefits and a tradeoff
+
+Window-to-Visual hosting means the WebView2 content is displayed using a visual that is hosted in an HWND. As opposed to hosting the content in a window directly or in a visual directly.
+
+By hosting content in an HWND, this hosting mode enjoys the same ease of adoption benefits as Windowed mode.  But by displaying that content using a visual, this hosting mode avoids some specific DPI issues that can result when using Windowed mode.  To enable it, users must set this environment variable: `COREWEBVIEW2_FORCED_HOSTING_MODE` to the value: `COREWEBVIEW2_HOSTING_MODE_WINDOW_TO_VISUAL`.  It does not require use of the visual hosting APIs. Enabling this hosting mode removes support for pen input and handwriting.
 
 #### Visual hosting: For more granular control over layout
 
@@ -51,7 +60,7 @@ Key compatibility limitations include the operating system and rendering in fram
 <!-- ------------------------------ -->
 #### Operating systems
 
-Windows 7 and Windows 8 can only do windowed hosting, not visual hosting.
+All hosting modes are supported wherever WebView2 is supported ie. Windows 10 and up and certain Windows Server versions. Windows 7, 8 and 8.1 are no longer supported. For those still on those platforms Windows 7 and Windows 8 can only do windowed hosting, not visual hosting.
 
 See [Windows 7 and 8](../index.md#windows-7-and-8) in _Introduction to Microsoft Edge WebView2_.
 
@@ -87,9 +96,9 @@ The `CoreWebView2Controller` properties and methods:
 
 
 <!-- ====================================================================== -->
-## Windowed hosting
+## Windowed and Window to Visual hosting
 
-Windowed hosting can be described as an HWND that stores information.  You can have multiple HWNDs in your app that will each be used as a WebView component to access web content.  Some of the Output/Input commands are handled for you by the framework you choose; however, you will still need to handle window management.
+In the Windowed hosting mode, WebView2 content is hosted directly in a window.  You can have multiple HWNDs in your app that will each be used as a WebView component to access web content.  The benefit of this is that some of the Input/Output commands are handled for you by the OS or by the framework. However, you will still need to handle some aspects of window management.  In the Window to Visual mode, content is hosted slightly differently, but has the same benefits and window management requirements as Windowed.
 
 Benefits for Windowed hosting include:
 
@@ -99,13 +108,23 @@ Benefits for Windowed hosting include:
 
 * You don't have to manage the various composition-based rendering (for example, Inputs, Outputs, and Accessibility controls) if you don't want to.
 
+Benefits for Window to Visual hosting include:
+
+* Different apps that share a WebView2 user data folder can have different DPI awarenesses.
+
+* Different apps that share a WebView2 user data folder can have different integrity levels.
+
+* Different apps that share a WebView2 user data folder will no longer be able to cause each other to hang.
+
+* Changing monitor scale when hosting a WebView2 in a VSTO add-in no longer sporadically hang the application.
+
 For general information regarding Window management and `HWND` functionality, see [About Windows](/windows/win32/winmsg/about-windows).
 
 
 <!-- ------------------------------ -->
 #### Window management
 
-The following aspects of window management are handled in a windowed hosting environment.
+The following aspects of window management need to be handled in a windowed hosting environment.
 
 
 <!-- ---------- -->
@@ -283,7 +302,7 @@ When WebView2 has focus, it receives input directly from the user. An app may wa
 <!-- ---------- -->
 ###### Default background color
 
-WebView2 can specify a default background color. This can be any opaque color or transparent color. This color will be used if the webpage doesn't set its own background color.
+WebView2 can specify a default background color. This can be any opaque color or transparent color. This color will be used if the webpage doesn't set a background color, or sets a transparent background color.
 
 ##### [.NET/C#](#tab/dotnetcsharp)