Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Notas de versão do SDK de pré-lançamento do Microsoft Edge WebView2, data de lançamento: 24 de janeiro de 2025.
Pacote NuGet para WebView2 SDK 1.0.3079-prerelease
Para compatibilidade total com a API, esta versão de pré-lançamento do SDK do WebView2 requer o WebView2 Runtime que vem com o Microsoft Edge versão 134.0.3079.0 ou posterior; consulte Runtime 134.0.3124.44 (10 de março de 2025).
Conteúdo detalhado:
-
APIs Experimentais (Fase 1: Experimental no Pré-lançamento)
- Personalizar o comportamento de localização (API de Localização)
- Personalizar o comportamento de arrastar e soltar (API DragStarting)
- Acompanhar o histórico de navegação para iframes aninhados (API FrameCreatedEvent)
- Definir a cor da tela de fundo padrão na inicialização do WebView2 (API DefaultBackgroundColor)
- Promoções para a Fase 2 (Estável no Pré-lançamento)
- Correções de bugs
- Confira também
APIs Experimentais (Fase 1: Experimental no Pré-lançamento)
As seguintes APIs experimentais foram adicionadas neste SDK de pré-lançamento.
Personalizar o comportamento de localização (API de Localização)
A API Find permite controlar programaticamente as operações Find e permite adicionar a seguinte funcionalidade ao seu aplicativo:
- Personalize as opções de Localizar, incluindo Localizar Termo, Distinção entre maiúsculas e minúsculas, Correspondência de Word, Realce de correspondência e Supressão de interface do usuário padrão.
- Localizar cadeias de caracteres de texto e navegar entre elas em um controle WebView2.
- Inicie programaticamente operações de Localização e navegue pelos resultados de Localizar .
- Suprimir a interface do usuário padrão do Finder .
- Acompanhe o status das operações Localizar.
Há problemas conhecidos com a API Find para documentos PDF. Quando você exibe um documento PDF em um controle WebView2, o recurso Localizar atualmente fornece apenas o primeiro índice e o número de correspondências encontradas. Por exemplo, se a cadeia de caracteres ocorrer três vezes em um PDF, a interface do usuário dirá 1/3 e não dará suporte à chamada programática de Next ou Previous. Estamos investigando ativamente esses problemas e encorajamos você a relatar quaisquer problemas que encontrar, usando o repositório WebView2Feedback .
CoreWebView2Classe:CoreWebView2EnvironmentClasse:-
- Propriedade CoreWebView2Find.ActiveMatchIndex
- Evento CoreWebView2Find.ActiveMatchIndexChanged
- Método CoreWebView2Find.FindNext
- Método CoreWebView2Find.FindPrevious
- Propriedade CoreWebView2Find.MatchCount
- Evento CoreWebView2Find.MatchCountChanged
- Método CoreWebView2Find.StartAsync
- Método CoreWebView2Find.Stop
Personalizar o comportamento de arrastar e soltar (API DragStarting)
A DragStarting API substitui o comportamento padrão de arrastar e soltar ao executar no modo de hospedagem visual. O DragStarting evento notifica seu aplicativo quando o usuário inicia uma operação de arrastar no WebView2 e fornece o estado necessário para substituir a operação de arrastar WebView2 padrão por sua própria lógica.
- Use
DragStartingnoICoreWebView2ExperimentalCompositionController6para adicionar um manipulador de eventos que é invocado quando a operação de arrastar está começando. - Use
ICoreWebView2ExperimentalDragStartingEventArgspara iniciar sua própria operação de arrastar.- Use o
GetDeferralmétodo para executar qualquer lógica de arrastar assíncrona e chamar de volta para o WebView posteriormente. - Use a
Handledpropriedade para permitir que o WebView2 saiba se deve usar sua própria lógica de arrastar.
- Use o
Acompanhar o histórico de navegação para iframes aninhados (API FrameCreatedEvent)
A API FrameCreatedEvent dá suporte a iframes aninhados, como registrar o histórico de navegação para um iframe de segundo nível. Sem essa API, o WebView2 rastreia apenas iframes de primeiro nível, que são os iframes filho diretos do quadro principal. Usando essa API, seu aplicativo pode assinar o evento de criação de iframe aninhado, dando ao aplicativo acesso a todas as propriedades, métodos e eventos do CoreWebView2Frame iframe aninhado.
Use essa API para gerenciar o rastreamento de iframe em uma página que contém vários níveis de iframes. Você pode optar por acompanhar qualquer um dos seguintes:
- Apenas a página principal e os iframes de primeiro nível (o comportamento padrão).
- Uma árvore de quadros WebView2 parcial com iframes específicos de interesse.
- A árvore completa de quadros do WebView2.
-
CoreWebView2FrameClasse:
Definir a cor da tela de fundo padrão na inicialização do WebView2 (API DefaultBackgroundColor)
A API DefaultBackgroundColor permite que os usuários definam a DefaultBackgroundColor propriedade na inicialização. Isso evita um flash branco perturbador durante o processo de carregamento do WebView2.
-
CoreWebView2ControllerOptionsClasse:
Promoções para a Fase 2 (Estável no Pré-lançamento)
As seguintes APIs foram promovidas da Fase 1: Experimental no Pré-lançamento, para a Fase 2: Estável no Pré-lançamento, e estão incluídas neste SDK de Pré-lançamento.
Mostrar elementos WPF na parte superior da camada WebView2 (WebView2CompositionControl)
Isso WebView2CompositionControl impede que o controle WebView2 seja a camada superior em um aplicativo WPF e obscureça qualquer elemento WPF.
Microsoft.Web.WebView2.Wpf.WebView2CompositionControl é uma substituição imediata para o controle WPF WebView2 padrão. O controle WebView2 e implementa WebView2CompositionControl a Microsoft.Web.WebView2.Wpf.IWebView2 interface. Ambos derivam de FrameworkElement, da seguinte forma:
-
FrameworkElement->HwndHost->WebView2. -
FrameworkElement->Control->WebView2CompositionControl.
Contexto: se você estiver criando um aplicativo WPF (Windows Presentation Foundation) e usando o controle WebView2, poderá descobrir que seu aplicativo enfrenta problemas de "espaço aéreo", em que o controle WebView2 é sempre exibido na parte superior, ocultando todos os elementos WPF no mesmo local, mesmo se você tentar especificar os elementos WPF para estarem acima do controle WebView2 (usando a ordem da árvore visual ou a propriedade z-index, por exemplo).
Esse problema ocorre porque o controle WPF usa o WPF HwndHost para hospedar o controle Win32 WebView2 e HwndHost tem um problema com o espaço aéreo.
A fase anterior não está nas notas de versão.
Veja também:
- Mitigando problemas de espaço aéreo em aplicativos WPF
- WPF Airspace - WebView2CompositionControl - Spec.
Correções de bugs
- Correção de um problema no WPF
WebView2CompositionControlem que ele não é exibido se ele é inicializado com tamanho (0,0), como quando é inicializado em umTabItemde aTabControl. (Problema #4941)