WebView2 em aplicações WinUI 2 (UWP)

As seguintes considerações aplicam-se ao WebView2 nas aplicações WinUI 2 (UWP). O controlo WebView2 WinUI 2 (UWP) está em desenvolvimento.

IU de Preenchimento Automático

A IU de preenchimento automático ainda não está implementada para WebView2 para aplicações UWP.

Veja também:

• Preenchimento automático na Descrição Geral das APIs webView2.

Imprimir para PDF

Imprimir em PDF requer que a aplicação tenha acesso a uma localização gravável no UWP, como uma pasta local. Para obter uma lista completa dos caminhos acessíveis para UWP, veja Permissões de acesso a ficheiros.

Veja também:

• Imprimir na Descrição Geral das APIs webView2.

Impressão predefinida

A impressão predefinida está desativada para WebView2 para aplicações UWP. No entanto, pode capturar e imprimir a viewport atual ao chamar CapturePreview.

Veja também:

• Captura de imagem na Descrição geral das APIs webView2.

SmartScreen

O WebView2 envia URLs para os quais navegam na sua aplicação para o serviço SmartScreen , para garantir que os seus clientes se mantêm seguros. Se quiser desativar esta navegação, pode fazê-lo através de uma variável de ambiente:

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

Esta variável de ambiente tem de ser definida antes da CoreWebView2 criação, o que ocorre quando a propriedade WebView2.Source é inicialmente definida ou o método WebView2.EnsureCoreWebView2Async é inicialmente chamado.

A transferir ficheiros

Existem algumas limitações conhecidas para o comportamento de transferências atuais do WebView2 no UWP.

Salvar como

Guardar ficheiros através de Guardar Como está a funcionar e está ativado para WebView2 para aplicações UWP. Os ficheiros serão guardados na pasta que o utilizador selecionar.

Para que pasta os ficheiros são transferidos

Se o anfitrião não alterar o ResultFilePath ficheiro transferido, os ficheiros transferidos serão transferidos para uma subpasta com o nome do pacote de aplicação na Downloads pasta.

Se o anfitrião alterar o ResultFilePath do ficheiro transferido, o ficheiro só será transferido se a aplicação tiver acesso a esse caminho de ficheiro por predefinição. Se quiser utilizar uma localização de ficheiro à qual a aplicação não tem acesso por predefinição, tem de definir a capacidade correspondente. Veja Declarações de capacidade da aplicação na documentação do UWP.

Hub de Transferências

A abertura de ficheiros e pastas a partir do Hub de Transferências está desativada. Clicar no ícone de ficheiro ou pasta não abre o respetivo ficheiro/pasta.

Veja também:

• Transferências em Descrição Geral das APIs webView2.

Limitação de XAML

O suporte da Ilha XAML requer trabalho adicional e pode ser considerado para lançamentos futuros.

PredefinirBackgroundColor

No WinUI 2, a DefaultBackgroundColor propriedade não é exposta diretamente. Pode definir a cor de fundo predefinida ao definir uma variável de ambiente da seguinte forma:

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

Veja também:

• .NET: Propriedade WebView2.DefaultBackgroundColor
• Win32: ICoreWebView2Controller2::D efaultBackgroundColor propriedade (get, put)

Definir transparência

No WinUI 2, a transparência é obtida ao definir a cor como 00FFFFFF.

Cursores CSS

No WinUI 2 (UWP), os cursores CSS têm as seguintes limitações.

URLs de imagem

O cursor CSS não pode ser um URL de imagem, como cursor: url(https://contoso.com/cursor.png), pointer;. Veja CSS – o cursor carregado a partir do URL não funciona.

Cursores CSS predefinidos

No WinUI 2 (UWP), alguns dos cursores de CSS predefinidos não são suportados. Pode utilizar cursores CSS para alterar o cursor para alguns dos cursores predefinidos, como cursor: wait; ou cursor: crosshair;, mas não para outros, como cursor: progress ou cursor: none.

Veja também:

• Cursores CSS – a secção Valores descreve os valores palavra-chave acima.

Ferramentas de Programador do Microsoft Edge

No WinUI 2, não é possível iniciar o Microsoft Edge DevTools dentro de uma aplicação WebView2 WinUI 2 (UWP) assinada pela loja. No entanto, pode contornar este problema com a depuração remota. Veja Depuração remota de aplicações WebView2 WinUI 2 (UWP).

Limitações da API

As seguintes classes não estão acessíveis no WinUI 2:

• CoreWebView2EnvironmentOptions
• CoreWebView2ControllerOptions

Confira também

• Preenchimento automático na Descrição Geral das APIs webView2.
• Imprimir na Descrição Geral das APIs webView2.
• Captura de imagem na Descrição geral das APIs webView2.
• Transferências em Descrição Geral das APIs webView2.
• Depuração remota de aplicações WebView2 WinUI 2 (UWP)

Referência da API:

• .NET: Propriedade WebView2.DefaultBackgroundColor
• Win32: ICoreWebView2Controller2::_getDefaultBackgroundColor
• Win32: ICoreWebView2Controller2::_putDefaultBackgroundColor

Documentos do Windows:

• SmartScreen
• Propriedade WebView2.Source
• WebView2.EnsureCoreWebView2Async method (Método WebView2.EnsureCoreWebView2Async)
• Declarações de capacidade de aplicações

MDN:

• Valores na propriedade CSS do cursor na MDN.

Repositório WebView2Feedback:

• CSS – o cursor carregado a partir do URL não funciona