Kit de développement logiciel (SDK) version préliminaire 1.0.3079-version préliminaire, pour le runtime 134 (24 janvier 2025)

Notes de publication pour Microsoft Edge WebView2 Prerelease SDK, date de publication : 24 janvier 2025.

Package NuGet pour WebView2 SDK 1.0.3079-prerelease

Pour une compatibilité totale avec l’API, cette version préliminaire du SDK WebView2 nécessite le runtime WebView2 fourni avec Microsoft Edge version 134.0.3079.0 ou ultérieure ; voir Runtime 134.0.3124.44 (10 mars 2025).

Contenu détaillé :

API expérimentales (phase 1 : expérimental en préversion)

Les API expérimentales suivantes ont été ajoutées dans cette version préliminaire du Kit de développement logiciel (SDK).

Personnaliser le comportement de recherche (API Rechercher)

L’API Find vous permet de contrôler par programme les opérations de recherche et permet d’ajouter les fonctionnalités suivantes à votre application :

  • Personnalisez les options de recherche, notamment Terme de recherche, Sensibilité à la casse, Correspondance de Word, Mise en surbrillance de correspondance et Suppression de l’interface utilisateur par défaut.
  • Recherchez des chaînes de texte et naviguez parmi elles dans un contrôle WebView2.
  • Lancer par programme Opérations de recherche et naviguer Rechercher des résultats.
  • Supprimez l’interface utilisateur de recherche par défaut.
  • Suivez le status des opérations de recherche.

Il existe des problèmes connus avec l’API Rechercher pour les documents PDF. Lorsque vous affichez un document PDF dans un contrôle WebView2, la fonctionnalité Rechercher ne fournit actuellement que le premier index et le nombre de correspondances trouvées. Par exemple, si la chaîne apparaît trois fois dans un fichier PDF, l’interface utilisateur indiquerait 1/3 et ne prendrait pas en charge l’appel par programme suivant ou précédent. Nous étudions activement ces problèmes et nous vous encourageons à signaler tout problème que vous rencontrez en utilisant le dépôt WebView2Feedback .

Personnaliser le comportement glisser-déplacer (API DragBeginning)

L’API DragStarting remplace le comportement de glisser-déplacer par défaut lors de l’exécution en mode d’hébergement visuel. L’événement DragStarting avertit votre application lorsque l’utilisateur démarre une opération de glissement dans WebView2 et fournit l’état nécessaire pour remplacer l’opération de glissement WebView2 par défaut avec votre propre logique.

  • Utilisez DragStarting sur pour ICoreWebView2ExperimentalCompositionController6 ajouter un gestionnaire d’événements appelé au démarrage de l’opération de glisser-déplacer.
  • Utilisez-la ICoreWebView2ExperimentalDragStartingEventArgs pour démarrer votre propre opération de glisser-déplacer.
    • Utilisez la méthode pour exécuter une GetDeferral logique de glissement asynchrone et rappeler dans le WebView ultérieurement.
    • Utilisez la Handled propriété pour que WebView2 sache s’il faut utiliser sa propre logique de glissement.

Suivre l’historique de navigation pour les iframes imbriqués (API FrameCreatedEvent)

L’API FrameCreatedEvent prend en charge les iframes imbriqués, tels que l’enregistrement de l’historique de navigation d’un iframe de deuxième niveau. Sans cette API, WebView2 ne suit que les iframes de premier niveau, qui sont les iframes enfants directs de l’image principale. À l’aide de cette API, votre application peut s’abonner à l’événement de création iframe imbriqué, ce qui donne accès à l’application à toutes les propriétés, méthodes et événements de CoreWebView2Frame pour l’iframe imbriqué.

Utilisez cette API pour gérer le suivi iframe sur une page qui contient plusieurs niveaux d’iframes. Vous pouvez choisir de suivre l’une des opérations suivantes :

  • Uniquement la page principale et les iframes de premier niveau (comportement par défaut).
  • Une arborescence partielle des cadres WebView2 avec des iframes spécifiques d’intérêt.
  • Arborescence complète des cadres WebView2.

Définir la couleur d’arrière-plan par défaut lors de l’initialisation WebView2 (API DefaultBackgroundColor)

L’API DefaultBackgroundColor permet aux utilisateurs de définir la propriété lors de l’initialisation DefaultBackgroundColor . Cela permet d’éviter un éclair blanc perturbateur pendant le processus de chargement de WebView2.

Promotions à la phase 2 (stable en préversion)

Les API suivantes sont passées de la phase 1 : expérimentale en version préliminaire à la phase 2 : stable en version préliminaire, et sont incluses dans ce kit de développement logiciel (SDK) en version préliminaire.

Afficher les éléments WPF au-dessus de la couche WebView2 (WebView2CompositionControl)

Cela WebView2CompositionControl empêche le contrôle WebView2 d’être la couche supérieure d’une application WPF et de masquer les éléments WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl remplace directement le contrôle WPF WebView2 standard. Le WebView2 contrôle et WebView2CompositionControl implémente l’interface Microsoft.Web.WebView2.Wpf.IWebView2 . Les deux dérivent de FrameworkElement, comme suit :

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Contexte : Si vous créez une application Windows Presentation Foundation (WPF) et utilisez le contrôle WebView2, vous constaterez peut-être que votre application rencontre des problèmes d'« espace aérien », où le contrôle WebView2 est toujours affiché en haut, masquant tous les éléments WPF au même emplacement, même si vous essayez de spécifier les éléments WPF au-dessus du contrôle WebView2 (à l’aide de l’ordre de l’arborescence visuelle ou de la propriété z-index, par exemple).

Ce problème se produit parce que le contrôle WPF utilise le WPF HwndHost pour héberger le contrôle WebView2 Win32 et HwndHost a un problème avec l’espace aérien.

La phase précédente n’est pas dans les notes de publication.

Voir aussi :

Correctifs de bogue

  • Correction d’un problème dans le WPF WebView2CompositionControl où il n’est pas affiché s’il est initialisé avec une taille (0,0), comme lorsqu’il est initialisé dans un TabItem .TabControl (Problème #4941)

Voir aussi