다음을 통해 공유


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 웹앱은 보기가 활성화되고 프로세스 기간 동안 실행되기 전에 시작되는 애플리케이션별 선택적 백그라운드 스크립트를 지원합니다. 이렇게 하면 보기를 활성화하기 전에 탐색을 모니터링 및 수정하고, 탐색 전체의 상태를 추적하고, 탐색 오류를 모니터링하고, 코드를 실행할 수 있습니다.

이 백그라운드 스크립트가 앱 매니페스트에서 StartPage로 지정되면 앱의 각 뷰(창)가 클래스의 WebUIView 인스턴스로 스크립트에 노출되어 일반(Win32) WebView와 동일한 이벤트, 속성 및 메서드를 제공합니다.

HTML 웹 보기 (x-ms-webview/MSHTMLWebViewElement)와 클래스 간에는 몇 가지 차이점이 WebUIView 있습니다.

  HTML 웹 보기 WebUIView 클래스
WebUIView 비동기 메서드 MSWebViewAsyncOperation 개체 반환 JavaScript promise 개체 반환
Navigate 메서드 문자열 형식의 URI필요합니다. Windows.Foundation.Uri 개체 필요
InvokeScriptAsync 메서드 스크립트 인수 는 임의의 수의 문자열 매개 변수로 지정됩니다. 스크립트 인수 는 문자열 배열로 지정됩니다.

StartPage로 백그라운드 스크립트를 사용하는 모든 앱 활성화는 탐색을 위해 스크립트 자체를 사용합니다.

속성

ApplicationViewId

이 보기의 식별자를 가져옵니다.

CanGoBack

뒤로 탐색 기록에 페이지가 하나 이상 있는지 여부를 나타내는 값을 가져옵니다.

CanGoForward

앞으로 탐색 기록에 페이지가 하나 이상 있는지 여부를 나타내는 값을 가져옵니다.

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)

지정된 URI(Uniform Resource Identifier)에서 HTML 콘텐츠를 로드합니다.

NavigateToLocalStreamUri(Uri, IUriToStreamResolver)

IUriToStreamResolver를 사용하여 지정된 URI에서 로컬 웹 콘텐츠를 로드합니다.

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 요청이 발생할 때 발생하는 이벤트입니다.

적용 대상