WebViewControl 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
이 클래스는 IWebViewControl의 구현입니다.
public ref class WebViewControl sealed : IWebViewControlpublic 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, IWebViewControl2Public NotInheritable Class WebViewControl
Implements IWebViewControlPublic NotInheritable Class WebViewControl
Implements IWebViewControl, IWebViewControl2- 상속
- 특성
- 구현
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 |
뒤로 탐색 기록에 페이지가 하나 이상 있는지 여부를 나타내는 값을 가져옵니다. |
| CanGoForward |
앞으로 탐색 기록에 페이지가 하나 이상 있는지 여부를 나타내는 값을 가져옵니다. |
| ContainsFullScreenElement |
컨트롤에 전체 화면을 지원하는 요소가 포함되어 있는지 여부를 나타내는 값을 가져옵니다. |
| DefaultBackgroundColor |
HTML 콘텐츠가 색을 지정하지 않을 때 컨트롤 배경으로 사용할 색을 가져오거나 설정합니다. |
| DeferredPermissionRequests |
부여되거나 거부되기를 기다리는 권한 요청의 컬렉션을 가져옵니다. |
| DocumentTitle |
컨트롤에 현재 표시되는 페이지의 제목을 가져옵니다. |
| IsVisible |
이 컨트롤이 보이지 않는지 여부를 나타내는 값을 가져오거나 설정합니다. |
| Process |
컨트롤이 호스트되는 프로세스를 가져옵니다. |
| Scale |
창의 배율을 가져오거나 설정합니다. |
| Settings |
IWebViewControl 기능을 사용하거나 사용하지 않도록 설정하는 속성이 포함된 WebViewControlSettings 개체를 가져옵니다. |
| Source |
컨트롤에 표시할 HTML 콘텐츠의 URI 원본을 가져오거나 설정합니다. |
메서드
| AddInitializeScript(String) |
ContentLoading 직후에 다른 스크립트가 페이지에서 실행되기 전에 WebViewControl에 스크립트를 삽입합니다. |
| BuildLocalStreamUri(String, String) |
NavigateToLocalStreamUri에 전달할 수 있는 URI를 만듭니다. |
| CapturePreviewToStreamAsync(IRandomAccessStream) |
현재 컨트롤 콘텐츠의 이미지를 만들고 지정된 스트림에 씁니다. |
| CaptureSelectedContentToDataPackageAsync() |
중요 이 메서드는 더 이상 사용되지 않으며 알려진 문제가 있습니다. 프로덕션 코드에서 이 메서드를 사용하지 마세요. 컨트롤 내에서 선택한 콘텐츠가 포함된 DataPackage 를 비동기적으로 가져옵니다. |
| Close() |
컨트롤을 닫습니다. |
| GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest) |
지정된 ID를 사용하여 지연된 권한 요청을 반환합니다. |
| GoBack() |
IWebViewControl을 탐색 기록의 이전 페이지로 이동합니다. |
| GoForward() |
IWebViewControl을 탐색 기록의 다음 페이지로 이동합니다. |
| InvokeScriptAsync(String, IIterable<String>) |
특정 인수를 사용하여 현재 로드된 HTML에서 지정된 스크립트 함수를 비동기 작업으로 실행합니다. |
| MoveFocus(WebViewControlMoveFocusReason) |
포커스를 이동합니다. |
| Navigate(Uri) |
지정된 URI(Uniform Resource Identifier)에서 HTML 콘텐츠를 로드합니다. |
| NavigateToLocalStreamUri(Uri, IUriToStreamResolver) |
IUriToStreamResolver를 사용하여 지정된 URI에서 로컬 웹 콘텐츠를 로드합니다. |
| NavigateToString(String) |
지정된 HTML 콘텐츠를 새 문서로 로드합니다. |
| NavigateWithHttpRequestMessage(HttpRequestMessage) |
POST 요청 및 HTTP 헤더를 사용하여 컨트롤을 URI로 이동합니다. |
| Refresh() |
컨트롤의 현재 콘텐츠를 다시 로드합니다. |
| Stop() |
현재 컨트롤 탐색 또는 다운로드를 중지합니다. |
이벤트
| AcceleratorKeyPressed |
가속기 키를 누를 때 트리거되는 이벤트입니다. |
| ContainsFullScreenElementChanged |
컨트롤에 현재 전체 화면 요소가 포함되어 있는지 여부를 상태 때 트리거되는 이벤트입니다. |
| ContentLoading |
컨트롤이 새 콘텐츠 로드를 시작할 때 트리거되는 이벤트입니다. |
| DOMContentLoaded |
컨트롤이 현재 HTML 콘텐츠 구문 분석을 완료했을 때 트리거되는 이벤트입니다. |
| FrameContentLoading |
컨트롤의 프레임이 현재 HTML 콘텐츠 구문 분석을 완료했을 때 트리거되는 이벤트입니다. |
| FrameDOMContentLoaded |
컨트롤의 프레임이 현재 HTML 콘텐츠 구문 분석을 완료했을 때 트리거되는 이벤트입니다. |
| FrameNavigationCompleted |
컨트롤의 프레임이 콘텐츠 로드를 완료할 때 트리거되는 이벤트입니다. |
| FrameNavigationStarting |
컨트롤의 프레임이 새 콘텐츠로 이동하기 전에 트리거되는 이벤트입니다. |
| GotFocus |
WebViewControl이 포커스를 받을 때(사용자가 WebViewControl 내부/외부를 클릭하기 때문에) 앱에 알릴 수 있습니다. WebViewControl.MoveFocus 메서드를 사용하여 LostFocus 이벤트 및 프로그래밍 방식 포커스 변경 내용과 함께 사용합니다. |
| LongRunningScriptDetected |
컨트롤이 JavaScript를 실행하는 동안 주기적으로 트리거되는 이벤트로, 스크립트를 중지할 수 있습니다. |
| LostFocus |
WebViewControl이 포커스를 잃을 때 앱에 알릴 수 있습니다. WebViewControl 내부/외부를 클릭하거나 WebViewControl 또는 MoveFocus 메서드 호출이 아닌 창에서 SetFocus를 호출하는 앱과 같은 프로그래밍 방식 포커스 변경으로 시작할 수 있습니다. |
| MoveFocusRequested |
포커스 이동이 요청될 때 트리거되는 이벤트입니다. |
| NavigationCompleted |
컨트롤이 현재 콘텐츠 로드를 완료하거나 탐색에 실패한 경우 트리거되는 이벤트입니다. |
| NavigationStarting |
컨트롤이 새 콘텐츠로 이동하기 전에 트리거되는 이벤트입니다. |
| NewWindowRequested |
사용자가 컨트롤에서 새 창에서 콘텐츠를 열게 하는 작업을 수행할 때 트리거되는 이벤트입니다. |
| PermissionRequested |
컨트롤의 작업에 사용 권한을 부여해야 하는 경우 트리거되는 이벤트입니다. |
| ScriptNotify |
컨트롤에 포함된 콘텐츠가 를 사용하여 |
| UnsafeContentWarningDisplaying |
컨트롤에 SmartScreen 필터에서 안전하지 않은 것으로 보고된 콘텐츠에 대한 경고 페이지가 표시될 때 트리거되는 이벤트입니다. |
| UnsupportedUriSchemeIdentified |
컨트롤이 지원하지 않는 스키마를 사용하여 URI로 이동하려고 할 때 트리거되는 이벤트입니다. |
| UnviewableContentIdentified |
컨트롤이 지원되지 않는 파일을 다운로드하려고 할 때 트리거되는 이벤트입니다. |
| WebResourceRequested |
HTTP 요청이 발생할 때 발생하는 이벤트입니다. |
적용 대상
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기