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	後方ナビゲーション履歴に少なくとも 1 つのページがあるかどうかを示す値を取得します。
CanGoForward	前方ナビゲーション履歴に少なくとも 1 つのページがあるかどうかを示す値を取得します。
ContainsFullScreenElement	全画面表示をサポートする要素がビューに含まれているかどうかを示す値を取得します。
DefaultBackgroundColor	HTML コンテンツで色が指定されていない場合に、ビューの背景として使用する色を取得または設定します。
DeferredPermissionRequests	許可または拒否を待機しているアクセス許可要求のコレクションを取得します。
DocumentTitle	ビューに現在表示されているページのタイトルを取得します。
IgnoreApplicationContentUriRulesNavigationRestrictions	コンテンツ URI ルールとナビゲーション制限を無視するかどうかを指定する値を取得または設定します。
Settings	IWebViewControl 機能を有効または無効にするプロパティを含む WebViewControlSettings オブジェクトを取得します。
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)	指定した Uniform Resource Identifier (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 要求が行われたときに発生するイベント。