Compartir a través de


WebUIView Clase

Definición

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
Implementaciones

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.

Se aplica a