WebUIView Classe

Definição

Namespace:

Windows.UI.WebUI

Representa uma exibição (janela) do aplicativo para o script em segundo plano do aplicativo.

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

Herança

Object Platform::Object IInspectable WebUIView

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute

Implementações

IWebViewControl IWebViewControl2

Requisitos do Windows

Família de dispositivos	Windows 10, version 1809 (introduzida na 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v7.0)

Exemplos

Seu aplicativo pode escutar o evento NewWebUIViewCreated para interceptar o controle de navegação para um novo modo de exibição (exposto de NewWebUIEventCreatedEventArgs.WebUIView):

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

Comentários

Os aplicativos Web do Windows 10 dão suporte a um script opcional em segundo plano por aplicativo que começa antes de qualquer exibição ser ativada e executada durante o processo. Com isso, você pode monitorar e modificar as navegações, acompanhar o estado entre navegações, monitorar os erros de navegação e executar código antes de as exibições serem ativadas.

Quando esse script em segundo plano é especificado como StartPage no manifesto do aplicativo, cada uma das exibições do aplicativo (janelas) são expostas ao script como instâncias da WebUIView classe , fornecendo os mesmos eventos, propriedades e métodos como um WebView geral (Win32).

Há várias diferenças entre o modo de exibição da Web HTML (x-ms-webview/MSHTMLWebViewElement) e a WebUIView classe :

	Visão da Web HTML	Classe WebUIView
Métodos assíncronos WebUIView	Retornar objetos MSWebViewAsyncOperation	Retornar objetos de promessa do JavaScript
Método Navigate	Requer um URI na forma de uma cadeia de caracteres	Requer um objeto Windows.Foundation.Uri
Método InvokeScriptAsync	Os argumentos de script são especificados como um número arbitrário de parâmetros de cadeia de caracteres	Os argumentos de script são especificados como uma matriz de cadeias de caracteres

Qualquer ativação de aplicativo com o script em segundo plano como StartPage dependerá do próprio script para navegação.

Propriedades

ApplicationViewId	Obtém o identificador dessa exibição.
CanGoBack	Obtém um valor que indica se há pelo menos uma página no histórico de navegação anterior.
CanGoForward	Obtém um valor que indica se há pelo menos uma página no histórico de navegação para frente.
ContainsFullScreenElement	Obtém um valor que indica se o modo de exibição contém um elemento que dá suporte à tela inteira.
DefaultBackgroundColor	Obtém ou define a cor a ser usada como a tela de fundo da exibição quando o conteúdo HTML não especifica uma cor.
DeferredPermissionRequests	Obtém uma coleção de solicitações de permissão que estão aguardando para serem concedidas ou negadas.
DocumentTitle	Obtém o título da página exibida atualmente no modo de exibição.
IgnoreApplicationContentUriRulesNavigationRestrictions	Obtém ou define um valor que especifica se as regras de URI de conteúdo e as restrições de navegação devem ser ignoradas.
Settings	Obtém um objeto WebViewControlSettings que contém propriedades para habilitar ou desabilitar recursos IWebViewControl.
Source	Obtém ou define a origem do URI do conteúdo HTML a ser exibido no controle .

Métodos

AddInitializeScript(String)	Adiciona um script para inicializar a exibição.
BuildLocalStreamUri(String, String)	Cria um URI que você pode passar para NavigateToLocalStreamUri
CapturePreviewToStreamAsync(IRandomAccessStream)	Cria uma imagem do conteúdo do modo de exibição atual e grava-a no fluxo especificado.
CaptureSelectedContentToDataPackageAsync()	Obtém de forma assíncrona um DataPackage que contém o conteúdo selecionado dentro do controle .
CreateAsync()	Cria uma nova exibição como uma ação assíncrona.
CreateAsync(Uri)	Cria uma nova exibição com argumentos específicos, como uma ação assíncrona.
GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)	Retorna a solicitação de permissão adiada com a ID especificada.
GoBack()	Navega até a página anterior no histórico de navegação.
GoForward()	Navega para a próxima página no histórico de navegação.
InvokeScriptAsync(String, IIterable<String>)	Executa a função de script especificada do HTML carregado no momento, com argumentos específicos, como uma ação assíncrona.
Navigate(Uri)	Carrega o conteúdo HTML no URI (Uniform Resource Identifier) especificado.
NavigateToLocalStreamUri(Uri, IUriToStreamResolver)	Carrega o conteúdo da Web local no URI especificado usando um IUriToStreamResolver.
NavigateToString(String)	Carrega o conteúdo HTML especificado como um novo documento.
NavigateWithHttpRequestMessage(HttpRequestMessage)	Navega o controle para um URI com uma solicitação POST e cabeçalhos HTTP.
Refresh()	Recarrega o conteúdo atual no controle .
Stop()	Interrompe a navegação ou o download do controle atual.

Eventos

Activated	Ocorre quando a exibição é ativada.
Closed	Ocorre quando a exibição foi fechada.
ContainsFullScreenElementChanged	Ocorre quando o status de se o modo de exibição atualmente contém um elemento de tela inteira ou não é alterado.
ContentLoading	Ocorre quando o modo de exibição começa a carregar o novo conteúdo.
DOMContentLoaded	Um evento que é disparado quando o modo de exibição termina de analisar o conteúdo HTML atual.
FrameContentLoading	Ocorre quando um quadro no modo de exibição começa a carregar novo conteúdo.
FrameDOMContentLoaded	Ocorre quando um quadro na exibição termina de analisar seu conteúdo HTML atual.
FrameNavigationCompleted	Ocorre quando o controle termina de carregar o conteúdo atual ou se a navegação falhou.
FrameNavigationStarting	Ocorre logo antes da exibição navegar para o novo conteúdo.
LongRunningScriptDetected	Um evento que é disparado periodicamente enquanto o controle executa JavaScript, permitindo que você interrompa o script.
NavigationCompleted	Ocorre quando o controle termina de carregar o conteúdo atual ou se a navegação falhou.
NavigationStarting	Ocorre antes que o controle navegue até o novo conteúdo.
NewWindowRequested	Ocorre quando um usuário executa uma ação no controle que faz com que o conteúdo seja aberto em uma nova janela.
PermissionRequested	Ocorre quando uma ação no controle requer que essa permissão seja concedida.
ScriptNotify	Ocorre quando o conteúdo contido no controle passa uma cadeia de caracteres para o aplicativo usando JavaScript.
UnsafeContentWarningDisplaying	Ocorre quando o controle mostra uma página de aviso para conteúdo que foi relatado como não seguro pelo Filtro SmartScreen.
UnsupportedUriSchemeIdentified	Ocorre quando é feita uma tentativa de navegar até um URI usando um esquema ao qual o controle não dá suporte.
UnviewableContentIdentified	Um evento que é disparado quando o controle tenta baixar um arquivo sem suporte.
WebResourceRequested	Um evento que é acionado quando uma solicitação HTTP é feita.