次の方法で共有


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 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 要求が行われたときに発生するイベント。

適用対象