WebUIView 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
애플리케이션 백그라운드 스크립트에 대한 앱의 보기(창)를 나타냅니다.
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, IWebViewControl2Public NotInheritable Class WebUIView
Implements 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 웹앱은 보기가 활성화되고 프로세스 기간 동안 실행되기 전에 시작되는 애플리케이션별 선택적 백그라운드 스크립트를 지원합니다. 이렇게 하면 보기를 활성화하기 전에 탐색을 모니터링 및 수정하고, 탐색 전체의 상태를 추적하고, 탐색 오류를 모니터링하고, 코드를 실행할 수 있습니다.
이 백그라운드 스크립트가 앱 매니페스트에서 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 원본을 가져오거나 설정합니다. |
메서드
이벤트
| 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 요청이 발생할 때 발생하는 이벤트입니다. |