다음을 통해 공유


WebViewControl 클래스

정의

이 클래스는 IWebViewControl의 구현입니다.

public ref class WebViewControl sealed : IWebViewControl
public ref class WebViewControl sealed : IWebViewControl, IWebViewControl2
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebViewControl final : IWebViewControl
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
class WebViewControl final : IWebViewControl, IWebViewControl2
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebViewControl : IWebViewControl
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
public sealed class WebViewControl : IWebViewControl, IWebViewControl2
Public NotInheritable Class WebViewControl
Implements IWebViewControl
Public NotInheritable Class WebViewControl
Implements IWebViewControl, IWebViewControl2
상속
Object Platform::Object IInspectable WebViewControl
특성
구현

Windows 요구 사항

디바이스 패밀리
Windows 10, version 1803 (10.0.17134.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v6.0에서 도입되었습니다.)

설명

버전 기록

Windows 버전 SDK 버전 추가된 값
1809 17763 AddInitializeScript
1809 17763 GotFocus
1809 17763 LostFocus

속성

Bounds

컨트롤의 범위를 가져오거나 설정합니다.

CanGoBack

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

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

CanGoForward

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

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

ContainsFullScreenElement

컨트롤에 전체 화면을 지원하는 요소가 포함되어 있는지 여부를 나타내는 값을 가져옵니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

DefaultBackgroundColor

HTML 콘텐츠가 색을 지정하지 않을 때 컨트롤 배경으로 사용할 색을 가져오거나 설정합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

DeferredPermissionRequests

부여되거나 거부되기를 기다리는 권한 요청의 컬렉션을 가져옵니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

DocumentTitle

컨트롤에 현재 표시되는 페이지의 제목을 가져옵니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

IsVisible

이 컨트롤이 보이지 않는지 여부를 나타내는 값을 가져오거나 설정합니다.

Process

컨트롤이 호스트되는 프로세스를 가져옵니다.

Scale

창의 배율을 가져오거나 설정합니다.

Settings

IWebViewControl 기능을 사용하거나 사용하지 않도록 설정하는 속성이 포함된 WebViewControlSettings 개체를 가져옵니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

Source

컨트롤에 표시할 HTML 콘텐츠의 URI 원본을 가져오거나 설정합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

메서드

AddInitializeScript(String)

ContentLoading 직후에 다른 스크립트가 페이지에서 실행되기 전에 WebViewControl에 스크립트를 삽입합니다.

BuildLocalStreamUri(String, String)

NavigateToLocalStreamUri에 전달할 수 있는 URI를 만듭니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

CapturePreviewToStreamAsync(IRandomAccessStream)

현재 컨트롤 콘텐츠의 이미지를 만들고 지정된 스트림에 씁니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

CaptureSelectedContentToDataPackageAsync()

중요

이 메서드는 더 이상 사용되지 않으며 알려진 문제가 있습니다. 프로덕션 코드에서 이 메서드를 사용하지 마세요.

컨트롤 내에서 선택한 콘텐츠가 포함된 DataPackage 를 비동기적으로 가져옵니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

Close()

컨트롤을 닫습니다.

GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)

지정된 ID를 사용하여 지연된 권한 요청을 반환합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

GoBack()

IWebViewControl을 탐색 기록의 이전 페이지로 이동합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

GoForward()

IWebViewControl을 탐색 기록의 다음 페이지로 이동합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

InvokeScriptAsync(String, IIterable<String>)

특정 인수를 사용하여 현재 로드된 HTML에서 지정된 스크립트 함수를 비동기 작업으로 실행합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

MoveFocus(WebViewControlMoveFocusReason)

포커스를 이동합니다.

Navigate(Uri)

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

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

NavigateToLocalStreamUri(Uri, IUriToStreamResolver)

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

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

NavigateToString(String)

지정된 HTML 콘텐츠를 새 문서로 로드합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

NavigateWithHttpRequestMessage(HttpRequestMessage)

POST 요청 및 HTTP 헤더를 사용하여 컨트롤을 URI로 이동합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

Refresh()

컨트롤의 현재 콘텐츠를 다시 로드합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

Stop()

현재 컨트롤 탐색 또는 다운로드를 중지합니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

이벤트

AcceleratorKeyPressed

가속기 키를 누를 때 트리거되는 이벤트입니다.

ContainsFullScreenElementChanged

컨트롤에 현재 전체 화면 요소가 포함되어 있는지 여부를 상태 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

ContentLoading

컨트롤이 새 콘텐츠 로드를 시작할 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

DOMContentLoaded

컨트롤이 현재 HTML 콘텐츠 구문 분석을 완료했을 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

FrameContentLoading

컨트롤의 프레임이 현재 HTML 콘텐츠 구문 분석을 완료했을 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

FrameDOMContentLoaded

컨트롤의 프레임이 현재 HTML 콘텐츠 구문 분석을 완료했을 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

FrameNavigationCompleted

컨트롤의 프레임이 콘텐츠 로드를 완료할 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

FrameNavigationStarting

컨트롤의 프레임이 새 콘텐츠로 이동하기 전에 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

GotFocus

WebViewControl이 포커스를 받을 때(사용자가 WebViewControl 내부/외부를 클릭하기 때문에) 앱에 알릴 수 있습니다. WebViewControl.MoveFocus 메서드를 사용하여 LostFocus 이벤트 및 프로그래밍 방식 포커스 변경 내용과 함께 사용합니다.

LongRunningScriptDetected

컨트롤이 JavaScript를 실행하는 동안 주기적으로 트리거되는 이벤트로, 스크립트를 중지할 수 있습니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

LostFocus

WebViewControl이 포커스를 잃을 때 앱에 알릴 수 있습니다. WebViewControl 내부/외부를 클릭하거나 WebViewControl 또는 MoveFocus 메서드 호출이 아닌 창에서 SetFocus를 호출하는 앱과 같은 프로그래밍 방식 포커스 변경으로 시작할 수 있습니다.

MoveFocusRequested

포커스 이동이 요청될 때 트리거되는 이벤트입니다.

NavigationCompleted

컨트롤이 현재 콘텐츠 로드를 완료하거나 탐색에 실패한 경우 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

NavigationStarting

컨트롤이 새 콘텐츠로 이동하기 전에 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

NewWindowRequested

사용자가 컨트롤에서 새 창에서 콘텐츠를 열게 하는 작업을 수행할 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

PermissionRequested

컨트롤의 작업에 사용 권한을 부여해야 하는 경우 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

ScriptNotify

컨트롤에 포함된 콘텐츠가 를 사용하여 window.external.notify앱에 문자열을 전달하면 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

UnsafeContentWarningDisplaying

컨트롤에 SmartScreen 필터에서 안전하지 않은 것으로 보고된 콘텐츠에 대한 경고 페이지가 표시될 때 트리거되는 이벤트입니다.

UnsupportedUriSchemeIdentified

컨트롤이 지원하지 않는 스키마를 사용하여 URI로 이동하려고 할 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

UnviewableContentIdentified

컨트롤이 지원되지 않는 파일을 다운로드하려고 할 때 트리거되는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

WebResourceRequested

HTTP 요청이 발생할 때 발생하는 이벤트입니다.

자세한 내용은 Windows.Web.UI.IWebViewControl을 참조하세요.

적용 대상