WebView2 en aplicaciones de WinUI 2 (UWP)

Las siguientes consideraciones se aplican a WebView2 en aplicaciones WinUI 2 (UWP). El control WebView2 WinUI 2 (UWP) está en desarrollo.

Contenido detallado:

• Interfaz de usuario de Autorrellenar
• Impresión en PDF
• Impresión predeterminada
• SmartScreen
• Descargar archivos
  • Guardar como
  • En qué carpeta se descargan los archivos
  • Centro de descargas
• Limitación de XAML
• Configuración de DefaultBackgroundColor
• Establecer la transparencia
• Cursores CSS
  • URL de imagen
  • Cursores CSS predefinidos
• Herramientas de desarrollo de Microsoft Edge
• Limitaciones de la API
• Ver también

Interfaz de usuario de Autorrellenar

La interfaz de usuario de Autorrellenar aún no está implementada para las aplicaciones WebView2 para UWP.

Vea también:

• Autorrellenar en Información general sobre las API de WebView2.

Imprimir en PDF

Imprimir en PDF requiere que la aplicación tenga acceso a una ubicación de escritura en UWP, como una carpeta local. Para obtener una lista completa de las rutas de acceso accesibles para UWP, consulte Permisos de acceso a archivos.

Vea también:

• Impresión en Información general sobre las API de WebView2.

Impresión predeterminada

La impresión predeterminada está deshabilitada para WebView2 para aplicaciones para UWP. Sin embargo, puede capturar e imprimir la ventanilla actual llamando a CapturePreview.

Vea también:

• Captura de imagen en Información general de las API de WebView2.

SmartScreen

WebView2 envía las URL a las que se navega en la aplicación al servicio SmartScreen , para garantizar la seguridad de los clientes. Si desea deshabilitar esta navegación, puede hacerlo a través de una variable de entorno:

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

Esta variable de entorno debe establecerse antes de la CoreWebView2 creación, lo que ocurre cuando se establece inicialmente la propiedad WebView2.Source o se llama inicialmente al método WebView2.EnsureCoreWebView2Async .

Descargar archivos

Hay un par de limitaciones conocidas para el comportamiento actual de las descargas de WebView2 en UWP.

Guardar como

Guardar archivos a través de Guardar como funciona y está habilitado para WebView2 para aplicaciones para UWP. Los archivos se guardarán en la carpeta que seleccione.

En qué carpeta se descargan los archivos

Si el host no cambia ResultFilePath el archivo descargado, los archivos descargados se descargarán en una subcarpeta con el nombre del paquete de la aplicación en la Downloads carpeta.

Si el host cambia ResultFilePath el valor del archivo descargado, el archivo solo se descargará si la aplicación tiene acceso a esa ruta de acceso de archivo de forma predeterminada. Si desea usar una ubicación de archivo a la que la aplicación no tiene acceso de forma predeterminada, debe establecer la funcionalidad correspondiente. Consulta Declaraciones de funcionalidad de la aplicación en la documentación de UWP.

Centro de descargas

Abrir archivos y carpetas desde el Centro de descargas está deshabilitado. Al hacer clic en el icono de archivo o carpeta no se abrirá el archivo/carpeta correspondiente.

Vea también:

• Descargas en Información general sobre las API de WebView2.

Limitación de XAML

La compatibilidad con XAML Island requiere trabajo adicional y puede considerarse para futuras versiones.

Configuración de DefaultBackgroundColor

En WinUI 2, la DefaultBackgroundColor propiedad no se expone directamente. Puede establecer el color de fondo predeterminado estableciendo una variable de entorno, como se indica a continuación:

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

Vea también:

• .NET: Propiedad WebView2.DefaultBackgroundColor
• Win32: ICoreWebView2Controller2::D efaultBackgroundColor property (get, put)

Establecer la transparencia

En WinUI 2, la transparencia se logra estableciendo el color en 00FFFFFF.

Cursores CSS

En WinUI 2 (UWP), los cursores CSS tienen las siguientes limitaciones.

URL de imagen

El cursor CSS no puede ser una dirección URL de imagen, como cursor: url(https://contoso.com/cursor.png), pointer;. Consulta CSS: el cursor cargado desde la URL no funciona.

Cursores CSS predefinidos

En WinUI 2 (UWP), algunos de los cursores CSS predefinidos no son compatibles. Puede usar cursores CSS para cambiar el cursor a algunos de los cursores predefinidos, como cursor: wait; or cursor: crosshair;, pero no a otros, como cursor: progress or cursor: none.

Vea también:

• Cursores CSS : la sección Valores describe los valores de palabras clave anteriores.

Herramientas de desarrollo de Microsoft Edge

En WinUI 2, Microsoft Edge DevTools no se puede iniciar dentro de una aplicación WebView2 WinUI 2 (UWP) firmada por la tienda. Sin embargo, puede evitar este problema mediante la depuración remota. Consulte Depuración remota de aplicaciones WebView2 WinUI 2 (UWP).

Limitaciones de la API

No se puede acceder a las siguientes clases en WinUI 2:

• CoreWebView2EnvironmentOptions
• CoreWebView2ControllerOptions

Vea también

• Autorrellenar en Información general sobre las API de WebView2.
• Impresión en Información general sobre las API de WebView2.
• Captura de imagen en Información general de las API de WebView2.
• Descargas en Información general sobre las API de WebView2.
• Depuración remota de aplicaciones WebView2 WinUI 2 (UWP)

Referencia de la API:

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

Documentos de Windows:

• SmartScreen
• Propiedad WebView2.Source
• Método WebView2.EnsureCoreWebView2Async
• Declaraciones de funcionalidad de la aplicación

MDN:

• Valores en la propiedad CSS del cursor en MDN.

Repositorio WebView2Feedback:

• CSS: el cursor cargado desde la URL no funciona