WebUIView 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
表示应用程序后台脚本 (窗口) 视图。
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, IWebViewControl2Public NotInheritable Class WebUIView
Implements 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 请求时触发的事件。 |