You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: microsoft-edge/webview2/release-notes/index.md
+42-2Lines changed: 42 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -279,6 +279,7 @@ Use this API to manage iframe tracking on a page that contains multiple levels o
279
279
---
280
280
281
281
282
+
<!-- todo: 1st occurrence of this section within the Jan Prerelease section -->
282
283
<!-- ---------- -->
283
284
###### Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)
284
285
@@ -289,7 +290,9 @@ The `WebView2CompositionControl` prevents the WebView2 control from being the to
289
290
Background: If you're building a Windows Presentation Foundation (WPF) app and using the WebView2 control, you may find that your app runs into "airspace" issues, where the WebView2 control is always displayed on top, hiding any WPF elements in the same location, even if you try to specify the WPF elements to be above the WebView2 control (using visual tree order or the z-index property, for example).
290
291
291
292
This issue occurs because the WPF control uses the WPF `HwndHost` to host the Win32 WebView2 control, and `HwndHost` has an issue with airspace; see [Mitigating Airspace Issues In WPF Applications](https://dwayneneed.github.io/wpf/2013/02/26/mitigating-airspace-issues-in-wpf-applications.html).
@@ -340,7 +343,44 @@ Prevents a white flash during loading a WebView2.
340
343
<!-- ------------------------------ -->
341
344
#### Promotions
342
345
343
-
No APIs have been promoted from Experimental to Stable in this Prerelease SDK.
346
+
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
347
+
348
+
349
+
<!-- todo: 2nd occurrence of this section within the Jan Prerelease section -->
350
+
<!-- ---------- -->
351
+
###### Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)
352
+
353
+
The `WebView2CompositionControl` prevents the WebView2 control from being the topmost layer in a WPF app and obscuring any WPF elements. `Microsoft.Web.WebView2.Wpf.WebView2CompositionControl` is a drop-in replacement for the standard WPF WebView2 control. Both the WebView2 control and `WebView2CompositionControl` implement the `Microsoft.Web.WebView2.Wpf.IWebView2` interface. Both of them derive from `FrameworkElement`, as follows:
Background: If you're building a Windows Presentation Foundation (WPF) app and using the WebView2 control, you may find that your app runs into "airspace" issues, where the WebView2 control is always displayed on top, hiding any WPF elements in the same location, even if you try to specify the WPF elements to be above the WebView2 control (using visual tree order or the z-index property, for example).
358
+
359
+
This issue occurs because the WPF control uses the WPF `HwndHost` to host the Win32 WebView2 control, and `HwndHost` has an issue with airspace; see [Mitigating Airspace Issues In WPF Applications](https://dwayneneed.github.io/wpf/2013/02/26/mitigating-airspace-issues-in-wpf-applications.html).
*[CoreWebView2 Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true)<!-- todo: delete link to large old class -->
0 commit comments