情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

WebView Class

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

継承

Object
  DependencyObject
    UIElement
      FrameworkElement
        WebView

構文


public sealed class WebView : FrameworkElement

属性

[MarshalingBehavior(Agile)]
[Threading(Both)]
[Version(0x06020000)]
[WebHostHidden()]

メンバー

WebViewクラス には次の種類のメンバーがあります。

コンストラクター

WebViewクラス にはこれらのコンストラクターがあります。

コンストラクター説明
WebView Initializes a new instance of the WebView class.

 

イベント

WebViewクラス にはこれらのイベントがあります。

イベント説明
ContentLoading Occurs when the WebView has started loading new content.
DataContextChanged Occurs when the value of the FrameworkElement.DataContext property changes. (継承元 FrameworkElement)
DOMContentLoaded Occurs when the WebView has finished parsing the current HTML content.
DoubleTapped (not supported; see Remarks) Occurs when an otherwise unhandled DoubleTap interaction occurs over the hit test area of this element. (継承元 UIElement)
DragEnter (not supported; see Remarks) Occurs when the input system reports an underlying drag event with this element as the target. (継承元 UIElement)
DragLeave (not supported; see Remarks) Occurs when the input system reports an underlying drag event with this element as the origin. (継承元 UIElement)
DragOver (not supported; see Remarks) Occurs when the input system reports an underlying drag event with this element as the potential drop target. (継承元 UIElement)
Drop (not supported; see Remarks) Occurs when the input system reports an underlying drop event with this element as the drop target. (継承元 UIElement)
FrameContentLoading Occurs when a frame in the WebView has started loading new content.
FrameDOMContentLoaded Occurs when a frame in the WebView has finished parsing its current HTML content.
FrameNavigationCompleted Occurs when a frame in the WebView has finished loading its content.
FrameNavigationStarting Occurs before a frame in the WebView navigates to new content.
GotFocus Occurs when a UIElement receives focus. (継承元 UIElement)
Holding (not supported; see Remarks) Occurs when an otherwise unhandled Hold interaction occurs over the hit test area of this element. (継承元 UIElement)
KeyDown (not supported; see Remarks) Occurs when a keyboard key is pressed while the UIElement has focus. (継承元 UIElement)
KeyUp (not supported; see Remarks) Occurs when a keyboard key is released while the UIElement has focus. (継承元 UIElement)
LayoutUpdated Occurs when the layout of the visual tree changes, due to layout-relevant properties changing value or some other action that refreshes the layout. (継承元 FrameworkElement)
LoadCompleted Occurs when top-level navigation completes and the content loads into the WebView control or when an error occurs during loading.
Loaded Occurs when a FrameworkElement has been constructed and added to the object tree, and is ready for interaction. (継承元 FrameworkElement)
LongRunningScriptDetected Occurs periodically while the WebView executes JavaScript, letting you halt the script.
LostFocus Occurs when a UIElement loses focus. (継承元 UIElement)
ManipulationCompleted (not supported; see Remarks) Occurs when a manipulation on the UIElement is complete. (継承元 UIElement)
ManipulationDelta (not supported; see Remarks) Occurs when the input device changes position during a manipulation. (継承元 UIElement)
ManipulationInertiaStarting (not supported; see Remarks) Occurs when the input device loses contact with the UIElement object during a manipulation and inertia begins. (継承元 UIElement)
ManipulationStarted (not supported; see Remarks) Occurs when an input device begins a manipulation on the UIElement. (継承元 UIElement)
ManipulationStarting (not supported; see Remarks) Occurs when the manipulation processor is first created. (継承元 UIElement)
NavigationCompleted Occurs when the WebView has finished loading the current content or if navigation has failed.
NavigationFailed Occurs when the WebView cannot complete the navigation attempt.
NavigationStarting Occurs before the WebView navigates to new content.
PointerCanceled (not supported; see Remarks) Occurs when a pointer that made contact abnormally loses contact. (継承元 UIElement)
PointerCaptureLost (not supported; see Remarks) Occurs when pointer capture previously held by this element moves to another element or elsewhere. (継承元 UIElement)
PointerEntered (not supported; see Remarks) Occurs when a pointer enters the hit test area of this element. (継承元 UIElement)
PointerExited (not supported; see Remarks) Occurs when a pointer leaves the hit test area of this element. (継承元 UIElement)
PointerMoved (not supported; see Remarks) Occurs when a pointer moves while the pointer remains within the hit test area of this element. (継承元 UIElement)
PointerPressed (not supported; see Remarks) Occurs when the pointer device initiates a Press action within this element. (継承元 UIElement)
PointerReleased (not supported; see Remarks) Occurs when the pointer device that previously initiated a Press action is released, while within this element. (継承元 UIElement)
PointerWheelChanged (not supported; see Remarks) Occurs when the delta value of a pointer wheel changes. (継承元 UIElement)
RightTapped (not supported; see Remarks) Occurs when a right-tap input stimulus happens while the pointer is over the element. (継承元 UIElement)
ScriptNotify Occurs when the content contained in the WebView control passes a string to the application by using JavaScript.
SizeChanged Occurs when either the ActualHeight or the ActualWidth property changes value on a FrameworkElement. (継承元 FrameworkElement)
Tapped (not supported; see Remarks) Occurs when an otherwise unhandled Tap interaction occurs over the hit test area of this element. (継承元 UIElement)
Unloaded Occurs when this object is no longer connected to the main object tree. (継承元 FrameworkElement)
UnsafeContentWarningDisplaying Occurs when the WebView shows a warning page for content that was reported as unsafe by SmartScreen Filter.
UnviewableContentIdentified Occurs when the WebView attempts to download an unsupported file.

 

メソッド

The WebView クラス には次のメソッドがあります。 また、以下からもメソッドが継承されます。Object クラス.

メソッド説明
AddHandler Adds a routed event handler for a specified routed event, adding the handler to the handler collection on the current element. Specify handledEventsToo as true to have the provided handler be invoked even if the event is handled elsewhere. (継承元 UIElement)
Arrange Positions child objects and determines a size for a UIElement. Parent objects that implement custom layout for their child elements should call this method from their layout override implementations to form a recursive layout update. (継承元 UIElement)
ArrangeOverride Provides the behavior for the Arrange pass of layout. Classes can override this method to define their own Arrange pass behavior. (継承元 FrameworkElement)
BuildLocalStreamUri Creates a URI that you can pass to NavigateToLocalStreamUri.
CancelDirectManipulations Cancels ongoing direct manipulation processing (system-defined panning/zooming) on any ScrollViewer parent that contains the current UIElement. (継承元 UIElement)
CapturePointer Sets pointer capture to a UIElement. Once captured, only the element that has capture will fire pointer-related events. (継承元 UIElement)
CapturePreviewToStreamAsync Creates an image of the current WebView contents and writes it to the specified stream.
CaptureSelectedContentToDataPackageAsync Asynchronously gets a DataPackage that contains the selected content within the WebView.
ClearValue Clears the local value of a dependency property. (継承元 DependencyObject)
FindName Retrieves an object that has the specified identifier name. (継承元 FrameworkElement)
FindSubElementsForTouchTargeting Enables a UIElement subclass to expose child elements that assist with resolving touch targeting. (継承元 UIElement)
Focus Sets the input focus to the WebView.
GetAnimationBaseValue Returns any base value established for a dependency property, which would apply in cases where an animation is not active. (継承元 DependencyObject)
GetBindingExpression Returns the BindingExpression that represents the binding on the specified property. (継承元 FrameworkElement)
GetValue Returns the current effective value of a dependency property from a DependencyObject. (継承元 DependencyObject)
GoBack Navigates the WebView to the previous page in the navigation history.
GoForward Navigates the WebView to the next page in the navigation history.
GoToElementStateCore When implemented in a derived class, enables per-state construction of a visual tree for a control template in code, rather than by loading XAML for all states at control startup. (継承元 FrameworkElement)
InvalidateArrange Invalidates the arrange state (layout) for a UIElement. After the invalidation, the UIElement will have its layout updated, which will occur asynchronously. (継承元 UIElement)
InvalidateMeasure Invalidates the measurement state (layout) for a UIElement. (継承元 UIElement)
InvokeScript Executes the specified script function from the currently loaded HTML, with specific arguments.
InvokeScriptAsync As an asynchronous action, executes the specified script function from the currently loaded HTML, with specific arguments.
Measure Updates the DesiredSize of a UIElement. Typically, objects that implement custom layout for their layout children call this method from their own MeasureOverride implementations to form a recursive layout update. (継承元 UIElement)
MeasureOverride Provides the behavior for the Measure pass of the layout cycle. Classes can override this method to define their own Measure pass behavior. (継承元 FrameworkElement)
Navigate Loads the HTML content at the specified Uniform Resource Identifier (URI).
NavigateToLocalStreamUri Loads local web content at the specified URI using an IUriToStreamResolver.
NavigateToString Loads the specified HTML content as a new document.
NavigateWithHttpRequestMessage Navigates the WebView to a URI with a POST request and HTTP headers.
OnApplyTemplate Invoked whenever application code or internal processes (such as a rebuilding layout pass) call ApplyTemplate. In simplest terms, this means the method is called just before a UI element displays in your app. Override this method to influence the default post-template logic of a class. (継承元 FrameworkElement)
OnCreateAutomationPeer When implemented in a derived class, returns class-specific AutomationPeer implementations for the Microsoft UI Automation infrastructure. (継承元 UIElement)
OnDisconnectVisualChildren Override this method to implement how layout and logic should behave when items are removed from a class-specific content or children property. (継承元 UIElement)
ReadLocalValue Returns the local value of a dependency property, if a local value is set. (継承元 DependencyObject)
Refresh Reloads the current content in the WebView.
ReleasePointerCapture Releases pointer captures for capture of one specific pointer by this UIElement. (継承元 UIElement)
ReleasePointerCaptures Releases all pointer captures held by this element. (継承元 UIElement)
RemoveHandler Removes the specified routed event handler from this UIElement. Typically the handler in question was added by AddHandler. (継承元 UIElement)
SetBinding Attaches a binding to a FrameworkElement, using the provided binding object. (継承元 FrameworkElement)
SetValue Sets the local value of a dependency property on a DependencyObject. (継承元 DependencyObject)
Stop Halts the current WebView navigation or download.
TransformToVisual Returns a transform object that can be used to transform coordinates from the UIElement to the specified object. (継承元 UIElement)
UpdateLayout Ensures that all positions of child objects of a UIElement are properly updated for layout. (継承元 UIElement)

 

プロパティ

WebViewクラス には次のプロパティがあります。

プロパティアクセスの種類説明

ActualHeight

読み取り専用Gets the rendered height of a FrameworkElement. (継承元 FrameworkElement)

ActualWidth

読み取り専用Gets the rendered width of a FrameworkElement. (継承元 FrameworkElement)

AllowDrop

読み取り/書き込みGets or sets a value that determines whether this UIElement can be a drop target for purposes of drag-and-drop operations. (継承元 UIElement)

AllowedScriptNotifyUris

読み取り/書き込みGets or sets a safe list of URIs that are permitted to fire ScriptNotify events to this WebView.

AllowedScriptNotifyUrisProperty

読み取り専用Identifies the AllowedScriptNotifyUris dependency property.

AnyScriptNotifyUri

読み取り専用Gets a value that you can use to set the AllowedScriptNotifyUris property to indicate that any page can fire ScriptNotify events to this WebView.

BaseUri

読み取り専用Gets a Uniform Resource Identifier (URI) that represents the base Uniform Resource Identifier (URI) for an XAML-constructed object at XAML load time. This property is useful for Uniform Resource Identifier (URI) resolution at run time. (継承元 FrameworkElement)

CacheMode

読み取り/書き込みGets or sets a value that indicates that rendered content should be cached as a composited bitmap when possible. (継承元 UIElement)

CanGoBack

読み取り専用Gets a value that indicates whether there is at least one page in the backward navigation history.

CanGoBackProperty

読み取り専用Identifies the CanGoBack dependency property.

CanGoForward

読み取り専用Gets a value that indicates whether there is at least one page in the forward navigation history.

CanGoForwardProperty

読み取り専用Identifies the CanGoForward dependency property.

Clip

読み取り/書き込みGets or sets the RectangleGeometry used to define the outline of the contents of a UIElement. (継承元 UIElement)

CompositeMode

読み取り/書き込みGets or sets a property that declares alternate composition and blending modes for the element in its parent layout and window. This is relevant for elements that are involved in a mixed XAML / Microsoft DirectX UI. (継承元 UIElement)

DataContext

読み取り/書き込みGets or sets the data context for a FrameworkElement when it participates in data binding. (継承元 FrameworkElement)

DataTransferPackage

読み取り専用Gets a clipboard DataPackage as passed to the WebView.

DataTransferPackageProperty

読み取り専用Identifies the DataTransferPackage dependency property.

DefaultBackgroundColor

読み取り/書き込みGets or sets the color to use as the WebView background when the HTML content does not specify a color.

DefaultBackgroundColorProperty

読み取り専用Identifies the DefaultBackgroundColor dependency property.

DesiredSize

読み取り専用Gets the size that this UIElement computed during the measure pass of the layout process. (継承元 UIElement)

Dispatcher

読み取り専用Gets the CoreDispatcher that this object is associated with. (継承元 DependencyObject)

DocumentTitle

読み取り専用Gets the title of the page currently displayed in the WebView.

DocumentTitleProperty

読み取り専用Identifies the DocumentTitle dependency property.

FlowDirection

読み取り/書き込みGets or sets the direction in which text and other UI elements flow within any parent element that controls their layout. This property can be set to either LeftToRight or RightToLeft. Setting FlowDirection to RightToLeft on any element sets the alignment to the right, the reading order to right-to-left and the layout of the control to flow from right to left. (継承元 FrameworkElement)

Height

読み取り/書き込みGets or sets the suggested height of a FrameworkElement. (継承元 FrameworkElement)

HorizontalAlignment

読み取り/書き込みGets or sets the horizontal alignment characteristics that are applied to a FrameworkElement when it is composed in a layout parent, such as a panel or items control. (継承元 FrameworkElement)

IsDoubleTapEnabled

読み取り/書き込みGets or sets a value that determines whether the DoubleTapped event can originate from that element. (継承元 UIElement)

IsHitTestVisible

読み取り/書き込みGets or sets whether the contained area of this UIElement can return true values for hit testing. (継承元 UIElement)

IsHoldingEnabled

読み取り/書き込みGets or sets a value that determines whether the Holding event can originate from that element. (継承元 UIElement)

IsRightTapEnabled

読み取り/書き込みGets or sets a value that determines whether the RightTapped event can originate from that element. (継承元 UIElement)

IsTapEnabled

読み取り/書き込みGets or sets a value that determines whether the Tapped event can originate from that element. (継承元 UIElement)

Language

読み取り/書き込みGets or sets localization/globalization language information that applies to a FrameworkElement, and also to all child elements of the current FrameworkElement in the object representation and in UI. (継承元 FrameworkElement)

ManipulationMode

読み取り/書き込みGets or sets the ManipulationModes value used for UIElement behavior and interaction with gestures. Setting this value enables handling the manipulation events from this element in app code. (継承元 UIElement)

Margin

読み取り/書き込みGets or sets the outer margin of a FrameworkElement. (継承元 FrameworkElement)

MaxHeight

読み取り/書き込みGets or sets the maximum height constraint of a FrameworkElement. (継承元 FrameworkElement)

MaxWidth

読み取り/書き込みGets or sets the maximum width constraint of a FrameworkElement. (継承元 FrameworkElement)

MinHeight

読み取り/書き込みGets or sets the minimum height constraint of a FrameworkElement. (継承元 FrameworkElement)

MinWidth

読み取り/書き込みGets or sets the minimum width constraint of a FrameworkElement. (継承元 FrameworkElement)

Name

読み取り/書き込みGets or sets the identifying name of the object. When a XAML processor creates the object tree from XAML markup, run-time code can refer to the XAML-declared object by this name. (継承元 FrameworkElement)

Opacity

読み取り/書き込みGets or sets the degree of the object's opacity. (継承元 UIElement)

Parent

読み取り専用Gets the parent object of this FrameworkElement in the object tree. (継承元 FrameworkElement)

PointerCaptures

読み取り専用Gets the set of all captured pointers, represented as Pointer values. (継承元 UIElement)

Projection

読み取り/書き込みGets or sets the perspective projection (3-D effect) to apply when rendering this element. (継承元 UIElement)

RenderSize

読み取り専用Gets the final render size of a UIElement. (継承元 UIElement)

RenderTransform

読み取り/書き込みGets or sets transform information that affects the rendering position of a UIElement. (継承元 UIElement)

RenderTransformOrigin

読み取り/書き込みGets or sets the origin point of any possible render transform declared by RenderTransform, relative to the bounds of the UIElement. (継承元 UIElement)

RequestedTheme

読み取り/書き込みGets or sets the UI theme that is used by the UIElement (and its child elements) for resource determination. The UI theme you specify with RequestedTheme can override the app-level RequestedTheme. (継承元 FrameworkElement)

Resources

読み取り/書き込みGets the locally defined resource dictionary. In XAML, you can establish resource items as child object elements of a frameworkElement.Resources property element, through XAML implicit collection syntax. (継承元 FrameworkElement)

Source

読み取り/書き込みGets or sets the Uniform Resource Identifier (URI) source of the HTML content to display in the WebView control.

SourceProperty

読み取り専用Identifies the Source dependency property.

Style

読み取り/書き込みGets or sets an instance Style that is applied for this object during layout and rendering. (継承元 FrameworkElement)

Tag

読み取り/書き込みGets or sets an arbitrary object value that can be used to store custom information about this object. (継承元 FrameworkElement)

Transitions

読み取り/書き込みGets or sets the collection of Transition style elements that apply to a UIElement. (継承元 UIElement)

Triggers

読み取り専用Gets the collection of triggers for animations that are defined for a FrameworkElement. Not commonly used. (継承元 FrameworkElement)

UseLayoutRounding

読み取り/書き込みGets or sets a value that determines whether rendering for the object and its visual subtree should use rounding behavior that aligns rendering to whole pixels. (継承元 UIElement)

VerticalAlignment

読み取り/書き込みGets or sets the vertical alignment characteristics that are applied to a FrameworkElement when it is composed in a parent object such as a panel or items control. (継承元 FrameworkElement)

Visibility

読み取り/書き込みGets or sets the visibility of a UIElement. A UIElement that is not visible is not rendered and does not communicate its desired size to layout. (継承元 UIElement)

Width

読み取り/書き込みGets or sets the width of a FrameworkElement. (継承元 FrameworkElement)

 

解説

WebView コントロールを使用して、アプリで Web コンテンツをホストします。コントロールの動作は Windows 8.1 から変更されたことに注意してください。詳細については、後述の説明を参照してください。

WebView は、Control サブクラスではないため、コントロール テンプレートはありません。表示領域は Width プロパティと Height プロパティによって制限されます。

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

イベントの表に示されているように、WebView では、UIElement から派生したユーザー入力イベント (KeyDownKeyUpPointerPressed など) の多くがサポートされません。 この問題を回避する標準的な方法には、WebView.InvokeScript (Windows 8.1 以降では InvokeScriptAsync) と eval を組み合わせて HTML イベント ハンドラーを使用する方法や、HTML イベント ハンドラーの window.external.notify で、WebView.ScriptNotify を使用するアプリケーションに通知する方法があります。

また、WebView では、AppCache、IndexedDB、プログラムによるクリップボードへのアクセス、地理的な場所などの一部の HTML5 機能は現在サポートされていません。

Windows 8

これらのコメントは、Windows 8.1 で実行中の場合であっても、Windows 8 用にコンパイルされたアプリにのみ適用されます。

WebView には、コントロールなどのその他の UI 領域を WebView の上に表示できないという特性があります。この "空域の問題" は、 ウィンドウ領域が内部的に処理された方法、特に、入力イベントの処理方法および画面の描画方法に起因します。また、HTML コンテンツを表示し、その HTML コンテンツの先頭に他の UI 要素も設定する場合は、表示領域として WebViewBrush を使用する必要があります。WebView は HTML ソース情報を提供します。ユーザーは、SourceName プロパティを使用してその「WebView」を参照します。WebViewBrush には、このオーバーレイの制限はありません。

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

メモ  "空域の問題" は、Windows 8.1 から解決されています。

WebView は常に、ドキュメント モードで Internet Explorer 10 を使用します。

WebView は、ms-appdata スキームをサポートしませんが、アプリ パッケージからのコンテンツ ファイルの読み込みに使用できる ms-appx-web スキームはサポートします。



<WebView Source="ms-appx-web:///HTMLPage1.html"/>


Windows 8.1

Windows 8.1 では、いくつかの問題を解決し、新しい機能を追加するために、WebView コントロールに対して次のような変更を導入しました。

  • WebView コントロール上への XAML コンテンツ (AppBar など) の表示のサポート。XAML コンテンツをオーバーレイしたい場合に、WebViewBrush を使用し WebView のコンテンツ描画を必要とする Windows 8 の「空域問題」を解決します。
  • WebView コントロールの平行移動、拡大縮小、傾斜、および回転に RenderTransform を使用するためのサポート。
  • WebView コントロールで Opacity プロパティを使用するためのサポート。
  • 基本的なナビゲーションのための新しい API: GoBackGoForwardStopRefreshCanGoBackCanGoForward。これらの要素を使用して、一般的な Web 閲覧機能をアプリケーションに追加することもできます。
  • POST 要求と HTTP ヘッダーを使用して URI に移動するための NavigateWithHttpRequestMessage メソッド。
  • カスタム リゾルバーによってローカル コンテンツを読み込む NavigateToLocalStreamUri メソッド。オフラインで使用するために Web ベースのコンテンツをダウンロードおよびキャッシュするなどの、高度なシナリオを可能にします。
  • ナビゲーションおよびコンテンツの読み込みの状態に応答する新しいイベント: NavigationStartingContentLoadingDOMContentLoadedNavigationCompletedFrameNavigationStartingFrameContentLoadingFrameDOMContentLoadedFrameNavigationCompleted
  • 問題が発生している可能性のある状態に応答する新しいイベント: LongRunningScriptDetectedUnsafeContentWarningDisplayingUnviewableContentIdentified
  • WebView に入力フォーカスを設定する Focus メソッド。
  • ホストされたコンテンツのプレビュー イメージを取得する CapturePreviewToStreamAsync メソッド。
  • スクリプトを起動するためと、共有対象のデータ パッケージとして選択されたコンテンツを取得するための同期メソッド (InvokeScriptAsyncCaptureSelectedContentToDataPackageAsync)。
  • ドキュメントのタイトルを取得し、既定の背景色を設定する新しいプロパティ: DocumentTitleDefaultBackgroundColor
  • LocalFolder データ ストアと TemporaryFolder データ ストアでの ms-appdata スキームのサポート。これは ms-appdata:///local/folder/file.html および ms-appdata:///temp/folder/file.html のような URI への移動を有効にします。このスキームに対する WebView のサポートでは、ローカル フォルダーまたは一時フォルダーにあるサブフォルダー内にコンテンツを配置する必要があります。これらの第 1 レベルのサブフォルダーは、他の第 1 レベルのサブフォルダーのコンテンツから分離されます。たとえば、ms-appdata:///temp/folder1/file.html には移動できますが、このファイルに ms-appdata:///temp/folder2/file.html へのリンクを含めることはできません。
WebView は常に、ドキュメント モードで Internet Explorer 11 を使用します。

Windows 8.1 では、次の WebView API が廃止されました。

  • LoadCompleted および NavigationFailed。代わりに NavigationCompleted を使用します。
  • InvokeScript。代わりに InvokeScriptAsync を使用します。
  • DataTransferPackage および DataTransferPackageProperty。 代わりに CaptureSelectedContentToDataPackageAsync を使用します。
  • AllowedScriptNotifyUrisAnyScriptNotifyUri、および AllowedScriptNotifyUrisProperty。これらの API はサポートされていません。Windows 8.1 用にコンパイルされたアプリのコメントを参照してください。window.external.notify の呼び出し時に、外部 Web ページを有効にして ScriptNotify イベントを発生させるには、そのページの URI をアプリケーション マニフェストの ApplicationContentUriRules セクションに含める必要があります。(Visual Studio で、Package.appxmanifest デザイナーの [コンテンツ URI] タブでこの作業を実行できます)。この一覧の URI では HTTPS を使用する必要があり、サブドメインのワイルドカード (たとえば、https://*.microsoft.com) を含めることができますが、ドメインのワイルドカード (たとえば、https://*.com や https://*.*) を含めることはできません。アプリケーションのパッケージから生成されたコンテンツのうち、ms-local-stream:// という URI を使用するもの、または NavigateToString を使用して読み込まれたものに対して、マニフェストの要件は適用されません。

これらの変更は、Windows 8.1 で実行中の場合であっても、Windows 8 用にコンパイルされたアプリには影響しません。

次のコード例は、Address という名前の TextBox に含まれる URI に WebView で移動する方法を示しています。この完全なコード リストおよび次の例は、「WebView control sample (WebView コントロールのサンプル)」で使用できます。


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


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


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

WebView コントロールを使用して、HTML に含まれている JavaScript 関数を呼び出す方法を次のコード例に示します。

メモ  Windows 8.1 以降は、InvokeScript の代わりに InvokeScriptAsync を使用する必要があります。


string htmlFragment = 
    "<html><head><script type='text/javascript'>function SayGoodbye() { " +
    "document.getElementById('myDiv').innerText = 'GoodBye'; } " +
    "</script></head><body><div id='myDiv'>Hello</div></body></html>";

WebView3.NavigateToString(htmlFragment);

WebView3.InvokeScript("SayGoodbye", null);


要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

名前空間

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

メタデータ

Windows.winmd

参照

FrameworkElement
XAML WebView コントロールのサンプル

 

 

表示:
© 2014 Microsoft