共用方式為

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 Promise 物件
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)

傳回具有指定識別碼的延後許可權要求。
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 要求時引發的事件。

適用於