WebUIView Classe

Definizione

Spazio dei nomi:

Windows.UI.WebUI

Rappresenta una visualizzazione (finestra) dell'app nello script in background dell'applicazione.

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

Ereditarietà

Object Platform::Object IInspectable WebUIView

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Implementazioni

IWebViewControl IWebViewControl2

Requisiti Windows

Famiglia di dispositivi	Windows 10, version 1809 (è stato introdotto in 10.0.17763.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v7.0)

Esempio

L'app può restare in ascolto dell'evento NewWebUIViewCreated per intercettare il controllo dello spostamento per una nuova visualizzazione (esposta da NewWebUIEventCreatedEventArgs.WebUIView):

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

Commenti

Windows 10 le app Web supportano uno script in background facoltativo per applicazione che viene avviato prima dell'attivazione e dell'esecuzione di tutte le visualizzazioni per la durata del processo. Con questo script puoi monitorare e modificare gli spostamenti, tenere traccia dello stato tra i vari spostamenti, monitorare gli errori di spostamento ed eseguire codice prima che vengano attivate le visualizzazioni.

Quando questo script in background viene specificato come StartPage nel manifesto dell'app, ognuna delle visualizzazioni (finestre) dell'app viene esposta allo script come istanze della WebUIView classe, fornendo gli stessi eventi, proprietà e metodi come webView generale (Win32).

Esistono diverse differenze tra la visualizzazione Web HTML (x-ms-webview/MSHTMLWebViewElement) e la WebUIView classe :

	Webview HTML	Classe WebUIView
Metodi asincroni webUIView	Restituire oggetti MSWebViewAsyncOperation	Restituire oggetti promise JavaScript
Metodo Navigate	Richiede un URI sotto forma di stringa	Richiede un oggetto Windows.Foundation.Uri
Metodo InvokeScriptAsync	Gli argomenti script vengono specificati come numero arbitrario di parametri stringa	Gli argomenti script vengono specificati come matrice di stringhe

Qualsiasi attivazione dell'app con lo script in background come StartPage si basa sullo script stesso per lo spostamento.

Proprietà

ApplicationViewId	Ottiene l'identificatore per questa visualizzazione.
CanGoBack	Ottiene un valore che indica se nella cronologia di spostamento indietro è presente almeno una pagina.
CanGoForward	Ottiene un valore che indica se nella cronologia di navigazione in avanti è presente almeno una pagina.
ContainsFullScreenElement	Ottiene un valore che indica se la visualizzazione contiene un elemento che supporta lo schermo intero.
DefaultBackgroundColor	Ottiene o imposta il colore da utilizzare come sfondo della visualizzazione quando il contenuto HTML non specifica un colore.
DeferredPermissionRequests	Ottiene una raccolta di richieste di autorizzazione in attesa di essere concesse o negate.
DocumentTitle	Ottiene il titolo della pagina attualmente visualizzata nella visualizzazione.
IgnoreApplicationContentUriRulesNavigationRestrictions	Ottiene o imposta un valore che specifica se ignorare le regole URI del contenuto e le restrizioni di navigazione.
Settings	Ottiene un oggetto WebViewControlSettings che contiene proprietà per abilitare o disabilitare le funzionalità IWebViewControl.
Source	Ottiene o imposta l'origine URI del contenuto HTML da visualizzare nel controllo.

Metodi

AddInitializeScript(String)	Aggiunge uno script per inizializzare la visualizzazione.
BuildLocalStreamUri(String, String)	Crea un URI che è possibile passare a NavigateToLocalStreamUri
CapturePreviewToStreamAsync(IRandomAccessStream)	Crea un'immagine del contenuto della visualizzazione corrente e la scrive nel flusso specificato.
CaptureSelectedContentToDataPackageAsync()	Ottiene in modo asincrono un DataPackage che contiene il contenuto selezionato all'interno del controllo.
CreateAsync()	Crea una nuova visualizzazione come azione asincrona.
CreateAsync(Uri)	Crea una nuova visualizzazione con argomenti specifici, come azione asincrona.
GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)	Restituisce la richiesta di autorizzazione posticipata con l'ID specificato.
GoBack()	Passa alla pagina precedente nella cronologia di navigazione.
GoForward()	Passa alla pagina successiva nella cronologia di navigazione.
InvokeScriptAsync(String, IIterable<String>)	Esegue la funzione script specificata dal codice HTML attualmente caricato, con argomenti specifici, come azione asincrona.
Navigate(Uri)	Carica il contenuto HTML in corrispondenza dell'URI (Uniform Resource Identifier) specificato.
NavigateToLocalStreamUri(Uri, IUriToStreamResolver)	Carica contenuto Web locale nell'URI specificato usando un oggetto IUriToStreamResolver.
NavigateToString(String)	Carica il contenuto HTML specificato come nuovo documento.
NavigateWithHttpRequestMessage(HttpRequestMessage)	Sposta il controllo su un URI con una richiesta POST e intestazioni HTTP.
Refresh()	Ricarica il contenuto corrente nel controllo .
Stop()	Interrompe lo spostamento o il download del controllo corrente.

Eventi

Activated	Si verifica quando la visualizzazione viene attivata.
Closed	Si verifica quando la visualizzazione è stata chiusa.
ContainsFullScreenElementChanged	Si verifica quando lo stato della visualizzazione contiene o meno un elemento a schermo intero.
ContentLoading	Si verifica quando la visualizzazione inizia a caricare nuovo contenuto.
DOMContentLoaded	Evento attivato al termine dell'analisi del contenuto HTML corrente.
FrameContentLoading	Si verifica quando un frame nella visualizzazione inizia a caricare nuovo contenuto.
FrameDOMContentLoaded	Si verifica al termine dell'analisi del contenuto HTML corrente di un frame nella visualizzazione.
FrameNavigationCompleted	Si verifica quando il controllo ha terminato il caricamento del contenuto corrente o se lo spostamento non è riuscito.
FrameNavigationStarting	Si verifica subito prima che la visualizzazione passi al nuovo contenuto.
LongRunningScriptDetected	Evento attivato periodicamente mentre il controllo esegue JavaScript, consentendo di interrompere lo script.
NavigationCompleted	Si verifica quando il controllo ha terminato il caricamento del contenuto corrente o se lo spostamento non è riuscito.
NavigationStarting	Si verifica prima che il controllo passi al nuovo contenuto.
NewWindowRequested	Si verifica quando un utente esegue un'azione nel controllo che causa l'apertura del contenuto in una nuova finestra.
PermissionRequested	Si verifica quando un'azione nel controllo richiede che venga concessa l'autorizzazione.
ScriptNotify	Si verifica quando il contenuto contenuto contenuto nel controllo passa una stringa all'app usando JavaScript.
UnsafeContentWarningDisplaying	Si verifica quando il controllo visualizza una pagina di avviso per il contenuto segnalato come non sicuro da SmartScreen Filter.
UnsupportedUriSchemeIdentified	Si verifica quando viene effettuato un tentativo di passare a un URI usando uno schema che il controllo non supporta.
UnviewableContentIdentified	Evento attivato quando il controllo tenta di scaricare un file non supportato.
WebResourceRequested	Evento generato quando viene effettuata una richiesta HTTP.