WebView2 dans les applications WinUI 2 (UWP)

Les considérations suivantes s’appliquent à WebView2 dans les applications WinUI 2 (UWP). Le contrôle WebView2 WinUI 2 (UWP) est en cours de développement.

Interface utilisateur de remplissage automatique

L’interface utilisateur de remplissage automatique n’est pas encore implémentée pour WebView2 pour les applications UWP.

Voir aussi :

• Remplissage automatique dans Vue d’ensemble des API WebView2.

Imprimer au format PDF

L’impression au format PDF nécessite que l’application ait accès à un emplacement accessible en écriture dans UWP, tel qu’un dossier local. Pour obtenir la liste complète des chemins d’accès UWP, consultez Autorisations d’accès aux fichiers.

Voir aussi :

• Impression dans Vue d’ensemble des API WebView2.

Impression par défaut

L’impression par défaut est désactivée pour WebView2 pour les applications UWP. Toutefois, vous pouvez capturer et imprimer la fenêtre d’affichage actuelle en appelant CapturePreview.

Voir aussi :

• Capture d’image dans Vue d’ensemble des API WebView2.

SmartScreen

WebView2 envoie les URL auxquelles vous accédez dans votre application au service SmartScreen pour garantir la sécurité de vos clients. Si vous souhaitez désactiver cette navigation, vous pouvez le faire via une variable d’environnement :

• Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--disable-features=msSmartScreenProtection");

Cette variable d’environnement doit être définie avant CoreWebView2 la création, ce qui se produit lorsque la propriété WebView2.Source est initialement définie ou que la méthode WebView2.EnsureCoreWebView2Async est initialement appelée.

Téléchargement de fichiers

Il existe quelques limitations connues pour le comportement actuel des téléchargements pour WebView2 dans UWP.

Enregistrer sous

L’enregistrement de fichiers via Enregistrer sous fonctionne et est activé pour WebView2 pour les applications UWP. Les fichiers seront enregistrés dans le dossier sélectionné par l’utilisateur.

Dossier dans lequel les fichiers sont téléchargés

Si l’hôte ne modifie pas le ResultFilePath du fichier téléchargé, les fichiers téléchargés sont téléchargés dans un sous-dossier avec le nom du package d’application dans le Downloads dossier.

Si l’hôte modifie le ResultFilePath du fichier téléchargé, le fichier est téléchargé uniquement si l’application a accès à ce chemin d’accès par défaut. Si vous souhaitez utiliser un emplacement de fichier auquel l’application n’a pas accès par défaut, vous devez définir la fonctionnalité correspondante. Consultez Déclarations des fonctionnalités d’application dans la documentation UWP.

Hub téléchargements

L’ouverture de fichiers et de dossiers à partir du hub téléchargements est désactivée. Le fait de cliquer sur l’icône de fichier ou de dossier n’ouvre pas le fichier/dossier respectif.

Voir aussi :

• Téléchargements dans Vue d’ensemble des API WebView2.

Limitation XAML

La prise en charge de XAML Island nécessite un travail supplémentaire et peut être envisagée pour les versions ultérieures.

Définition de DefaultBackgroundColor

Sur WinUI 2, la DefaultBackgroundColor propriété n’est pas exposée directement. Vous pouvez définir la couleur d’arrière-plan par défaut en définissant une variable d’environnement, comme suit :

Environment.SetEnvironmentVariable("WEBVIEW2_DEFAULT_BACKGROUND_COLOR", "FF000000");

Voir aussi :

• .NET : WebView2.DefaultBackgroundColor, propriété
• Win32 : Propriété ICoreWebView2Controller2 ::D efaultBackgroundColor (get, put)

Définition de la transparence

Sur WinUI 2, la transparence est obtenue en définissant la couleur sur 00FFFFFF.

Curseurs CSS

Sur WinUI 2 (UWP), les curseurs CSS présentent les limitations suivantes.

URL d’image

Le curseur CSS ne peut pas être une URL d’image, telle que cursor: url(https://contoso.com/cursor.png), pointer;. Consultez CSS : le curseur chargé à partir de l’URL ne fonctionne pas.

Curseurs CSS prédéfinis

Sur WinUI 2 (UWP), certains curseurs CSS prédéfinis ne sont pas pris en charge. Vous pouvez utiliser des curseurs CSS pour remplacer le curseur par certains des curseurs prédéfinis, tels que cursor: wait; ou cursor: crosshair;, mais pas par d’autres, tels que cursor: progress ou cursor: none.

Voir aussi :

• Curseurs CSS : la section Valeurs décrit les valeurs mot clé ci-dessus.

Outils de développement Microsoft Edge

Sur WinUI 2, Microsoft Edge DevTools ne peut pas être lancé dans une application WebView2 WinUI 2 (UWP) signée par le Store. Toutefois, vous pouvez contourner ce problème à l’aide du débogage à distance. Consultez Débogage à distance des applications WebView2 WinUI 2 (UWP).

Limitations de l’API

Les classes suivantes ne sont pas accessibles dans WinUI 2 :

• CoreWebView2EnvironmentOptions
• CoreWebView2ControllerOptions

Voir aussi

• Remplissage automatique dans Vue d’ensemble des API WebView2.
• Impression dans Vue d’ensemble des API WebView2.
• Capture d’image dans Vue d’ensemble des API WebView2.
• Téléchargements dans Vue d’ensemble des API WebView2.
• Débogage à distance des applications WebView2 WinUI 2 (UWP)

Informations de référence sur l’API :

• .NET : WebView2.DefaultBackgroundColor, propriété
• Win32 : ICoreWebView2Controller2 ::_getDefaultBackgroundColor
• Win32 : ICoreWebView2Controller2 ::_putDefaultBackgroundColor

Documentation Windows :

• SmartScreen
• Propriété WebView2.Source
• Méthode WebView2.EnsureCoreWebView2Async
• Déclarations de fonctionnalité d’application

MDN :

• Valeurs dans la propriété CSS du curseur sur MDN.

Référentiel WebView2Feedback :

• CSS : le curseur chargé à partir de l’URL ne fonctionne pas