Partager via


WebUIView Classe

Définition

Représente une vue (fenêtre) de l’application sur le script d’arrière-plan de l’application.

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
Héritage
Object Platform::Object IInspectable WebUIView
Attributs
Implémente

Configuration requise pour Windows

Famille d’appareils
Windows 10, version 1809 (introduit dans 10.0.17763.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v7.0)

Exemples

Votre application peut écouter l’événement NewWebUIViewCreated pour intercepter le contrôle de la navigation d’une nouvelle vue (exposée à partir de NewWebUIEventCreatedEventArgs.WebUIView) :

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

Remarques

Windows 10 applications web prennent en charge un script d’arrière-plan facultatif par application qui démarre avant que les vues ne soient activées et s’exécutent pendant la durée du processus. Vous pouvez ainsi surveiller et modifier les navigations, suivre l'état des navigations, surveiller les erreurs de navigation et exécuter le code avant que les affichages ne soient activés.

Lorsque ce script d’arrière-plan est spécifié en tant que StartPage dans le manifeste de votre application, chacune des vues de l’application (windows) est exposée au script en tant qu’instances de la WebUIView classe, fournissant les mêmes événements, propriétés et méthodes en général (Win32) WebView.

Il existe plusieurs différences entre la vue web HTML (x-ms-webview/MSHTMLWebViewElement) et la WebUIView classe :

  Vue web HTML Classe WebUIView
Méthodes asynchrones WebUIView Retourner des objets MSWebViewAsyncOperation Retourner des objets de promesse JavaScript
Méthode Navigate Nécessite un URI sous la forme d’une chaîne Nécessite un objet Windows.Foundation.Uri
Méthode InvokeScriptAsync Les arguments de script sont spécifiés sous la forme d’un nombre arbitraire de paramètres de chaîne Les arguments de script sont spécifiés sous forme de tableau de chaînes

Toute activation d’application avec le script d’arrière-plan en tant que StartPage s’appuie sur le script lui-même pour la navigation.

Propriétés

ApplicationViewId

Obtient l’identificateur de cette vue.

CanGoBack

Obtient une valeur qui indique s’il existe au moins une page dans l’historique de navigation arrière.

CanGoForward

Obtient une valeur qui indique s’il existe au moins une page dans l’historique de navigation avant.

ContainsFullScreenElement

Obtient une valeur qui indique si la vue contient un élément qui prend en charge le plein écran.

DefaultBackgroundColor

Obtient ou définit la couleur à utiliser comme arrière-plan de la vue lorsque le contenu HTML ne spécifie pas de couleur.

DeferredPermissionRequests

Obtient une collection de demandes d’autorisation qui attendent d’être accordées ou refusées.

DocumentTitle

Obtient le titre de la page actuellement affichée dans la vue.

IgnoreApplicationContentUriRulesNavigationRestrictions

Obtient ou définit une valeur qui spécifie s’il faut ignorer les règles d’URI de contenu et les restrictions de navigation.

Settings

Obtient un objet WebViewControlSettings qui contient des propriétés pour activer ou désactiver les fonctionnalités IWebViewControl.

Source

Obtient ou définit la source d’URI du contenu HTML à afficher dans le contrôle.

Méthodes

AddInitializeScript(String)

Ajoute un script pour initialiser la vue.

BuildLocalStreamUri(String, String)

Crée un URI que vous pouvez passer à NavigateToLocalStreamUri

CapturePreviewToStreamAsync(IRandomAccessStream)

Crée une image du contenu de la vue actuelle et l’écrit dans le flux spécifié.

CaptureSelectedContentToDataPackageAsync()

Obtient de manière asynchrone un DataPackage qui contient le contenu sélectionné dans le contrôle.

CreateAsync()

Crée une vue en tant qu’action asynchrone.

CreateAsync(Uri)

Crée une vue avec des arguments spécifiques, sous forme d’action asynchrone.

GetDeferredPermissionRequestById(UInt32, WebViewControlDeferredPermissionRequest)

Retourne la demande d’autorisation différée avec l’ID spécifié.

GoBack()

Accède à la page précédente de l’historique de navigation.

GoForward()

Accède à la page suivante de l’historique de navigation.

InvokeScriptAsync(String, IIterable<String>)

Exécute la fonction de script spécifiée à partir du code HTML actuellement chargé, avec des arguments spécifiques, en tant qu’action asynchrone.

Navigate(Uri)

Charge le contenu HTML à l’URI (Uniform Resource Identifier) spécifié.

NavigateToLocalStreamUri(Uri, IUriToStreamResolver)

Charge le contenu web local à l’URI spécifié à l’aide d’un IUriToStreamResolver.

NavigateToString(String)

Charge le contenu HTML spécifié en tant que nouveau document.

NavigateWithHttpRequestMessage(HttpRequestMessage)

Navigue le contrôle vers un URI avec une requête POST et des en-têtes HTTP.

Refresh()

Recharge le contenu actuel dans le contrôle.

Stop()

Arrête la navigation ou le téléchargement du contrôle actuel.

Événements

Activated

Se produit lorsque la vue est activée.

Closed

Se produit lorsque la vue a été fermée.

ContainsFullScreenElementChanged

Se produit lorsque le status indiquant si l’affichage contient actuellement un élément plein écran ou non change.

ContentLoading

Se produit lorsque la vue commence à charger du nouveau contenu.

DOMContentLoaded

Événement déclenché lorsque la vue a terminé l’analyse du contenu HTML actuel.

FrameContentLoading

Se produit lorsqu’un cadre de la vue commence à charger du nouveau contenu.

FrameDOMContentLoaded

Se produit lorsqu’un cadre de la vue a terminé l’analyse de son contenu HTML actuel.

FrameNavigationCompleted

Se produit lorsque le contrôle a terminé le chargement du contenu actuel ou si la navigation a échoué.

FrameNavigationStarting

Se produit juste avant que la vue ne navigue vers le nouveau contenu.

LongRunningScriptDetected

Événement qui est déclenché régulièrement pendant que le contrôle exécute JavaScript, ce qui vous permet d’arrêter le script.

NavigationCompleted

Se produit lorsque le contrôle a terminé le chargement du contenu actuel ou si la navigation a échoué.

NavigationStarting

Se produit avant que le contrôle accède au nouveau contenu.

NewWindowRequested

Se produit lorsqu’un utilisateur effectue une action dans le contrôle qui provoque l’ouverture du contenu dans une nouvelle fenêtre.

PermissionRequested

Se produit lorsqu’une action dans le contrôle nécessite l’octroi de cette autorisation.

ScriptNotify

Se produit lorsque le contenu contenu dans le contrôle passe une chaîne à l’application à l’aide de JavaScript.

UnsafeContentWarningDisplaying

Se produit lorsque le contrôle affiche une page d’avertissement pour le contenu signalé comme non sécurisé par le filtre SmartScreen.

UnsupportedUriSchemeIdentified

Se produit lorsqu’une tentative d’accès à un URI est effectuée à l’aide d’un schéma que le contrôle ne prend pas en charge.

UnviewableContentIdentified

Événement déclenché lorsque le contrôle tente de télécharger un fichier non pris en charge.

WebResourceRequested

Événement déclenché lorsqu’une requête HTTP est effectuée.

S’applique à