WebView.ThreadingOption property

[This documentation is preliminary and is subject to change.]

Gets or sets a value that indicates whether the WebView hosts content on the UI thread or a non-UI thread.

Syntax

public WebViewThreadingOption ThreadingOption { get; set; }
Public Property ThreadingOption As WebViewThreadingOption
public:
property WebViewThreadingOption ThreadingOption { 
   WebViewThreadingOption get();
   void set (WebViewThreadingOption value);
}

Property value

Type: WebViewThreadingOption

A value of the enumeration that specifies whether the WebView hosts content on the UI thread or a non-UI thread. The default for the Desktop device family is OnThread. The default for all other device families is OffThread.

Remarks

Set the ThreadingOption to OnThread to host WebView content on the UI thread. Set it to OffThread to host content on a background thread.

When the WebView is not on the UI thread, the behaviors listed here are not supported.

  • Scroll chaining and pointer chaining. (Input events aren't propagated to parent controls that uses DirectManipulation like ScrollViewer or FlipView.)
  • Tab navigation to escape focus on WebView.
  • Printing.

Requirements (device family)

Device family

Universal

API contract

Windows.Foundation.UniversalApiContract, introduced version 1.0

Namespace

Windows.UI.Xaml.Controls Windows::UI::Xaml::Controls [C++]

Metadata

Windows.Foundation.UniversalApiContract.winmd

See also

WebView