WebUIView 类

定义

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

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
属性
实现

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 请求时触发的事件。

适用于