WebUIView Класс

Определение

Пространство имен:

Windows.UI.WebUI

Представляет представление (окно) приложения для фонового скрипта приложения.

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

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute

Реализации

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 поддерживают необязательный фоновый скрипт для каждого приложения, который запускается перед активацией и выполнением каких-либо представлений в течение всего процесса. Таким образом вы можете отслеживать и изменять элементы навигации, отслеживать их состояние, отслеживать ошибки и запускать код перед активацией представлений.

Если этот фоновый скрипт указан в качестве начальной страницы в манифесте приложения, каждое из представлений (окон) приложения предоставляется скрипту как экземпляры WebUIView класса , предоставляя те же события, свойства и методы, что и общее (Win32) WebView.

Существует несколько различий между html-веб-представлением (x-ms-webview/MSHTMLWebViewElement) и классом WebUIView :

	Веб-представление HTML	Класс WebUIView
Асинхронные методы WebUIView	Возврат объектов MSWebViewAsyncOperation	Возврат объектов promise JavaScript
Метод Navigate	Требуетсяуниверсальный код ресурса (URI ) в виде строки	Требуется объект Windows.Foundation.Uri
Метод InvokeScriptAsync	Аргументы скрипта указываются в виде произвольного числа строковых параметров.	Аргументы скрипта указываются в виде массива строк

Любая активация приложения с фоновым скриптом в качестве StartPage будет зависеть от самого скрипта для навигации.

Свойства

ApplicationViewId	Возвращает идентификатор для этого представления.
CanGoBack	Возвращает значение, указывающее, существует ли хотя бы одна страница в журнале навигации в обратном направлении.
CanGoForward	Возвращает значение, указывающее, есть ли хотя бы одна страница в журнале навигации вперед.
ContainsFullScreenElement	Возвращает значение, указывающее, содержит ли представление элемент, поддерживающий полноэкранный режим.
DefaultBackgroundColor	Возвращает или задает цвет, используемый в качестве фона представления, если HTML-содержимое не указывает цвет.
DeferredPermissionRequests	Возвращает коллекцию запросов разрешений, ожидающих предоставления или отклонения.
DocumentTitle	Возвращает заголовок страницы, отображаемой в представлении.
IgnoreApplicationContentUriRulesNavigationRestrictions	Возвращает или задает значение, указывающее, следует ли игнорировать правила URI содержимого и ограничения навигации.
Settings	Возвращает объект WebViewControlSettings , содержащий свойства для включения или отключения функций IWebViewControl.
Source	Возвращает или задает источник URI HTML-содержимого, отображаемого в элементе управления .

Методы

AddInitializeScript(String)	Добавляет скрипт для инициализации представления.
BuildLocalStreamUri(String, String)	Создает универсальный код ресурса (URI), который можно передать в NavigateToLocalStreamUri.
CapturePreviewToStreamAsync(IRandomAccessStream)	Создает изображение содержимого текущего представления и записывает его в указанный поток.
CaptureSelectedContentToDataPackageAsync()	Асинхронно получает DataPackage , содержащий выбранное содержимое в элементе управления .
CreateAsync()	Создает новое представление как асинхронное действие.
CreateAsync(Uri)	Создает новое представление с определенными аргументами в виде асинхронного действия.
GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)	Возвращает отложенный запрос на разрешение с указанным идентификатором.
GoBack()	Переход на предыдущую страницу в журнале навигации.
GoForward()	Переходит на следующую страницу в журнале навигации.
InvokeScriptAsync(String, IIterable<String>)	Выполняет указанную функцию скрипта из текущего загруженного HTML-кода с определенными аргументами в качестве асинхронного действия.
Navigate(Uri)	Загружает HTML-содержимое по указанному универсальному коду ресурса (URI).
NavigateToLocalStreamUri(Uri, IUriToStreamResolver)	Загружает локальное веб-содержимое по указанному URI с помощью IUriToStreamResolver.
NavigateToString(String)	Загружает указанное html-содержимое в качестве нового документа.
NavigateWithHttpRequestMessage(HttpRequestMessage)	Перемещает элемент управления к URI с запросом POST и заголовками HTTP.
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-запроса.