WebView クラス

リファレンス

定義

名前空間:: Windows.UI.Xaml.Controls

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

アプリで HTML コンテンツをホストするコントロールを提供します。

public ref class WebView sealed : FrameworkElement

/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Xaml.Controls.IWebViewFactory4, 65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WebView final : FrameworkElement

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Xaml.Controls.IWebViewFactory4, 65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class WebView final : FrameworkElement

[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.Controls.IWebViewFactory4), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WebView : FrameworkElement

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.Controls.IWebViewFactory4), 65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class WebView : FrameworkElement

Public NotInheritable Class WebView
Inherits FrameworkElement

<WebView .../>

継承: Object Platform::Object IInspectable DependencyObject UIElement FrameworkElement WebView

属性: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

例

ヒント

詳細、設計ガイダンス、およびコード例については、「 Web ビュー」を参照してください。

WinUI 2 ギャラリー アプリがインストールされている場合は、ここをクリックしてアプリを開き、WebView の動作を確認してください。

次のコード例では、という名前Addressの TextBox に含まれる URI に WebView を移動する方法を示します。

try
{
    Uri targetUri = new Uri(Address.Text);
    webViewA.Navigate(targetUri);
}
catch (FormatException ex)
{
    // Bad address.
}

次のコード例では、ローカル HTML を WebView コントロールに読み込む方法を示します。

webViewB.NavigateToString(
    "<html><body><h2>This is an HTML fragment</h2></body></html>");

注釈

WebView コントロールを使用して、アプリで Web コンテンツをホストします。 Surface Hub または Xbox 用アプリでは、この WebView を使用する必要があります。

重要

デスクトップアプリの場合は、Windows UI Library 2 for UWP (WinUI 2) の一部として使用できる WebView2 コントロールを使用することをお勧めします。 WebView2 では、Microsoft Edge (Chromium) をレンダリングエンジンとして使用して、アプリに Web コンテンツを表示します。詳細については、WinUI API リファレンスの「Microsoft Edge WebView2 の概要」、「 WinUI 2 (UWP) アプリでの WebView2 の概要」、および「WebView2 」を参照してください。

重要

XAML Islands: このコントロールは、XAML Islands アプリではサポートされていません。代替手段については、「 XAML Islands - Web ビューコントロール」を参照してください。

WebView は Control サブクラスでないため、コントロールテンプレートはありません。 WebView の視覚的な側面を制御するために、さまざまなプロパティを設定できます。表示領域は、 Width プロパティと Height プロパティによって制限されます。 WebView を変換、スケーリング、スキュー、回転するには、 RenderTransform プロパティを使用します。 WebView の不透明度を制御するには、 Opacity プロパティを設定します。 HTML コンテンツが色を指定していないときに、Web ページの背景として色を指定するには、DefaultBackgroundColor プロパティを設定します。

DocumentTitle プロパティを使用すると、WebView に現在表示されている HTML ドキュメントのタイトルを取得できます。

WebView は Control サブクラスではありませんが、キーボード入力フォーカスを受け取り、タブシーケンスに参加します。ただし、Focus メソッド、そして GotFocus イベントと LostFocus イベントを提供しますが、タブ関連のプロパティはありません。タブ順での位置は、XAML ドキュメントの順序での位置と同じです。タブシーケンスには、入力フォーカスを受け取ることができる WebView コンテンツ内のすべての要素が含まれます。

イベントテーブルで示されているように、WebView では、KeyDown、KeyUp、PointerPressed など、UIElement から継承されたほとんどのユーザー入力イベントはサポートされていません。一般的な回避策は、JavaScript eval 関数と共に InvokeScriptAsync を使用して HTML イベントハンドラーを使用し、HTML イベントハンドラーから window.external.notify を使用して WebView.ScriptNotify を使用してアプリケーションに通知することです。

Windows 10用にコンパイルされたアプリでは、WebView は Microsoft Edge レンダリングエンジンを使用して HTML コンテンツを表示します。 Windows 8 または Windows 8.1 用にコンパイルされたアプリでは、WebView はドキュメントモードでインターネットエクスプローラー 11 を使用します。 Microsoft Silverlight やポータブルドキュメント形式 (PDF) ファイルなどの Microsoft ActiveX コントロールやプラグインはサポートされていません。

コンテンツに移動する

WebView には、 GoBack、 GoForward、 Stop、 Refresh、 CanGoBack、 CanGoForward という基本的なナビゲーション用の API がいくつか用意されています。これらを使うと、一般的な Web 閲覧機能をアプリに追加できます。

WebView の初期コンテンツを設定するには、XAML で Source プロパティを設定します。 XAML パーサーは文字列を Uri に自動的に変換します。

<!-- Source file is on the web. -->
<WebView x:Name="webViewA" Source="http://www.contoso.com"/>

<!-- Source file is in local storage. -->
<WebView x:Name="webViewB" Source="ms-appdata:///local/intro/welcome.html"/>

<!-- Source file is in the app package. -->
<WebView x:Name="webViewC" Source="ms-appx-web:///help/about.html"/>

Source プロパティはコードで設定できますが、設定するのではなく、通常、Navigate メソッドのいずれかを使用してコード内のコンテンツを読み込みます。

Web コンテンツを読み込むには、http または https スキームを使用する Uri で Navigate メソッドを使用します。

webViewA.Navigate(new Uri("http://www.contoso.com"));

POST 要求と HTTP ヘッダーを使用して Uniform Resource Identifier (URI) に移動するには、 NavigateWithHttpRequestMessage メソッドを使用します。このメソッドは、HttpRequestMessage.Method プロパティの値として HttpMethod.Post と HttpMethod.Get のみをサポートします。

圧縮されておらず、暗号化もされていないコンテンツをアプリの LocalFolder データストアまたは TemporaryFolder データストアから読み込むには、Navigate メソッドを、ms-appdata スキームを使う Uri と共に用います。このスキームの WebView サポートでは、ローカルフォルダーまたは一時フォルダーのサブフォルダーにコンテンツを配置する必要があります。これにより、ms-appdata:///local/ folderファイル.htmlや ms-appdata:///temp/ folder//ファイル.htmlなどの URI (Uniform Resource Identifier) へのナビゲーションが可能になります。 (圧縮され、暗号化されたファイルを読み込む場合は、NavigateToLocalStreamUri に関するページをご覧ください)。

これらの第 1 レベルのサブフォルダーは、他の第 1 レベルのサブフォルダー内のコンテンツから分離されます。たとえば「ms-appdata:///temp/folder1/file.html」に移動はできますが、このファイル内のリンクに「ms-appdata:///temp/folder2/file.html」は指定できません。ただし、ms-appx-web スキームを使用してアプリパッケージ内の HTML コンテンツと、http および https Uniform Resource Identifier (URI) スキームを使用して Web コンテンツにリンクすることはできます。

webViewA.Navigate(new Uri("ms-appdata:///local/intro/welcome.html"));

アプリパッケージからコンテンツを読み込むには、Navigate メソッドを ms-appx-web スキームを使った Uri と共に用います。

webViewA.Navigate(new Uri("ms-appx-web:///help/about.html"));

NavigateToLocalStreamUri メソッドを使えば、カスタムリゾルバーを通じてローカルのコンテンツを読み込めます。これにより、Web ベースのコンテンツをオフライン用にダウンロードしたりキャッシュしたり、圧縮ファイルからコンテンツを抽出したりといった高度なシナリオも可能です。

WebView には、ナビゲーションとコンテンツの読み込み状態に応答するために使用できるいくつかのイベントが用意されています。イベントは、ルート WebView コンテンツに対して次の順序で発生します。

NavigationStarting - WebView が新しいコンテンツに移動する前に発生します。このイベントのハンドラーでナビゲーションを取り消すには、 WebViewNavigationStartingEventArgs.Cancel プロパティを true に設定 します。

webViewA.NavigationStarting += webViewA_NavigationStarting;

private void webViewA_NavigationStarting(object sender, WebViewNavigationStartingEventArgs args)
{
    // Cancel navigation if URL is not allowed. (Implemetation of IsAllowedUri not shown.)
    if (!IsAllowedUri(args.Uri))
        args.Cancel = true;
}

ContentLoading - WebView が新しいコンテンツの読み込みを開始したときに発生します。

webViewA.ContentLoading += webViewA_ContentLoading;

private void webViewA_ContentLoading(WebView sender, WebViewContentLoadingEventArgs args)
{
    // Show status.
    if (args.Uri != null)
    {
        statusTextBlock.Text = "Loading content for " + args.Uri.ToString();
    }
}

DOMContentLoaded - WebView が現在の HTML コンテンツの解析を完了したときに発生します。

webViewA.DOMContentLoaded += webViewA_DOMContentLoaded;

private void webViewA_DOMContentLoaded(WebView sender, WebViewDOMContentLoadedEventArgs args)
{
    // Show status.
    if (args.Uri != null)
    {
        statusTextBlock.Text = "Content for " + args.Uri.ToString() + " has finished loading";
    }
}

NavigationCompleted - WebView が現在のコンテンツの読み込みを完了したとき、またはナビゲーションに失敗した場合に発生します。ナビゲーションが失敗したかどうかを判断するには、WebViewNavigationCompletedEventArgs クラスの IsSuccess プロパティと WebErrorStatus プロパティを確認します。

webViewA.NavigationCompleted += webViewA_NavigationCompleted;

private void webViewA_NavigationCompleted(WebView sender, WebViewNavigationCompletedEventArgs args)
{
    if (args.IsSuccess == true)
    {
        statusTextBlock.Text = "Navigation to " + args.Uri.ToString() + " completed successfully.";
    }
    else
    {
        statusTextBlock.Text = "Navigation to: " + args.Uri.ToString() +
                               " failed with error " + args.WebErrorStatus.ToString();
    }
}

同様のイベントは、WebView コンテンツ内の iframe ごとに同じ順序で発生します。

FrameNavigationStarting - WebView 内のフレームが新しいコンテンツに移動する前に発生します。
FrameContentLoading - WebView 内のフレームが新しいコンテンツの読み込みを開始したときに発生します。
FrameDOMContentLoaded - WebView 内のフレームが現在の HTML コンテンツの解析を完了したときに発生します。
FrameNavigationCompleted - WebView 内のフレームのコンテンツの読み込みが完了したときに発生します。

潜在的な問題に対処する

実行時間の長いスクリプト、WebView で読み込みできないコンテンツ、安全でないコンテンツの警告など、コンテンツに関する潜在的な問題に対応できます。

スクリプトを実行中にアプリが応答しないような場合があったとします。 LongRunningScriptDetected イベントは、WebView が JavaScript を実行している間に定期的に発生し、スクリプトを中断する機会を提供します。スクリプトがどれくらいの時間実行されているか調べるには、WebViewLongRunningScriptDetectedEventArgs の ExecutionTime プロパティを確認します。スクリプトを停止するには、イベント引数の StopPageScriptExecution プロパティを true に設定します。停止したスクリプトは、後続の WebView ナビゲーション中に再読み込みされない限り、再度実行されません。

WebView コントロールは、任意のファイルの種類をホストできません。 WebView でホストできないコンテンツを読み込もうとすると、 UnviewableContentIdentified イベントが発生します。このイベントを処理してユーザーに通知することも、Launcher クラスを使ってファイルを外部のブラウザーまたは別のアプリにリダイレクトすることもできます。

同様に、 UnsupportedUriSchemeIdentified イベントは、サポートされていない Uniform Resource Identifier (URI) スキームが、fbconnect:// や mailto:// などの Web コンテンツで呼び出されたときに発生します。このイベントを処理して、既定のシステム起動ツールで Uniform Resource Identifier (URI) を起動するのではなく、カスタム動作を提供できます。

UnsafeContentWarningDisplaying イベントは、SmartScreen フィルターによって安全でないと報告されたコンテンツの警告ページが WebView に表示されるときに発生します。ユーザーがナビゲーションの続行を選んだ場合は、そのページへの移動では以降、警告が表示されたり、イベントが発されたりすることはありません。

WebView コンテンツの特殊なケースの処理

ContainsFullScreenElement プロパティと ContainsFullScreenElementChanged イベントを使うと、全画面での動画の再生といった、全画面表示を可能にしたり、検出したり、または処理したりすることができます。たとえば、 ContainsFullScreenElementChanged イベントを使用して、WebView のサイズを変更してアプリビュー全体を占めたり、次の例に示すように、全画面表示 Web エクスペリエンスが必要な場合にウィンドウ化されたアプリを全画面表示モードにしたりできます。

// Assume webView is defined in XAML
webView.ContainsFullScreenElementChanged += webView_ContainsFullScreenElementChanged;

private void webView_ContainsFullScreenElementChanged(WebView sender, object args)
{
    var applicationView = ApplicationView.GetForCurrentView();

    if (sender.ContainsFullScreenElement)
    {
        applicationView.TryEnterFullScreenMode();
    }
    else if (applicationView.IsFullScreenMode)
    {
        applicationView.ExitFullScreenMode();
    }
}

NewWindowRequested イベントを使えば、たとえばポップアップウィンドウのように、ホストされている Web コンテンツによって新しいウィンドウの表示が要求されるようなケースに対処できます。別の WebView コントロールで、要求されたウィンドウのコンテンツを表示することもできます。

特別な機能を必要とする Web 機能を有効にするには、PermissionRequested イベントを使います。現在、これらには位置情報、IndexedDB ストレージ、ユーザーのオーディオやビデオ (たとえば、マイクまたは Web カメラの機能) があります。アプリがユーザーの位置情報またはユーザーのメディアにアクセスする場合も、アプリのマニフェストでそうした機能を宣言する必要があります。たとえば、位置情報を使うアプリでは少なくとも Package.appxmanifest で次の機能の宣言が必要です。

<Capabilities>
  <Capability Name="internetClient"/>
  <DeviceCapability Name="location"/>
</Capabilities>

アプリによる PermissionRequested イベントの処理に加えて、これらの機能を有効にするには、位置情報やメディアの機能を要求するアプリに関する、標準的なシステムダイアログをユーザーが承認する必要があります。

次の例は、アプリによって Bing のマップで位置情報がどのように有効されるかを示しています。

// Assume webView is defined in XAML
webView.PermissionRequested += webView_PermissionRequested;

private void webView_PermissionRequested(WebView sender, WebViewPermissionRequestedEventArgs args)
{
    if (args.PermissionRequest.PermissionType == WebViewPermissionType.Geolocation &&
        args.PermissionRequest.Uri.Host == "www.bing.com")
    {
        args.PermissionRequest.Allow();
    }
}

アプリが許可の要求に応答するにあたってユーザーの入力をはじめ非同期の操作を要求する場合は、WebViewPermissionRequest の Defer メソッドを使い、後で処理できる WebViewDeferredPermissionRequest を作成します。 WebViewPermissionRequest.Defer に関するページをご覧ください。

ユーザーが WebView でホストされている Web サイトから安全にログアウトする必要がある場合、またはセキュリティが重要な場合は、静的メソッド ClearTemporaryWebDataAsync を呼び出して、WebView セッションからローカルにキャッシュされたすべてのコンテンツをクリアします。これにより、悪意あるユーザーが重要なデータにアクセスするのを防ぎます。

WebView コンテンツの操作

InvokeScriptAsync メソッドを使用して WebView コンテンツにスクリプトを呼び出すか挿入し、ScriptNotify イベントを使用して WebView コンテンツから情報を取得することで、WebView のコンテンツを操作できます。

WebView コンテンツ内で JavaScript を呼び出すには、 InvokeScriptAsync メソッドを使用します。呼び出されたスクリプトは、文字列型の値のみを返すことができます。

たとえば、という名前 webViewA の WebView のコンテンツに、3 つのパラメーターを受け取るという名前 setDate の関数が含まれている場合は、次のように呼び出すことができます。

string[] args = {"January", "1", "2000"};
string returnValue = await webViewA.InvokeScriptAsync("setDate", args);

InvokeScriptAsync を JavaScript の eval 関数と共に使って、Web ページにコンテンツを挿入します。

ここでは、XAML TextBox (nameTextBox.Text) のテキストは、でホストされている HTML ページの div に webViewA書き込まれます。

private async void Button_Click(object sender, RoutedEventArgs e)
{
    string functionString = String.Format("document.getElementById('nameDiv').innerText = 'Hello, {0}';", nameTextBox.Text);
    await webViewA.InvokeScriptAsync("eval", new string[] { functionString });
}

WebView コンテンツ内のスクリプトでは、 window.external.notify を文字列パラメーターと共に使用して、アプリに情報を返送できます。これらのメッセージを受け取るには、ScriptNotify イベントを処理します。

window.external.notify を呼び出すときに外部 Web ページで ScriptNotify イベントを発生させるには、アプリマニフェストの ApplicationContentUriRules セクションにページの Uniform Resource Identifier (URI) を含める必要があります。 (これは、Package.appxmanifest デザイナーの [コンテンツ URI] タブの Microsoft Visual Studio で行うことができます)。この一覧の URI は HTTPS を使用する必要があり、サブドメインワイルドカード (https://.microsoft.com など) を含めることができますが、ドメインワイルドカード (https://.com や https:// など) を含めることはできません。マニフェスト要件は、アプリパッケージから生成されたコンテンツには適用されず、ms-local-stream:// URI を使うか、NavigateToString を使って読み込まれるかのいずれかです。

WebView でWindows ランタイムにアクセスする

Windows 10以降では、AddWebAllowedObject メソッドを使用して、Windows ランタイムコンポーネントから WebView の JavaScript コンテキストにネイティブクラスのインスタンスを挿入できます。これにより、その WebView の JavaScript コンテンツ内のそのオブジェクトのネイティブメソッド、プロパティ、およびイベントへのフルアクセスが可能になります。クラスは、AllowForWeb 属性で修飾される必要があります。

たとえば、このコードは、Windows ランタイムコンポーネントから WebView にインポートされたのMyClassインスタンスを挿入します。

private void webView_NavigationStarting(WebView sender, WebViewNavigationStartingEventArgs args)
{
    if (args.Uri.Host == "www.contoso.com")
    {
        webView.AddWebAllowedObject("nativeObject", new MyClass());
    }
}

詳しくは、WebView.AddWebAllowedObject に関するページをご覧ください。

さらに、WebView の信頼できる JavaScript コンテンツは、Windows RuntimeAPI に直接アクセスできます。これにより、WebView でホストされる Web アプリの強力なネイティブ機能が提供されます。この機能を有効にするには、信頼済みコンテンツの Uniform Resource Identifier (URI) を Package.appxmanifest のアプリの ApplicationContentUriRules の許可リストに追加する必要があります。WindowsRuntimeAccess は特に "all" に設定されています。

この例は、アプリマニフェストのセクションを示しています。ここでは、ローカルの Uniform Resource Identifier (URI) にWindows ランタイムへのアクセス権が付与されます。

<Applications>
  <Application Id="App"
    ...

    <uap:ApplicationContentUriRules>
      <uap:Rule Match="ms-appx-web:///Web/App.html" WindowsRuntimeAccess="all" Type="include"/>
    </uap:ApplicationContentUriRules>
  </Application>
</Applications>

Web コンテンツのホスティングのオプション

Windows 10以降、WebView.Settings プロパティ (WebViewSettings 型) を使用して、JavaScript と IndexedDB を有効にするかどうかを制御できます。たとえば、WebView を使用して厳密に静的なコンテンツを表示する場合は、最適なパフォーマンスを得るために JavaScript を無効にすることをお勧めします。

WebView コンテンツのキャプチャ

WebView コンテンツを他のアプリと共有できるようにするには、選択したコンテンツを DataPackage として返す CaptureSelectedContentToDataPackageAsync メソッドを使用します。このメソッドは非同期であるため、DataRequested イベントハンドラーが、非同期呼び出しが完了する前に戻されてしまうのを防ぐために、遅延を使用する必要があります。

WebView の現在のコンテンツのプレビューイメージを取得するには、 CapturePreviewToStreamAsync メソッドを使用します。このメソッドは、現在のコンテンツのイメージを作成し、指定のストリームに書き込みます。

実行モード

既定では、WebView コンテンツはデスクトップデバイスファミリのデバイス上の UI スレッドでホストされ、他のすべてのデバイスの UI スレッドからホストされます。 WebView.DefaultExecutionMode 静的プロパティを使うと、現在のクライアントに対する既定のスレッド処理動作を照会できます。必要であれば、WebView(WebViewExecutionMode) コンストラクターを使ってその動作をオーバーライドすることもできます。

サポートされている WebViewExecutionMode 値は次のとおりです。

SameThread - WebView コンテンツは UI スレッドでホストされます。
SeparateThread - WebView コンテンツは、UI スレッドから離れた別のスレッドでホストされます。
SeparateProcess - (Windows 10 バージョン 1803 以降) WebView コンテンツは、アプリプロセスとは別のプロセスでホストされます。アプリのすべての WebView インスタンスは同じ個別のプロセスを共有しますが、WebView インスタンスごとに個別のプロセスはありません。

別のプロセスで実行する場合、WebView は次の 2 つの動作の違いを生み出します。

WebView プロセスが終了する可能性があります。この通知は、 SeparateProcessLost イベントをリッスンすることで通知できます。
WebView プロセスでは、キーボードフォーカスを非同期的に拒否できます。この場合、WebView.Focus メソッドは true を返し、直ちに (ただし非同期的に) フォーカスを WebView から移動します。 (フォーカスを移動する他の方法 (FocusManager.TryMoveFocus など) も同様に動作します)。これは、 FocusManager.TryFocusAsync または FocusManager.TryMoveFocusAsync API を使用して、より明示的に追跡できます。

この例では、ホストアプリとは別のプロセスで実行され、別のプロセスが失われた場合に再作成される WebView コントロールを作成する方法を示します。

<Grid>
    <Border x:Name="WebViewBorder" Loaded="WebViewBorder_Loaded" />
</Grid>

    ...

public sealed partial class MainPage : Page
{
    public MainPage()
    {
        this.InitializeComponent();

        var webView = new WebView(WebViewExecutionMode.SeparateProcess);
        WebViewBorder.Child = webView;;

        InitializeWebView(webView);
    }

    void InitializeWebView(WebView webView)
    {
        webView.Source = this.WebViewSourceUri;

        webView.SeparateProcessLost += (sender, e) =>
        {
            var newWebView = new WebView(WebViewExecutionMode.SeparateProcess);
            InitializeWebView(newWebView);
            WebViewBorder.Child = newWebView;
        };
    }
}

注意

モバイルデバイスで UI スレッドでコンテンツをホストするときにパフォーマンスの問題が発生する可能性があるため、 DefaultExecutionMode を変更するときは、必ずすべてのターゲットデバイスでテストしてください。

UI スレッドからコンテンツをホストする WebView は、WebView コントロールから親に伝達するジェスチャを必要とする親コントロール ( FlipView、 ScrollViewer、その他の関連するコントロールなど) と互換性がありません。これらのコントロールは、オフスレッド WebView で開始されたジェスチャを受信できません。さらに、オフスレッドの Web コンテンツの出力は、直接サポートされていません。つまり、要素は WebViewBrush フィルで代わりに出力することになります。

別のプロセスでの WebView のフォーカス動作

アプリプロセスで実行する場合も、別のプロセスで実行する場合でも、WebView.Focus メソッドを呼び出すことで WebView にフォーカスを設定できます。これは、Control.Focus メソッドと Hyperlink.Focus メソッドと同じです (WebView は Control から派生しないことに注意してください)。

同様に、 FocusManager クラスのいくつかのメソッドは、WebView (または Control または Hyperlink) に影響を与える可能性があります。 TryMoveFocus、 FindNextFocusableElement、 FindLastFocusableElement、 GetFocusedElement。たとえば、TryMoveFocus はフォーカスを WebView に移動し、GetFocusedElement はフォーカスを持つ WebView を返します。

最後に、WebView との間でフォーカスを移動すると、WebView 自体と、フォーカスを失ったり受け取ったりする要素の両方でフォーカスイベントが発生します。イベントは LosingFocus、 LostFocus、 GettingFocus、 GotFocus です。たとえば、フォーカスが Control から WebView に移動すると、コントロールは LosingFocus イベントと LostFocus イベントを発生させ、WebView は GettingFocus イベントと GotFocus イベントを発生させます。

WebView が別のプロセスで実行されている場合、これらの API の動作は若干変わります。 WebView がフォーカス可能であると仮定すると、WebView.Focus メソッドは true (成功) を返しますが、フォーカスはまだ移動していません。 WebView.Focus メソッドではなく FocusManager.TryMoveFocus が呼び出され、WebView が次のフォーカス可能な要素として識別される場合も同様です。

動作の違いは次のとおりです。

非同期操作が完了するまで、FocusManager.GetFocusedElement は WebView を返しません。
フォーカスを失っているコントロールは、LosingFocus イベントを同期的に受け取ります。ただし、非同期操作が完了するまで/でない限り、LostFocus は受け取りません。
同様に、GettingFocus イベントは WebView で同期的に発生します。ただし、非同期操作が完了するまで、GotFocus イベントは発生しません。

代わりに FocusManager.TryFocusAsync を呼び出した場合、この変更はありません。ただし、非同期メソッドを使用すると、フォーカスの変更が成功したかどうかを判断できます。

別のプロセスで WebView 以外の要素に対して FocusManager.TryMoveFocusAsync を呼び出すと、同期的に完了します。

この例では、フォーカスを次の論理要素に移動する方法を示しますが、失敗した場合は、最初の場所にフォーカスを復元します。

async void MoveFocus(WebView webView))
{
    FocusMovementResult result;
    result = await FocusManager.TryFocusAsync(webView, FocusState.Programmatic);
    if (!result.Succeeded)
    {
        // Reset focus to the starting position
        this.Focus(FocusState.Programmatic);
    }
}

アラートの使用

WebView でホストされている Web ページが JavaScript Alert 関数を使用している場合、その Web ページは表示されません。これは、WebView のすべてのバージョンの仕様です。

アラートによって表示される情報をインターセプトし、ホストアプリケーションで必要な操作を実行できる場合があります。これが可能かどうかは、ページの書き込み方法と、ページを制御できるかどうかによって異なります。これを行うための 1 つの可能な手法を示すサンプルを使用できます。このサンプルは、Windows 8.1 および Windows Phone 8.1 用に記述されていますが、ユニバーサル Windows プラットフォーム (UWP) を使用するアプリでも機能します。ただし、これはすべてのシナリオで機能しない場合があります。

ユニバーサル Windows アプリの WebView で JavaScript アラートをインターセプトする方法のサンプル

以前のバージョンのメモ

Windows 8.1

次の WebView API は、Windows 8.1では非推奨です。

LoadCompleted と NavigationFailed。代わりに NavigationCompleted を使用してください。
InvokeScript。代わりに InvokeScriptAsync を使用してください。
DataTransferPackage と DataTransferPackageProperty。代わりに CaptureSelectedContentToDataPackageAsync を使用してください。
AllowedScriptNotifyUris、 AnyScriptNotifyUri、および AllowedScriptNotifyUrisProperty。代わりに、アプリマニフェストの ApplicationContentUriRules セクションにページの URI を含めます。

Windows でのみ、 UnsafeContentWarningDisplaying イベントを処理できます。このイベントは、SmartScreen フィルターによって安全ではないと報告されたコンテンツの警告ページが WebView に表示されるときに発生します。ユーザーがナビゲーションの続行を選んだ場合は、そのページへの移動では以降、警告が表示されたり、イベントが発されたりすることはありません。このイベントは、Windows Phoneには実装されていません。

InvokeScriptAsync メソッドを呼び出して WebView 内で JavaScript を呼び出す場合、Alert などのセカンダリウィンドウを必要とする関数はサポートされません。

Windows Phone 8

Windows Phone 8.1 の WebView は、WebView コントロールから親 (FlipView、ScrollViewer クラス、その他の関連するコントロールなど) にジェスチャを伝達する必要がある親コントロールと互換性がありません。
Windows Phone 8.1 の WebView には、ContainsFullScreenElement プロパティと ContainsFullScreenElementChanged イベントが含まれています。これらのメンバーは Windows では使用できません。

UnsafeContentWarningDisplaying イベントは、Windows 10より前のWindows Phoneに対して実装されていません。

Windows 8

これらの解説は、Windows 8.1以降で実行されている場合でも、Windows 8 用にコンパイルされたアプリにのみ適用されます。

Windows 8 では、WebView には、コントロールなどの他の UI 領域を WebView の上にレンダリングできないという特性があります。この "空域の問題" は、ウィンドウ領域の内部的な処理方法、特に入力イベントの処理方法と画面の描画方法が原因です。 HTML コンテンツをレンダリングし、その HTML コンテンツの上に他の UI 要素を配置する場合は、レンダリング領域として WebViewBrush を使用する必要があります。 WebView は引き続き HTML ソース情報を提供し、 SourceName プロパティを使用してその WebView を参照します。 WebViewBrush には、このオーバーレイの制限はありません。

コンテンツが重複する場合がある対話型 WebView (ドロップダウンリストやアプリバーなど) を表示する場合は、必要に応じて WebView コントロールを一時的に非表示にし、 WebViewBrush の塗りつぶしを使用して要素に置き換えることができます。その後、重複するコンテンツが存在しなくなったら、元の WebView をもう一度表示できます。

注意

"空域の問題" は、Windows 8.1 以降修正されており、Windows 8.1またはWindows 10を対象とするアプリには適用されません。

WebView では、常にドキュメントモードでインターネットエクスプローラー 10 が使用されます。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	XYFocusDown
1607	14393	XYFocusLeft
1607	14393	XYFocusRight
1607	14393	XYFocusUp
1803	17134	SeparateProcessLost
1809	17763	WebResourceRequested

コンストラクター

WebView()	WebView クラスの新しいインスタンスを初期化します。
WebView(WebViewExecutionMode)	指定した実行モードで WebView クラスの新しいインスタンスを初期化します。

プロパティ

AccessKey	この要素のアクセスキー (ニーモニック) を取得または設定します。 (継承元 UIElement)
AccessKeyScopeOwner	ソース要素のビジュアルツリーにない場合でも、この要素のアクセスキースコープを提供するソース要素を取得または設定します。 (継承元 UIElement)
ActualHeight	FrameworkElement のレンダリングされた高さを取得します。「解説」を参照してください。 (継承元 FrameworkElement)
ActualOffset	レイアウトプロセスの配置パス中に計算された、親を基準としたこの UIElement の位置を取得します。 (継承元 UIElement)
ActualSize	レイアウトプロセスの配置パス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement)
ActualTheme	要素で現在使用されている UI テーマを取得します。これは RequestedTheme とは異なる場合があります。 (継承元 FrameworkElement)
ActualWidth	FrameworkElement のレンダリングされた幅を取得します。「解説」を参照してください。 (継承元 FrameworkElement)
AllowDrop	この UIElement をドラッグアンドドロップ操作の目的でドロップターゲットにできるかどうかを決定する値を取得または設定します。 (継承元 UIElement)
AllowedScriptNotifyUris	注意 AllowedScriptNotifyUris は、Windows 8.1用にコンパイルされたアプリではサポートされていません。代わりに、アプリマニフェストの ApplicationContentUriRules セクションを更新します。詳細については、「解説」セクションを参照してください。 ScriptNotify イベントをこの WebView に対して実行できる URI のセーフリストを取得または設定します。
AllowedScriptNotifyUrisProperty	注意 AllowedScriptNotifyUrisProperty は、Windows 8.1用にコンパイルされたアプリではサポートされていません。代わりに、アプリマニフェストの ApplicationContentUriRules セクションを更新します。詳細については、「解説」セクションを参照してください。 AllowedScriptNotifyUris 依存関係プロパティを識別します。
AllowFocusOnInteraction	ユーザーが操作するときに要素が自動的にフォーカスを取得するかどうかを示す値を取得または設定します。 (継承元 FrameworkElement)
AllowFocusWhenDisabled	無効なコントロールがフォーカスを受け取ることができるかどうかを取得または設定します。 (継承元 FrameworkElement)
AnyScriptNotifyUri	注意 AnyScriptNotifyUri は、Windows 8.1用にコンパイルされたアプリではサポートされていません。代わりに、アプリマニフェストの ApplicationContentUriRules セクションを更新します。詳細については、「解説」セクションを参照してください。 AllowedScriptNotifyUris プロパティを設定して、任意のページがこの WebView に ScriptNotify イベントを発生できることを示すために使用できる値を取得します。
BaseUri	XAML 読み込み時に XAML で構築されたオブジェクトのベース URI (Uniform Resource Identifier) を表す Uniform Resource Identifier (URI) を取得します。このプロパティは、実行時の URI (Uniform Resource Identifier) 解決に役立ちます。 (継承元 FrameworkElement)
CacheMode	レンダリングされたコンテンツを可能な限り複合ビットマップとしてキャッシュする必要があることを示す値を取得または設定します。 (継承元 UIElement)
CanBeScrollAnchor	UIElement をスクロールアンカーの候補にできるかどうかを示す値を取得または設定します。 (継承元 UIElement)
CanDrag	要素をドラッグアンドドロップ操作でデータとしてドラッグできるかどうかを示す値を取得または設定します。 (継承元 UIElement)
CanGoBack	後方ナビゲーション履歴に少なくとも 1 つのページがあるかどうかを示す値を取得します。
CanGoBackProperty	CanGoBack 依存関係プロパティを識別します。
CanGoForward	前方ナビゲーション履歴に少なくとも 1 つのページがあるかどうかを示す値を取得します。
CanGoForwardProperty	CanGoForward 依存関係プロパティを識別します。
CenterPoint	要素の中心点 (回転またはスケーリングが発生するポイント) を取得または設定します。要素のレンダリング位置に影響します。 (継承元 UIElement)
Clip	UIElement の内容のアウトラインを定義するために使用する RectangleGeometry を取得または設定します。 (継承元 UIElement)
CompositeMode	親レイアウトとウィンドウ内の要素の代替合成モードとブレンドモードを宣言するプロパティを取得または設定します。これは、混合 XAML/Microsoft DirectX UI に関連する要素に関連します。 (継承元 UIElement)
ContainsFullScreenElement	全画面表示をサポートする要素が WebView に含まれているかどうかを示す値を取得します。
ContainsFullScreenElementProperty	ContainsFullScreenElement 依存関係プロパティを識別します。
ContextFlyout	この要素に関連付けられているポップアップを取得または設定します。 (継承元 UIElement)
DataContext	FrameworkElement のデータコンテキストを取得または設定します。データコンテキストの一般的な用途は、 FrameworkElement が {Binding} マークアップ拡張機能を使用し、データバインディングに参加する場合です。 (継承元 FrameworkElement)
DataTransferPackage	注意 DataTransferPackage は、Windows 8.1後にリリースで変更または使用できない場合があります。代わりに、 CaptureSelectedContentToDataPackageAsync を使用します。 WebView に渡されたクリップボード DataPackage を取得します。
DataTransferPackageProperty	注意 DataTransferPackageProperty は、Windows 8.1後にリリースで変更または使用できない場合があります。代わりに、 CaptureSelectedContentToDataPackageAsync を使用します。 DataTransferPackage 依存関係プロパティを識別します。
DefaultBackgroundColor	HTML コンテンツで色が指定されていない場合に WebView の背景として使用する色を取得または設定します。
DefaultBackgroundColorProperty	DefaultBackgroundColor 依存関係プロパティを識別します。
DefaultExecutionMode	現在のアプリの WebView インスタンスの既定のスレッド動作を取得します。
DeferredPermissionRequests	許可または拒否を待機しているアクセス許可要求のコレクションを取得します。
DesiredSize	レイアウトプロセスのメジャーパス中にこの UIElement が計算したサイズを取得します。 (継承元 UIElement)
Dispatcher	このオブジェクトが関連付けられている CoreDispatcher を取得します。 CoreDispatcher は、コードが UI 以外のスレッドによって開始された場合でも、UI スレッド上の DependencyObject にアクセスできる機能を表します。 (継承元 DependencyObject)
DocumentTitle	WebView に現在表示されているページのタイトルを取得します。
DocumentTitleProperty	DocumentTitle 依存関係プロパティを識別します。
ExecutionMode	WebView が UI スレッド上のコンテンツをホストするか、UI 以外のスレッドでホストするかを示す値を取得します。
ExitDisplayModeOnAccessKeyInvoked	アクセスキーが呼び出されたときにアクセスキーの表示を閉じるかどうかを指定する値を取得または設定します。 (継承元 UIElement)
FlowDirection	レイアウトを制御する任意の親要素内でテキストやその他の UI 要素が流れる方向を取得または設定します。このプロパティは、 LeftToRight または RightToLeft のいずれかに設定できます。任意の要素で FlowDirection を RightToLeft に設定すると、配置が右に設定され、読み取り順序が右から左に設定され、コントロールのレイアウトが右から左にフローします。 (継承元 FrameworkElement)
FocusVisualMargin	FrameworkElement のフォーカスビジュアルの外側の余白を取得または設定します。 (継承元 FrameworkElement)
FocusVisualPrimaryBrush	FrameworkElement のまたは `Reveal` フォーカスビジュアルの外側の境界線を`HighVisibility`描画するために使用するブラシを取得または設定します。 (継承元 FrameworkElement)
FocusVisualPrimaryThickness	FrameworkElement のまたはフォーカスビジュアルの外側の境界線の`HighVisibility`太さを取得または`Reveal`設定します。 (継承元 FrameworkElement)
FocusVisualSecondaryBrush	FrameworkElement のまたは `Reveal` フォーカスビジュアルの内側の境界線を`HighVisibility`描画するために使用するブラシを取得または設定します。 (継承元 FrameworkElement)
FocusVisualSecondaryThickness	FrameworkElement のまたはフォーカスビジュアルの内側の境界線の`HighVisibility`太さを取得または`Reveal`設定します。 (継承元 FrameworkElement)
Height	FrameworkElement の推奨される高さを取得または設定します。 (継承元 FrameworkElement)
HighContrastAdjustment	ハイコントラストテーマが有効になっている場合に、フレームワークが要素のビジュアルプロパティを自動的に調整するかどうかを示す値を取得または設定します。 (継承元 UIElement)
HorizontalAlignment	パネルや項目コントロールなど、レイアウトの親で構成されている場合に FrameworkElement に適用される水平方向の配置特性を取得または設定します。 (継承元 FrameworkElement)
IsAccessKeyScope	要素が独自のアクセスキースコープを定義するかどうかを示す値を取得または設定します。 (継承元 UIElement)
IsDoubleTapEnabled	DoubleTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement)
IsHitTestVisible	この UIElement の包含領域がヒットテストの true 値を返すことができるかどうかを取得または設定します。 (継承元 UIElement)
IsHoldingEnabled	Holding イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement)
IsLoaded	要素が要素ツリーに追加され、操作の準備ができているかどうかを示す値を取得します。 (継承元 FrameworkElement)
IsRightTapEnabled	RightTapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement)
IsTapEnabled	Tapped イベントがその要素から発生するかどうかを決定する値を取得または設定します。 (継承元 UIElement)
KeyboardAcceleratorPlacementMode	コントロールのヒントに、関連付けられているキーボードアクセラレータのキーの組み合わせを表示するかどうかを示す値を取得または設定します。 (継承元 UIElement)
KeyboardAcceleratorPlacementTarget	アクセラレータキーの組み合わせを表示するコントロールヒントを示す値を取得または設定します。 (継承元 UIElement)
KeyboardAccelerators	キーボードを使用してアクションを呼び出すキーの組み合わせのコレクションを取得します。アクセラレータは通常、ボタンまたはメニュー項目に割り当てられます。さまざまなメニュー項目のキーボードアクセラレータを示すメニューの例 (継承元 UIElement)
KeyTipHorizontalOffset	UIElement に関連してキーヒントを左右に配置する距離を示す値を取得または設定します。 (継承元 UIElement)
KeyTipPlacementMode	アクセスキーのキーヒントが UIElement の境界に対して配置される場所を示す値を取得または設定します。 (継承元 UIElement)
KeyTipTarget	アクセスキーのキーヒントの対象となる要素を示す値を取得または設定します。 (継承元 UIElement)
KeyTipVerticalOffset	UI 要素に関連してキーヒントを配置する距離を示す値を取得または設定します。 (継承元 UIElement)
Language	FrameworkElement に適用されるローカライズ/グローバリゼーション言語情報と、オブジェクト表現と UI の現在の FrameworkElement のすべての子要素を取得または設定します。 (継承元 FrameworkElement)
Lights	この要素にアタッチされている XamlLight オブジェクトのコレクションを取得します。 (継承元 UIElement)
ManipulationMode	UIElement の動作とジェスチャとの対話に使用される ManipulationModes 値を取得または設定します。この値を設定すると、アプリコードでこの要素から操作イベントを処理できます。 (継承元 UIElement)
Margin	FrameworkElement の外側の余白を取得または設定します。 (継承元 FrameworkElement)
MaxHeight	FrameworkElement の最大高さ制約を取得または設定します。 (継承元 FrameworkElement)
MaxWidth	FrameworkElement の最大幅制約を取得または設定します。 (継承元 FrameworkElement)
MinHeight	FrameworkElement の最小高さ制約を取得または設定します。 (継承元 FrameworkElement)
MinWidth	FrameworkElement の最小幅制約を取得または設定します。 (継承元 FrameworkElement)
Name	オブジェクトの識別名を取得または設定します。 XAML プロセッサが XAML マークアップからオブジェクトツリーを作成する場合、ランタイムコードはこの名前で XAML で宣言されたオブジェクトを参照できます。 (継承元 FrameworkElement)
Opacity	オブジェクトの不透明度の程度を取得または設定します。 (継承元 UIElement)
OpacityTransition	Opacity プロパティへの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement)
Parent	オブジェクトツリー内のこの FrameworkElement の親オブジェクトを取得します。 (継承元 FrameworkElement)
PointerCaptures	Pointer 値として表されるすべてのキャプチャされたポインターのセットを取得します。 (継承元 UIElement)
Projection	この要素をレンダリングするときに適用するパースペクティブプロジェクション (3-D 効果) を取得または設定します。 (継承元 UIElement)
RenderSize	UIElement の最終的なレンダリングサイズを取得します。使用は推奨されません。「解説」を参照してください。 (継承元 UIElement)
RenderTransform	UIElement のレンダリング位置に影響する変換情報を取得または設定します。 (継承元 UIElement)
RenderTransformOrigin	UIElement の境界を基準にして、RenderTransform によって宣言された可能なレンダー変換の原点を取得または設定します。 (継承元 UIElement)
RequestedTheme	リソースを決定するために UIElement (およびその子要素) によって使用される UI テーマを取得または設定します。 RequestedTheme で指定した UI テーマは、アプリレベルの RequestedTheme をオーバーライドできます。 (継承元 FrameworkElement)
Resources	ローカルで定義されたリソースディクショナリを取得します。 XAML では、XAML の暗黙的なコレクション構文を使用して、プロパティ要素の `frameworkElement.Resources` 子オブジェクト要素としてリソース項目を確立できます。 (継承元 FrameworkElement)
Rotation	時計回りの回転角度を度単位で取得または設定します。 RotationAxis と CenterPoint を基準にして回転します。要素のレンダリング位置に影響します。 (継承元 UIElement)
RotationAxis	要素を回転させる軸を取得または設定します。 (継承元 UIElement)
RotationTransition	Rotation プロパティの変更をアニメーション化する ScalarTransition を取得または設定します。 (継承元 UIElement)
Scale	要素のスケールを取得または設定します。要素の CenterPoint を基準にスケールします。要素のレンダリング位置に影響します。 (継承元 UIElement)
ScaleTransition	Scale プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement)
Settings	WebView 機能を有効または無効にするプロパティを含む WebViewSettings オブジェクトを取得します。
Shadow	要素によってキャストされる影の効果を取得または設定します。 (継承元 UIElement)
Source	WebView コントロールに表示する HTML コンテンツの URI (Uniform Resource Identifier) ソースを取得または設定します。
SourceProperty	Source 依存関係プロパティを識別します。
Style	レイアウトとレンダリング中にこのオブジェクトに適用されるインスタンス Style を取得または設定します。 (継承元 FrameworkElement)
TabFocusNavigation	このコントロールのタブと TabIndex の動作方法を変更する値を取得または設定します。 (継承元 UIElement)
Tag	このオブジェクトに関するカスタム情報を格納するために使用できる任意のオブジェクト値を取得または設定します。 (継承元 FrameworkElement)
Transform3D	この要素をレンダリングするときに適用する 3-D 変換効果を取得または設定します。 (継承元 UIElement)
TransformMatrix	要素に適用する変換マトリックスを取得または設定します。 (継承元 UIElement)
Transitions	UIElement に適用される Transition スタイル要素のコレクションを取得または設定します。 (継承元 UIElement)
Translation	要素の x、y、z のレンダリング位置を取得または設定します。 (継承元 UIElement)
TranslationTransition	Translation プロパティの変更をアニメーション化する Vector3Transition を取得または設定します。 (継承元 UIElement)
Triggers	FrameworkElement に対して定義されているアニメーションのトリガーのコレクションを取得します。一般的に使用されません。「解説」を参照してください。 (継承元 FrameworkElement)
UIContext	要素のコンテキスト識別子を取得します。 (継承元 UIElement)
UseLayoutRounding	オブジェクトとそのビジュアルサブツリーのレンダリングで、レンダリングをピクセル全体に合わせた丸め動作を使用するかどうかを決定する値を取得または設定します。 (継承元 UIElement)
VerticalAlignment	パネルや項目コントロールなどの親オブジェクトで構成されている場合に FrameworkElement に適用される垂直方向の配置特性を取得または設定します。 (継承元 FrameworkElement)
Visibility	UIElement の可視性を取得または設定します。表示されない UIElement はレンダリングされず、目的のサイズをレイアウトに伝達しません。 (継承元 UIElement)
Width	FrameworkElement の幅を取得または設定します。 (継承元 FrameworkElement)
XamlRoot	この要素が表示されるを `XamlRoot` 取得または設定します。 (継承元 UIElement)
XYFocusDown	ユーザーが方向パッド (D パッド) を押したときにフォーカスを取得するオブジェクトを取得または設定します。
XYFocusDownNavigationStrategy	ダウンナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement)
XYFocusDownProperty	XYFocusDown 依存関係プロパティを識別します。
XYFocusKeyboardNavigation	キーボード方向矢印を使用してナビゲーションを有効または無効にする値を取得または設定します。 (継承元 UIElement)
XYFocusLeft	ユーザーが方向パッド (D パッド) を左に押したときにフォーカスを取得するオブジェクトを取得または設定します。
XYFocusLeftNavigationStrategy	左側のナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement)
XYFocusLeftProperty	XYFocusLeft 依存関係プロパティを識別します。
XYFocusRight	ユーザーが方向パッド (D パッド) を右に押したときにフォーカスを取得するオブジェクトを取得または設定します。
XYFocusRightNavigationStrategy	右ナビゲーションのターゲット要素を決定するために使用される戦略を指定する値を取得または設定します。 (継承元 UIElement)
XYFocusRightProperty	XYFocusRight 依存関係プロパティを識別します。
XYFocusUp	ユーザーが方向パッド (D パッド) を上に押したときにフォーカスを取得するオブジェクトを取得または設定します。
XYFocusUpNavigationStrategy	アップナビゲーションのターゲット要素を決定するために使用する戦略を指定する値を取得または設定します。 (継承元 UIElement)
XYFocusUpProperty	XYFocusUp 依存関係プロパティを識別します。

メソッド

AddHandler(RoutedEvent, Object, Boolean)	指定したルーティングイベントのルーティングイベントハンドラーを追加します。このハンドラーは、現在の要素のハンドラーコレクションに追加されます。 handledEventsToo をtrue として指定すると、イベントが他の場所で処理される場合でも、指定されたハンドラーを呼び出すことができます。 (継承元 UIElement)
AddWebAllowedObject(String, Object)	ネイティブ Windows ランタイムオブジェクトをグローバルパラメーターとして WebView 内の最上位のドキュメントに追加します。
Arrange(Rect)	子オブジェクトを配置し、 UIElement のサイズを決定します。子要素のカスタムレイアウトを実装する親オブジェクトは、そのレイアウトオーバーライド実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成する必要があります。 (継承元 UIElement)
ArrangeOverride(Size)	レイアウトの "配置" パスの動作を提供します。クラスは、このメソッドをオーバーライドして、独自の "配置" パス動作を定義できます。 (継承元 FrameworkElement)
BuildLocalStreamUri(String, String)	NavigateToLocalStreamUri に渡すことができる URI を作成します。
CancelDirectManipulations()	現在の UIElement を含む ScrollViewer 親に対して、進行中の直接操作処理 (システム定義のパン/ズーム) を取り消します。 (継承元 UIElement)
CapturePointer(Pointer)	ポインターキャプチャを UIElement に設定します。キャプチャされると、キャプチャを持つ要素のみがポインター関連のイベントを発生させます。 (継承元 UIElement)
CapturePreviewToStreamAsync(IRandomAccessStream)	現在の WebView コンテンツのイメージを作成し、指定したストリームに書き込みます。
CaptureSelectedContentToDataPackageAsync()	WebView 内で選択したコンテンツを含む DataPackage を非同期に取得します。
ClearTemporaryWebDataAsync()	WebView のキャッシュデータと IndexedDB データをクリアします。
ClearValue(DependencyProperty)	依存関係プロパティのローカル値をクリアします。 (継承元 DependencyObject)
DeferredPermissionRequestById(UInt32)	指定した ID を持つ遅延アクセス許可要求を返します。
FindName(String)	指定した識別子名を持つオブジェクトを取得します。 (継承元 FrameworkElement)
FindSubElementsForTouchTargeting(Point, Rect)	UIElement サブクラスが、タッチターゲットの解決に役立つ子要素を公開できるようにします。 (継承元 UIElement)
Focus(FocusState)	入力フォーカスを WebView に設定します。
GetAnimationBaseValue(DependencyProperty)	依存関係プロパティに対して確立された基本値を返します。これは、アニメーションがアクティブでない場合に適用されます。 (継承元 DependencyObject)
GetBindingExpression(DependencyProperty)	指定したプロパティのバインドを表す BindingExpression を返します。 (継承元 FrameworkElement)
GetChildrenInTabFocusOrder()	UIElement サブクラスが Tab フォーカスに参加する子要素を公開できるようにします。 (継承元 UIElement)
GetValue(DependencyProperty)	DependencyObject から依存関係プロパティの現在の有効な値を返します。 (継承元 DependencyObject)
GoBack()	WebView をナビゲーション履歴の前のページに移動します。
GoForward()	WebView をナビゲーション履歴の次のページに移動します。
GoToElementStateCore(String, Boolean)	派生クラスで実装すると、コントロールの起動時にすべての状態の XAML を読み込むのではなく、コード内のコントロールテンプレートのビジュアルツリーを状態ごとに構築できます。 (継承元 FrameworkElement)
InvalidateArrange()	UIElement の配置状態 (レイアウト) を無効にします。無効にすると、 UIElement のレイアウトが更新され、非同期的に行われます。 (継承元 UIElement)
InvalidateMeasure()	UIElement の測定状態 (レイアウト) を無効にします。 (継承元 UIElement)
InvalidateViewport()	有効なビューポートの計算に使用される UIElement のビューポート状態を無効にします。 (継承元 FrameworkElement)
InvokeScript(String, String[])	注意 invokeScript は、Windows 8.1後にリリースで変更または使用できない場合があります。代わりに、 InvokeScriptAsync を使用します。特定の引数を使用して、現在読み込まれている HTML から指定されたスクリプト関数を実行します。
InvokeScriptAsync(String, IIterable<String>)	現在読み込まれている HTML から、特定の引数を使用して、指定されたスクリプト関数を非同期アクションとして実行します。
Measure(Size)	UIElement の DesiredSize を更新します。通常、レイアウトの子のカスタムレイアウトを実装するオブジェクトは、独自の MeasureOverride 実装からこのメソッドを呼び出して、再帰的なレイアウト更新を形成します。 (継承元 UIElement)
MeasureOverride(Size)	レイアウトサイクルの "メジャー" パスの動作を提供します。クラスは、このメソッドをオーバーライドして、独自の "Measure" パス動作を定義できます。 (継承元 FrameworkElement)
Navigate(Uri)	指定した Uniform Resource Identifier (URI) で HTML コンテンツを読み込みます。
NavigateToLocalStreamUri(Uri, IUriToStreamResolver)	IUriToStreamResolver を使用して、指定した URI でローカル Web コンテンツを読み込みます。
NavigateToString(String)	指定した HTML コンテンツを新しいドキュメントとして読み込みます。
NavigateWithHttpRequestMessage(HttpRequestMessage)	WEBView を POST 要求と HTTP ヘッダーを含む URI に移動します。
OnApplyTemplate()	アプリケーションコードまたは内部プロセス (再構築レイアウトパスなど) が ApplyTemplate を呼び出すたびに呼び出されます。最も簡単に言うと、これは、UI 要素がアプリに表示される直前にメソッドが呼び出されていることを意味します。クラスの既定のテンプレート後ロジックに影響を与えるために、このメソッドをオーバーライドします。 (継承元 FrameworkElement)
OnBringIntoViewRequested(BringIntoViewRequestedEventArgs)	BringIntoViewRequested イベントが発生する前に呼び出されます。 (継承元 UIElement)
OnCreateAutomationPeer()	派生クラスで実装されると、Microsoft UI オートメーションインフラストラクチャのクラス固有の AutomationPeer 実装が返されます。 (継承元 UIElement)
OnDisconnectVisualChildren()	クラス固有のコンテンツまたは子プロパティから項目が削除されたときにレイアウトとロジックがどのように動作するかを実装するには、このメソッドをオーバーライドします。 (継承元 UIElement)
OnKeyboardAcceleratorInvoked(KeyboardAcceleratorInvokedEventArgs)	アプリでキーボードショートカット (またはアクセラレータ) が処理されるときに呼び出されます。キーボードアクセラレータが呼び出されたときにアプリがどのように応答するかを処理するには、このメソッドをオーバーライドします。 (継承元 UIElement)
OnProcessKeyboardAccelerators(ProcessKeyboardAcceleratorEventArgs)	アプリでキーボードショートカット (またはアクセラレータ) が処理される直前に呼び出されます。アプリケーションコードまたは内部プロセスが ProcessKeyboardAccelerators を呼び出すたびに呼び出されます。このメソッドをオーバーライドして、既定のアクセラレータ処理に影響を与える。 (継承元 UIElement)
PopulatePropertyInfo(String, AnimationPropertyInfo)	アニメーション化できるプロパティを定義します。 (継承元 UIElement)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	派生クラスでオーバーライドされると、アニメーション化できるプロパティを定義します。 (継承元 UIElement)
ReadLocalValue(DependencyProperty)	ローカル値が設定されている場合は、依存関係プロパティのローカル値を返します。 (継承元 DependencyObject)
Refresh()	WebView の現在のコンテンツを再読み込みします。
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	この DependencyObject インスタンスの特定の DependencyProperty に対する変更をリッスンするための通知関数を登録します。 (継承元 DependencyObject)
ReleasePointerCapture(Pointer)	この UIElement によって 1 つの特定のポインターをキャプチャするためのポインターキャプチャを解放します。 (継承元 UIElement)
ReleasePointerCaptures()	この要素によって保持されているすべてのポインターキャプチャを解放します。 (継承元 UIElement)
RemoveHandler(RoutedEvent, Object)	指定したルーティングイベントハンドラーをこの UIElement から削除します。通常、問題のハンドラーは AddHandler によって追加されました。 (継承元 UIElement)
SetBinding(DependencyProperty, BindingBase)	指定されたバインドオブジェクトを使用して、 FrameworkElement にバインドをアタッチします。 (継承元 FrameworkElement)
SetValue(DependencyProperty, Object)	DependencyObject の依存関係プロパティのローカル値を設定します。 (継承元 DependencyObject)
StartAnimation(ICompositionAnimationBase)	要素で指定したアニメーションを開始します。 (継承元 UIElement)
StartBringIntoView()	XAML フレームワークへの要求を開始して、その中に含まれているスクロール可能な領域内で要素を表示します。 (継承元 UIElement)
StartBringIntoView(BringIntoViewOptions)	指定したオプションを使用して、要素をビューに取り込むための要求を XAML フレームワークに開始します。 (継承元 UIElement)
StartDragAsync(PointerPoint)	ドラッグアンドドロップ操作を開始します。 (継承元 UIElement)
Stop()	現在の WebView ナビゲーションまたはダウンロードを停止します。
StopAnimation(ICompositionAnimationBase)	要素の指定したアニメーションを停止します。 (継承元 UIElement)
TransformToVisual(UIElement)	UIElement から指定したオブジェクトに座標を変換するために使用できる変換オブジェクトを返します。 (継承元 UIElement)
TryInvokeKeyboardAccelerator(ProcessKeyboardAcceleratorEventArgs)	UIElement のビジュアルツリー全体でショートカットを検索して、キーボードショートカット (またはアクセラレータ) を呼び出そうとします。 (継承元 UIElement)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	RegisterPropertyChangedCallback を呼び出して以前に登録した変更通知を取り消します。 (継承元 DependencyObject)
UpdateLayout()	UIElement の子オブジェクトのすべての位置が、レイアウト用に適切に更新されるようにします。 (継承元 UIElement)

イベント

AccessKeyDisplayDismissed	アクセスキーが表示されなくなったときに発生します。 (継承元 UIElement)
AccessKeyDisplayRequested	ユーザーがアクセスキーの表示を要求したときに発生します。 (継承元 UIElement)
AccessKeyInvoked	ユーザーがアクセスキーシーケンスを完了したときに発生します。 (継承元 UIElement)
ActualThemeChanged	ActualTheme プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement)
BringIntoViewRequested	この要素またはその子孫のいずれかで StartBringIntoView が呼び出されたときに発生します。 (継承元 UIElement)
CharacterReceived	1 つの構成済み文字が入力キューによって受信されたときに発生します。 (継承元 UIElement)
ContainsFullScreenElementChanged	WebView に現在全画面表示要素が含まれているかどうかの状態が変更されたときに発生します。
ContentLoading	WebView が新しいコンテンツの読み込みを開始したときに発生します。
ContextCanceled	コンテキスト入力ジェスチャが操作ジェスチャに続き、コンテキストポップアップを開くべきではないことを要素に通知するときに発生します。 (継承元 UIElement)
ContextRequested	ユーザーが右クリックなどのコンテキスト入力ジェスチャを完了したときに発生します。 (継承元 UIElement)
DataContextChanged	FrameworkElement.DataContext プロパティの値が変更されたときに発生します。 (継承元 FrameworkElement)
DOMContentLoaded	WebView が現在の HTML コンテンツの解析を完了したときに発生します。
DoubleTapped	この要素のヒットテスト領域で、それ以外の方法でハンドルされない DoubleTap 相互作用が発生したときに発生します。 (継承元 UIElement)
DragEnter	入力システムが、この要素をターゲットとして使用して基になるドラッグイベントを報告するときに発生します。 (継承元 UIElement)
DragLeave	入力システムが、この要素を原点として基になるドラッグイベントを報告するときに発生します。 (継承元 UIElement)
DragOver	この要素がドロップ先となる可能性のある、基になるドラッグイベントを入力システムが報告したときに発生します。 (継承元 UIElement)
DragStarting	ドラッグ操作が開始されたときに発生します。 (継承元 UIElement)
Drop	入力システムがこの要素をドロップ先とするドロップイベントを報告したときに発生します。 (継承元 UIElement)
DropCompleted	ソースとしてこの要素を使用したドラッグアンドドロップ操作が終了したときに発生します。 (継承元 UIElement)
EffectiveViewportChanged	FrameworkElement の有効なビューポートが変更されたときに発生します。 (継承元 FrameworkElement)
FrameContentLoading	WebView 内のフレームが新しいコンテンツの読み込みを開始したときに発生します。
FrameDOMContentLoaded	WebView 内のフレームが現在の HTML コンテンツの解析を完了したときに発生します。
FrameNavigationCompleted	WebView 内のフレームがコンテンツの読み込みを完了したときに発生します。
FrameNavigationStarting	WebView 内のフレームが新しいコンテンツに移動する前に発生します。
GettingFocus	UIElement がフォーカスを受け取る前に発生します。このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement)
GotFocus	UIElement がフォーカスを受け取ったときに発生します。このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement)
Holding	この要素のヒットテスト領域で、それ以外の場合はハンドルされない保留操作が発生したときに発生します。 (継承元 UIElement)
KeyDown	UIElement にフォーカスがあるときにキーボードキーが押されたときに発生します。 (継承元 UIElement)
KeyUp	UIElement にフォーカスがあるときにキーボードキーが解放されたときに発生します。 (継承元 UIElement)
LayoutUpdated	レイアウト関連のプロパティが値を変更したり、レイアウトを更新するその他のアクションが原因で、ビジュアルツリーのレイアウトが変更されたときに発生します。 (継承元 FrameworkElement)
LoadCompleted	注意 LoadCompleted は、Windows 8.1後にリリースで変更または使用できない場合があります。代わりに、 NavigationCompleted を使用します。最上位のナビゲーションが完了し、コンテンツが WebView コントロールに読み込まれるか、読み込み中にエラーが発生したときに発生します。
Loaded	FrameworkElement が構築され、オブジェクトツリーに追加され、操作の準備ができたときに発生します。 (継承元 FrameworkElement)
Loading	FrameworkElement の読み込みが開始されたときに発生します。 (継承元 FrameworkElement)
LongRunningScriptDetected	WebView で JavaScript が実行されている間に定期的に発生し、スクリプトを停止できます。
LosingFocus	UIElement がフォーカスを失う前に発生します。このイベントは、イベントがバブルしている間にフォーカスが移動されないように同期的に発生します。 (継承元 UIElement)
LostFocus	UIElement がフォーカスを失ったときに発生します。このイベントは非同期的に発生するため、バブルが完了する前にフォーカスを再び移動できます。 (継承元 UIElement)
ManipulationCompleted	UIElement の操作が完了したときに発生します。 (継承元 UIElement)
ManipulationDelta	操作中に入力デバイスが位置を変更したときに発生します。 (継承元 UIElement)
ManipulationInertiaStarting	操作中に入力デバイスが UIElement オブジェクトとのコンタクトを失ったときと慣性が開始したときに発生します。 (継承元 UIElement)
ManipulationStarted	入力デバイスが UIElement に対する操作を開始すると発生します。 (継承元 UIElement)
ManipulationStarting	操作プロセッサを初めて作成するときに発生します。 (継承元 UIElement)
NavigationCompleted	WebView が現在のコンテンツの読み込みを完了したとき、またはナビゲーションが失敗した場合に発生します。
NavigationFailed	注意 NavigationFailed は、Windows 8.1後にリリースで変更または使用できない場合があります。代わりに、 NavigationCompleted を使用します。 WebView がナビゲーションの試行を完了できない場合に発生します。
NavigationStarting	WebView が新しいコンテンツに移動する前に発生します。
NewWindowRequested	ユーザーが WebView で新しいウィンドウでコンテンツを開くアクションを実行したときに発生します。
NoFocusCandidateFound	ユーザーが (タブまたは方向矢印を使用して) フォーカスを移動しようとしたときに、フォーカス候補が移動方向に見つからないため、フォーカスが移動しない場合に発生します。 (継承元 UIElement)
PermissionRequested	WebView のアクションでアクセス許可を付与する必要がある場合に発生します。
PointerCanceled	接触したポインターが異常に接触を失ったときに発生します。 (継承元 UIElement)
PointerCaptureLost	この要素によって以前に保持されていたポインターキャプチャが別の要素または別の場所に移動したときに発生します。 (継承元 UIElement)
PointerEntered	ポインターがこの要素のヒットテスト領域に入ったときに発生します。 (継承元 UIElement)
PointerExited	ポインターがこの要素のヒットテスト領域から離れると発生します。 (継承元 UIElement)
PointerMoved	ポインターがこの要素のヒットテスト領域内に残っている間にポインターが移動したときに発生します。 (継承元 UIElement)
PointerPressed	ポインターデバイスがこの要素内で Press アクションを開始したときに発生します。 (継承元 UIElement)
PointerReleased	この要素内で、以前に Press アクションを開始したポインターデバイスが解放されたときに発生します。 Press アクションの終了が PointerReleased イベントを発生させる保証はされないことに注意してください。他のイベントが発生する可能性があります。詳細については、「解説」を参照してください。 (継承元 UIElement)
PointerWheelChanged	ポインターホイールのデルタ値が変更されたときに発生します。 (継承元 UIElement)
PreviewKeyDown	UIElement にフォーカスがあるときにキーボードキーが押されたときに発生します。 (継承元 UIElement)
PreviewKeyUp	UIElement にフォーカスがあるときにキーボードキーが解放されたときに発生します。 (継承元 UIElement)
ProcessKeyboardAccelerators	キーボードショートカット (またはアクセラレータ) が押されたときに発生します。 (継承元 UIElement)
RightTapped	ポインターが要素の上にある間に右タップ入力刺激が発生したときに発生します。 (継承元 UIElement)
ScriptNotify	WebView コントロールに含まれるコンテンツが、JavaScript を使用してアプリケーションに文字列を渡したときに発生します。
SeparateProcessLost	WebView が SeparateProcess の ExecutionMode で実行され、個別のプロセスが失われた場合に発生します。
SizeChanged	ActualHeight または ActualWidth プロパティが FrameworkElement の値を変更したときに発生します。 (継承元 FrameworkElement)
Tapped	この要素のヒットテスト領域で、それ以外の場合はハンドルされない Tap 操作が発生したときに発生します。 (継承元 UIElement)
Unloaded	このオブジェクトがメインオブジェクトツリーに接続されなくなったときに発生します。 (継承元 FrameworkElement)
UnsafeContentWarningDisplaying	SmartScreen フィルターによって安全でないと報告されたコンテンツの警告ページが WebView に表示されたときに発生します。
UnsupportedUriSchemeIdentified	WebView でサポートされていないスキームを使用して Uniform Resource Identifier (URI) に移動しようとした場合に発生します。
UnviewableContentIdentified	WebView がサポートされていないファイルのダウンロードを試みたときに発生します。
WebResourceRequested	HTTP 要求が行われたときに発生します。

適用対象

次の方法で共有

WebView クラス

定義

Windows の要件

例

注釈

コンテンツに移動する

ナビゲーションイベントを処理する

潜在的な問題に対処する

WebView コンテンツの特殊なケースの処理

WebView コンテンツの操作

WebView でWindows ランタイムにアクセスする

Web コンテンツのホスティングのオプション

WebView コンテンツのキャプチャ

実行モード

別のプロセスでの WebView のフォーカス動作

アラートの使用

以前のバージョンのメモ

Windows 8.1

Windows Phone 8

Windows 8

バージョン履歴

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

フィードバック

その他のリソース

次の方法で共有

WebView クラス

定義

Windows の要件

例

注釈

コンテンツに移動する

ナビゲーション イベントを処理する

潜在的な問題に対処する

WebView コンテンツの特殊なケースの処理

WebView コンテンツの操作

WebView でWindows ランタイムにアクセスする

Web コンテンツのホスティングのオプション

WebView コンテンツのキャプチャ

実行モード

別のプロセスでの WebView のフォーカス動作

アラートの使用

以前のバージョンのメモ

Windows 8.1

Windows Phone 8

Windows 8

バージョン履歴

コンストラクター

プロパティ

メソッド

イベント

適用対象

こちらもご覧ください

フィードバック

その他のリソース

ナビゲーションイベントを処理する