Skip to content

Commit 7ad1f86

Browse files
mikehoffmsmikehoffms
committed
Incorp rvw cmts
1 parent 3db3c43 commit 7ad1f86

1 file changed

Lines changed: 11 additions & 85 deletions

File tree

  • microsoft-edge/webview2/release-notes

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

Lines changed: 11 additions & 85 deletions
Original file line numberDiff line numberDiff line change
@@ -183,44 +183,18 @@ There are known issues with the Find API for PDF documents. When you view a PDF
183183

184184
The `DragStarting` API overrides the default drag and drop behavior when running in visual hosting mode. The `DragStarting` event notifies your app when the user starts a drag operation in the WebView2, and provides the state that's necessary to override the default WebView2 drag operation with your own logic.
185185

186-
* Use `DragStarting` on the `CoreWebView2CompositionController` to add an event handler that's invoked when the drag operation is starting.
187-
* Use `CoreWebView2DragStartingEventArgs` to start your own drag operation.
186+
* Use `DragStarting` on the `ICoreWebView2ExperimentalCompositionController6` to add an event handler that's invoked when the drag operation is starting.
187+
* Use `ICoreWebView2ExperimentalDragStartingEventArgs` to start your own drag operation.
188188
* Use the `GetDeferral` method to execute any async drag logic and call back into the WebView at a later time.
189189
* Use the `Handled` property to let the WebView2 know whether to use its own drag logic.
190190

191191
##### [.NET/C#](#tab/dotnetcsharp)
192192

193-
<!-- todo -->
194-
195-
* `CoreWebView2CompositionController` Class
196-
* `CoreWebView2CompositionController.DragStarting` Event
197-
198-
* `CoreWebView2CompositionControllerInterop` Class
199-
* `CoreWebView2CompositionControllerInterop.DragStarting` Event
200-
201-
* `CoreWebView2DragStartingEventArgs` Class
202-
* `CoreWebView2DragStartingEventArgs.AllowedDropEffects` Property
203-
* `CoreWebView2DragStartingEventArgs.Data` Property
204-
* `CoreWebView2DragStartingEventArgs.Handled` Property
205-
* `CoreWebView2DragStartingEventArgs.Position` Property
206-
* `CoreWebView2DragStartingEventArgs.GetDeferral` Method
193+
n/a
207194

208195
##### [WinRT/C#](#tab/winrtcsharp)
209196

210-
<!-- todo -->
211-
212-
* `CoreWebView2CompositionController` Class
213-
* `CoreWebView2CompositionController.DragStarting` Event
214-
215-
* `CoreWebView2CompositionControllerInterop` Class
216-
* `CoreWebView2CompositionControllerInterop.DragStarting` Event
217-
218-
* `CoreWebView2DragStartingEventArgs` Class
219-
* `CoreWebView2DragStartingEventArgs.AllowedDropEffects` Property
220-
* `CoreWebView2DragStartingEventArgs.Data` Property
221-
* `CoreWebView2DragStartingEventArgs.Handled` Property
222-
* `CoreWebView2DragStartingEventArgs.Position` Property
223-
* `CoreWebView2DragStartingEventArgs.GetDeferral` Method
197+
n/a
224198

225199
##### [Win32/C++](#tab/win32cpp)
226200

@@ -257,69 +231,29 @@ Use this API to manage iframe tracking on a page that contains multiple levels o
257231

258232
##### [.NET/C#](#tab/dotnetcsharp)
259233

260-
* [CoreWebView2Frame Class](/dotnet/api/microsoft.web.webview2.core.corewebview2frame?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
234+
* `CoreWebView2Frame` Class:
261235
* [CoreWebView2Frame.FrameCreated Event](/dotnet/api/microsoft.web.webview2.core.corewebview2frame.framecreated?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
262-
<!-- todo: .Stop Property, like WinRT has? -->
263236

264237
##### [WinRT/C#](#tab/winrtcsharp)
265238

266-
* [CoreWebView2Frame Class](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true)
239+
* `CoreWebView2Frame` Class:
267240
* [CoreWebView2Frame.FrameCreated Event](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true#framecreated)
268-
* [CoreWebView2Frame.Stop Property](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2frame?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true#stop)
269241

270242
##### [Win32/C++](#tab/win32cpp)
271243

272244
* [ICoreWebView2ExperimentalFrame8](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframe8?view=webview2-1.0.3079-prerelease&preserve-view=true)
273245
* [ICoreWebView2ExperimentalFrame8::add_FrameCreated](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframe8?view=webview2-1.0.3079-prerelease&preserve-view=true#add_framecreated)
274246
* [ICoreWebView2ExperimentalFrame8::remove_FrameCreated](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframe8?view=webview2-1.0.3079-prerelease&preserve-view=true#remove_framecreated)
275-
<!-- todo: add Stop Property, like WinRT has? event, or property? -->
276247

277248
* [ICoreWebView2ExperimentalFrameChildFrameCreatedEventHandler](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalframechildframecreatedeventhandler?view=webview2-1.0.3079-prerelease&preserve-view=true)
278249

279250
---
280251

281252

282-
<!-- todo: 1st occurrence of this section within the Jan Prerelease section -->
283-
<!-- ---------- -->
284-
###### Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)
285-
286-
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:
287-
* `FrameworkElement` -> `HwndHost` -> `WebView2`.
288-
* `FrameworkElement` -> `Control` -> `WebView2CompositionControl`.
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).
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).
293-
294-
See also:
295-
* [PR 4804: WPF Airspace - WebView2CompositionControl](https://github.com/MicrosoftEdge/WebView2Feedback/pull/4804/files?short_path=ebbc3ee#diff-ebbc3ee3560606e2823d68c134ea4aebdc1cb1252aaa9aa2b9a2815e2d8d36b2) - Spec.
296-
297-
##### [.NET/C#](#tab/dotnetcsharp)
298-
299-
* `CoreWebView2CompositionController` Class
300-
* [CoreWebView2CompositionController.DragStarting Event](/dotnet/api/microsoft.web.webview2.core.corewebview2compositioncontroller.dragstarting?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
301-
302-
##### [WinRT/C#](#tab/winrtcsharp)
303-
304-
* [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 -->
305-
<!-- todo: add new members? -->
306-
307-
* `CoreWebView2CompositionController` Class
308-
* [CoreWebView2CompositionController.DragStarting Event](/microsoft-edge/webview2/reference/winrt/microsoft_web_webview2_core/corewebview2compositioncontroller?view=webview2-winrt-1.0.3079-prerelease&preserve-view=true#dragstarting)
309-
310-
##### [Win32/C++](#tab/win32cpp)
311-
312-
* [ICoreWebView2ExperimentalCompositionController6](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalcompositioncontroller6?view=webview2-1.0.3079-prerelease&preserve-view=true)
313-
* [ICoreWebView2ExperimentalCompositionController6::add_dragstarting](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalcompositioncontroller6?view=webview2-1.0.3079-prerelease&preserve-view=true#add_dragstarting)
314-
* [ICoreWebView2ExperimentalCompositionController6::remove_dragstarting](/microsoft-edge/webview2/reference/win32/icorewebview2experimentalcompositioncontroller6?view=webview2-1.0.3079-prerelease&preserve-view=true#remove_dragstarting)
315-
316-
---
317-
318-
319253
<!-- ---------- -->
320-
###### Load a WebView2 without a white flash (DefaultBackgroundColor API)
254+
###### Set default background color on WebView2 initialization (DefaultBackgroundColor API)
321255

322-
Prevents a white flash during loading a WebView2.
256+
The DefaultBackgroundColor API allows users to set the `DefaultBackgroundColor` property at initialization. This prevents a disruptive white flash during the WebView2 loading process.
323257

324258
##### [.NET/C#](#tab/dotnetcsharp)
325259

@@ -346,7 +280,6 @@ Prevents a white flash during loading a WebView2.
346280
The following APIs have been promoted from Experimental to Stable in this Prerelease SDK.
347281

348282

349-
<!-- todo: 2nd occurrence of this section within the Jan Prerelease section -->
350283
<!-- ---------- -->
351284
###### Show WPF elements on top of the WebView2 layer (WebView2CompositionControl)
352285

@@ -363,22 +296,15 @@ See also:
363296

364297
##### [.NET/C#](#tab/dotnetcsharp)
365298

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)
299+
* [WebView2CompositionControl Class](/dotnet/api/microsoft.web.webview2.wpf.webview2compositioncontrol?view=webview2-dotnet-1.0.3079-prerelease&preserve-view=true)
368300

369301
##### [WinRT/C#](#tab/winrtcsharp)
370302

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)
303+
n/a
376304

377305
##### [Win32/C++](#tab/win32cpp)
378306

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)
307+
n/a
382308

383309
---
384310

0 commit comments

Comments
 (0)