Language

CoreWebView2LaunchingExternalUriSchemeEventArgs.Handled Property

Definition

Indicates whether a CoreWebView2Frame event handler has handled this LaunchingExternalUriScheme event. Defaults to false.

public bool Handled { get; set; }
member this.Handled : bool with get, set
Public Property Handled As Boolean

Property Value

Remarks

By default, the LaunchingExternalUriScheme and LaunchingExternalUriScheme event handlers are all invoked, with the CoreWebView2Frame event handlers invoked first, innermost frame first for nested iframes. The host may set this property to true within a CoreWebView2Frame event handler to prevent the remaining ancestor CoreWebView2Frame and CoreWebView2 event handlers from being invoked. Setting Handled has no effect when the event is raised on CoreWebView2; it only suppresses the remaining handlers when set from a frame-level event handler.

If a deferral is taken on the event args, then you must synchronously set Handled to true prior to taking your deferral to prevent the remaining ancestor frame and CoreWebView2 event handlers from being invoked.

Applies to