WebUIView Clase

Definición

Espacio de nombres:

Windows.UI.WebUI

Representa una vista (ventana) de la aplicación en el script en segundo plano de la aplicación.

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

Herencia

Object Platform::Object IInspectable WebUIView

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementaciones

IWebViewControl IWebViewControl2

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1809 (se introdujo en la versión 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v7.0)

Ejemplos

La aplicación puede escuchar el evento NewWebUIViewCreated para interceptar el control de navegación de una nueva vista (expuesta desde NewWebUIEventCreatedEventArgs.WebUIView):

Windows.UI.WebUI.WebUIApplication.addEventListener("newwebuiviewcreated", newWebUIViewCreatedEventHandler);

Comentarios

Las aplicaciones web de Windows 10 admiten un script en segundo plano opcional por aplicación que se inicia antes de que se activen las vistas y se ejecuten durante el proceso. Con esto, puedes supervisar y modificar las navegaciones, realizar un seguimiento de estado entre navegaciones, supervisar los errores de navegación y ejecutar código antes de que se activen las vistas.

Cuando este script en segundo plano se especifica como StartPage en el manifiesto de la aplicación, cada una de las vistas de la aplicación (ventanas) se expone al script como instancias de la WebUIView clase, proporcionando los mismos eventos, propiedades y métodos que una vista web general (Win32).

Hay varias diferencias entre la vista web HTML (x-ms-webview/MSHTMLWebViewElement) y la WebUIView clase :

	Vista web HTML	Clase WebUIView
Métodos asincrónicos de WebUIView	Devolver objetos MSWebViewAsyncOperation	Devolución de objetos de promesa de JavaScript
Método Navigate	Requiere un URI en forma de cadena	Requiere un objeto Windows.Foundation.Uri
Método InvokeScriptAsync	Los argumentos de script se especifican como un número arbitrario de parámetros de cadena	Los argumentos de script se especifican como una matriz de cadenas

Cualquier activación de la aplicación con el script en segundo plano, ya que StartPage se basará en el propio script para la navegación.

Propiedades

ApplicationViewId	Obtiene el identificador de esta vista.
CanGoBack	Obtiene un valor que indica si hay al menos una página en el historial de navegación hacia atrás.
CanGoForward	Obtiene un valor que indica si hay al menos una página en el historial de navegación hacia delante.
ContainsFullScreenElement	Obtiene un valor que indica si la vista contiene un elemento que admite pantalla completa.
DefaultBackgroundColor	Obtiene o establece el color que se va a usar como fondo de vista cuando el contenido HTML no especifica un color.
DeferredPermissionRequests	Obtiene una colección de solicitudes de permisos que están esperando que se concedan o denieguen.
DocumentTitle	Obtiene el título de la página que se muestra actualmente en la vista.
IgnoreApplicationContentUriRulesNavigationRestrictions	Obtiene o establece un valor que especifica si se omitirán las reglas de URI de contenido y las restricciones de navegación.
Settings	Obtiene un objeto WebViewControlSettings que contiene propiedades para habilitar o deshabilitar las características de IWebViewControl.
Source	Obtiene o establece el origen de URI del contenido HTML que se va a mostrar en el control.

Métodos

AddInitializeScript(String)	Agrega un script para inicializar la vista.
BuildLocalStreamUri(String, String)	Crea un URI que se puede pasar a NavigateToLocalStreamUri.
CapturePreviewToStreamAsync(IRandomAccessStream)	Crea una imagen del contenido de la vista actual y la escribe en la secuencia especificada.
CaptureSelectedContentToDataPackageAsync()	Obtiene de forma asincrónica un DataPackage que contiene el contenido seleccionado dentro del control.
CreateAsync()	Crea una nueva vista como una acción asincrónica.
CreateAsync(Uri)	Crea una nueva vista con argumentos específicos, como una acción asincrónica.
GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)	Devuelve la solicitud de permiso diferida con el identificador especificado.
GoBack()	Navega a la página anterior en el historial de navegación.
GoForward()	Navega a la página siguiente del historial de navegación.
InvokeScriptAsync(String, IIterable<String>)	Ejecuta la función de script especificada desde el HTML cargado actualmente, con argumentos específicos, como una acción asincrónica.
Navigate(Uri)	Carga el contenido HTML en el identificador uniforme de recursos (URI) especificado.
NavigateToLocalStreamUri(Uri, IUriToStreamResolver)	Carga el contenido web local en el URI especificado mediante un IUriToStreamResolver.
NavigateToString(String)	Carga el contenido HTML especificado como un nuevo documento.
NavigateWithHttpRequestMessage(HttpRequestMessage)	Navega el control a un URI con una solicitud POST y encabezados HTTP.
Refresh()	Vuelve a cargar el contenido actual en el control .
Stop()	Detiene la navegación o descarga del control actual.

Eventos

Activated	Se produce cuando se activa la vista.
Closed	Se produce cuando se ha cerrado la vista.
ContainsFullScreenElementChanged	Se produce cuando el estado de la vista contiene actualmente un elemento de pantalla completa o no cambia.
ContentLoading	Se produce cuando la vista comienza a cargar contenido nuevo.
DOMContentLoaded	Evento que se desencadena cuando la vista ha terminado de analizar el contenido HTML actual.
FrameContentLoading	Se produce cuando un marco de la vista comienza a cargar contenido nuevo.
FrameDOMContentLoaded	Se produce cuando un marco de la vista ha terminado de analizar su contenido HTML actual.
FrameNavigationCompleted	Se produce cuando el control ha terminado de cargar el contenido actual o si se ha producido un error en la navegación.
FrameNavigationStarting	Se produce justo antes de que la vista navegue al nuevo contenido.
LongRunningScriptDetected	Evento que se desencadena periódicamente mientras el control ejecuta JavaScript, lo que le permite detener el script.
NavigationCompleted	Se produce cuando el control ha terminado de cargar el contenido actual o si se ha producido un error en la navegación.
NavigationStarting	Se produce antes de que el control navegue al nuevo contenido.
NewWindowRequested	Se produce cuando un usuario realiza una acción en el control que hace que el contenido se abra en una nueva ventana.
PermissionRequested	Se produce cuando una acción del control requiere que se conceda ese permiso.
ScriptNotify	Se produce cuando el contenido incluido en el control pasa una cadena a la aplicación mediante JavaScript.
UnsafeContentWarningDisplaying	Se produce cuando el control muestra una página de advertencia para el contenido que el filtro SmartScreen notificó como no seguro.
UnsupportedUriSchemeIdentified	Se produce cuando se intenta navegar a un URI mediante un esquema que el control no admite.
UnviewableContentIdentified	Evento que se desencadena cuando el control intenta descargar un archivo no admitido.
WebResourceRequested	Evento que se desencadena cuando se realiza una solicitud HTTP.