WebUIView Classe

Définition

Espace de noms:

Windows.UI.WebUI

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

ContractVersionAttribute MarshalingBehaviorAttribute

Implémente

IWebViewControl IWebViewControl2

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.