WebUIView 类

定义

命名空间:

Windows.UI.WebUI

表示应用程序后台脚本 (窗口) 视图。

public ref class WebUIView sealed : IWebViewControl, IWebViewControl2

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 458752)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebUIView final : IWebViewControl, IWebViewControl2

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 458752)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebUIView : IWebViewControl, IWebViewControl2

Public NotInheritable Class WebUIView
Implements IWebViewControl, IWebViewControl2

继承

Object Platform::Object IInspectable WebUIView

属性

ContractVersionAttribute MarshalingBehaviorAttribute

实现

IWebViewControl IWebViewControl2

Windows 要求

设备系列	Windows 10, version 1809 (在 10.0.17763.0 中引入)
API contract	Windows.Foundation.UniversalApiContract (在 v7.0 中引入)

示例

应用可以侦听 NewWebUIViewCreated 事件，以截获从 NewWebUIEventCreatedEventArgs.WebUIView) 公开的新视图 (导航的控制：

Windows.UI.WebUI.WebUIApplication.addEventListener("newwebuiviewcreated", newWebUIViewCreatedEventHandler);

注解

Windows 10 Web 应用支持可选的每个应用程序后台脚本，该脚本在激活任何视图之前启动，并在该过程期间运行。 使用此应用，可以监视和修改导航、跨导航跟踪状态、监视导航错误，以及在激活视图之前运行代码。

将此后台脚本指定为应用清单中的 StartPage 时， (窗口) 的每个应用视图都将作为 类的WebUIView实例公开给脚本，并提供与常规 (的 Win32) WebView 相同的事件、属性和方法。

html webview (x-ms-webview/MSHTMLWebViewElement) 与 WebUIView 类之间存在一些差异：

	HTML Webview	WebUIView 类
WebUIView 异步方法	返回 MSWebViewAsyncOperation 对象	返回 JavaScript 承诺 对象
Navigate 方法	需要字符串形式的 URI	需要Windows.Foundation.Uri 对象
InvokeScriptAsync 方法	脚本参数 指定为任意数量的字符串参数	脚本参数 指定为字符串数组

使用后台脚本作为 StartPage 的任何应用激活都将依赖于脚本本身进行导航。

属性

ApplicationViewId	获取此视图的标识符。
CanGoBack	获取一个值，该值指示在向后导航历史记录中是否至少有一个页面。
CanGoForward	获取一个值，该值指示前进导航历史记录中是否至少有一个页面。
ContainsFullScreenElement	获取一个值，该值指示视图是否包含支持全屏的元素。
DefaultBackgroundColor	获取或设置在 HTML 内容未指定颜色时用作视图背景的颜色。
DeferredPermissionRequests	获取等待授予或拒绝的权限请求的集合。
DocumentTitle	获取当前显示在视图中的页面的标题。
IgnoreApplicationContentUriRulesNavigationRestrictions	获取或设置一个值，该值指定是否忽略内容 URI 规则和导航限制。
Settings	获取一个 WebViewControlSettings 对象，该对象包含用于启用或禁用 IWebViewControl 功能的属性。
Source	获取或设置要显示在 控件中的 HTML 内容的 URI 源。

方法

AddInitializeScript(String)	添加用于初始化视图的脚本。
BuildLocalStreamUri(String, String)	创建可以传递给 NavigateToLocalStreamUri 的 URI
CapturePreviewToStreamAsync(IRandomAccessStream)	创建当前视图内容的图像，并将其写入指定的流。
CaptureSelectedContentToDataPackageAsync()	异步获取一个 DataPackage ，其中包含控件中的选定内容。
CreateAsync()	创建新视图作为异步操作。
CreateAsync(Uri)	创建具有特定参数的新视图，作为异步操作。
GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)	返回具有指定 ID 的延迟权限请求。
GoBack()	导航到导航历史记录中的上一页。
GoForward()	导航到导航历史记录中的下一页。
InvokeScriptAsync(String, IIterable<String>)	使用特定参数从当前加载的 HTML 执行指定的脚本函数，作为异步操作。
Navigate(Uri)	在指定的统一资源标识符 (URI) 加载 HTML 内容。
NavigateToLocalStreamUri(Uri, IUriToStreamResolver)	使用 IUriToStreamResolver 加载指定 URI 上的本地 Web 内容。
NavigateToString(String)	将指定的 HTML 内容作为新文档加载。
NavigateWithHttpRequestMessage(HttpRequestMessage)	将控件导航到具有 POST 请求和 HTTP 标头的 URI。
Refresh()	重新加载 控件中的当前内容。
Stop()	停止当前控件导航或下载。

事件

Activated	在激活视图时发生。
Closed	在视图已关闭时发生。
ContainsFullScreenElementChanged	当视图当前是否包含全屏元素的状态发生更改时发生。
ContentLoading	在视图开始加载新内容时发生。
DOMContentLoaded	当视图完成分析当前 HTML 内容时触发的事件。
FrameContentLoading	当视图中的帧开始加载新内容时发生。
FrameDOMContentLoaded	当视图中的框架已完成分析其当前 HTML 内容时发生。
FrameNavigationCompleted	在控件完成加载当前内容或导航失败时发生。
FrameNavigationStarting	在视图导航到新内容之前发生。
LongRunningScriptDetected	在控件执行 JavaScript 时定期触发的事件，使你能够停止脚本。
NavigationCompleted	在控件完成加载当前内容或导航失败时发生。
NavigationStarting	在控件导航到新内容之前发生。
NewWindowRequested	当用户在 控件中执行导致内容在新窗口中打开的操作时发生。
PermissionRequested	当控件中的操作需要授予该权限时发生。
ScriptNotify	当控件中包含的内容使用 JavaScript 将字符串传递给应用时发生。
UnsafeContentWarningDisplaying	当控件显示 SmartScreen 筛选器报告为不安全的内容的警告页时发生。
UnsupportedUriSchemeIdentified	尝试使用控件不支持的方案导航到 URI 时发生。
UnviewableContentIdentified	控件尝试下载不受支持的文件时触发的事件。
WebResourceRequested	发出 HTTP 请求时触发的事件。