Skip to content

Commit 3db3c43

Browse files
committed
dup the CompCtrl section
1 parent 7fdb1ca commit 3db3c43

1 file changed

Lines changed: 42 additions & 2 deletions

File tree

  • microsoft-edge/webview2/release-notes

microsoft-edge/webview2/release-notes/index.md

Lines changed: 42 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -279,6 +279,7 @@ Use this API to manage iframe tracking on a page that contains multiple levels o
279279
---
280280

281281

282+
<!-- todo: 1st occurrence of this section within the Jan Prerelease section -->
282283
<!-- ---------- -->
283284
###### Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)
284285

@@ -289,7 +290,9 @@ The `WebView2CompositionControl` prevents the WebView2 control from being the to
289290
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).
290291

291292
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).
292-
<!-- todo: [PR 4804: WPF Airspace - WebView2CompositionControl](https://github.com/MicrosoftEdge/WebView2Feedback/pull/4804/files) -->
293+
294+
See also:
295+
* [PR 4804: WPF Airspace - WebView2CompositionControl](https://github.com/MicrosoftEdge/WebView2Feedback/pull/4804/files?short_path=ebbc3ee#diff-ebbc3ee3560606e2823d68c134ea4aebdc1cb1252aaa9aa2b9a2815e2d8d36b2) - Spec.
293296

294297
##### [.NET/C#](#tab/dotnetcsharp)
295298

@@ -340,7 +343,44 @@ Prevents a white flash during loading a WebView2.
340343
<!-- ------------------------------ -->
341344
#### Promotions
342345

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:
354+
* `FrameworkElement` -> `HwndHost` -> `WebView2`.
355+
* `FrameworkElement` -> `Control` -> `WebView2CompositionControl`.
356+
357+
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).
360+
361+
See also:
362+
* [PR 4804: WPF Airspace - WebView2CompositionControl](https://github.com/MicrosoftEdge/WebView2Feedback/pull/4804/files?short_path=ebbc3ee#diff-ebbc3ee3560606e2823d68c134ea4aebdc1cb1252aaa9aa2b9a2815e2d8d36b2) - Spec.
363+
364+
##### [.NET/C#](#tab/dotnetcsharp)
365+
366+
* `CoreWebView2CompositionController` Class
367+
* [CoreWebView2CompositionController.DragStarting Event](/dotnet/api/microsoft.web.webview2.core.corewebview2compositioncontroller.dragstarting?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
368+
369+
##### [WinRT/C#](#tab/winrtcsharp)
370+
371+
* [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 -->
372+
<!-- todo: add new members? -->
373+
374+
* `CoreWebView2CompositionController` Class
375+
* [CoreWebView2CompositionController.DragStarting Event](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2compositioncontroller?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true#dragstarting)
376+
377+
##### [Win32/C++](#tab/win32cpp)
378+
379+
* [ICoreWebView2ExperimentalCompositionController6](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalcompositioncontroller6?view=webview2-1.0.3079-prerelease&preserve-view=true)
380+
* [ICoreWebView2ExperimentalCompositionController6::add_dragstarting](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalcompositioncontroller6?view=webview2-1.0.3079-prerelease&preserve-view=true#add_dragstarting)
381+
* [ICoreWebView2ExperimentalCompositionController6::remove_dragstarting](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalcompositioncontroller6?view=webview2-1.0.3079-prerelease&preserve-view=true#remove_dragstarting)
382+
383+
---
344384

345385

346386
<!-- ------------------------------ -->

0 commit comments

Comments
 (0)