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