Поделиться через


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

Если этот фоновый скрипт указан в качестве начальной страницы в манифесте приложения, каждое из представлений (окон) приложения предоставляется скрипту как экземпляры 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-запроса.

Применяется к