Información general sobre las API de WebView2

Insertar el control WebView2 en la aplicación proporciona a la aplicación acceso a varias características del explorador, a través de métodos y propiedades que se proporcionan a través de las clases o interfaces WebView2.

WebView2 tiene cientos de API que proporcionan un amplio conjunto de capacidades, que van desde mejorar las capacidades de la plataforma nativa de la aplicación hasta permitir que la aplicación modifique las experiencias del explorador. En este artículo se proporciona una agrupación de alto nivel de las API de WebView2 para ayudarle a comprender las diferentes cosas que puede hacer con WebView2.

Contenido detallado:

Información general sobre las áreas características de nivel superior

Al hospedar el control WebView2, la aplicación tiene acceso a las siguientes características y API:

Área de característica Objetivo
Clases principales: entorno, controladora y núcleo Las CoreWebView2Environmentclases , CoreWebView2Controller, y CoreWebView2 (o interfaces equivalentes) funcionan juntas para que la aplicación pueda hospedar un control de explorador WebView2 y tener acceso a las características del explorador. Estas clases grandes exponen una amplia gama de API a las que puede acceder la aplicación host para proporcionar las categorías siguientes de características relacionadas con el explorador para los usuarios.
Interoperabilidad nativa/web Insertar contenido web en aplicaciones nativas. Comuníquese entre código nativo y código web mediante mensajes simples, código JavaScript y objetos nativos.
Características del explorador El control WebView2 proporciona a la aplicación acceso a muchas características del explorador. Puede modificar estas características del explorador y activarlas o desactivarlas.
Administración de procesos Obtén información acerca de los procesos WebView2 en ejecución, los procesos que salen y los procesos con errores, para que la aplicación pueda tomar las medidas pertinentes.
Navegar por las páginas y administrar el contenido cargado Administre la navegación por las páginas web y administre el contenido que se carga en las páginas web.
iframes Inserta otras páginas web en tu propia página web. Detectar cuándo se crean páginas web insertadas, detectar cuándo navegan las páginas web insertadas y, opcionalmente, omitir las opciones de marco X.
Autenticación La aplicación puede controlar la autenticación básica mediante el control WebView2. La autenticación básica es un enfoque de autenticación específico que forma parte del protocolo HTTP.
Representar WebView2 en aplicaciones que no son de marco Use estas API para configurar el sistema de representación WebView2 si la aplicación host no usa un marco de interfaz de usuario. Esta configuración de representación controla cómo WebView2 representa la salida en la aplicación host y cómo WebView2 controla la entrada, el enfoque y la accesibilidad.
Representar WebView2 con composición Para la representación WebView2 basada en la composición, se usa CoreWebView2Environment para crear un CoreWebView2CompositionControllerarchivo . CoreWebView2CompositionController proporciona las mismas API que CoreWebView2Controller, pero también incluye API para la representación basada en la composición.
Opciones de entorno Datos de usuario: Administre la carpeta de datos de usuario (UDF), que es una carpeta en la máquina del usuario. La UDF contiene datos relacionados con la aplicación host y WebView2. Las aplicaciones WebView2 usan carpetas de datos de usuario para almacenar datos del explorador, como cookies, permisos y recursos en caché. Administrar varios perfiles bajo una única UDF.
La selección del tiempo de ejecución admite las pruebas previas a la versión y el autohospedaje. Puede especificar un orden de búsqueda para los canales de vista previa del explorador y especificar qué canales de vista previa del explorador se buscan.
Rendimiento y depuración Analice y depure el rendimiento, controle los eventos relacionados con el rendimiento y administre el uso de memoria para aumentar la capacidad de respuesta de la aplicación.
Protocolo DevTools de Chrome (CDP) Instrumentar, inspeccionar, depurar y perfilar exploradores basados en Chromium. El protocolo DevTools de Chrome (CDP) es la base para las DevTools de Microsoft Edge. Use el protocolo DevTools de Chrome para las características que no están implementadas en la plataforma WebView2.

En esta página solo se enumeran las API que se encuentran en los SDK de versión; no enumera las API experimentales o las API estables que aún no están disponibles en los SDK de versión. Para obtener una lista completa de las API, incluidas las experimentales, consulte las notas de la versión de WebView2.

Clases principales: entorno, controladora y núcleo

Las CoreWebView2Environmentclases , CoreWebView2Controller, y CoreWebView2 (o interfaces equivalentes) funcionan juntas para que la aplicación pueda hospedar un control de explorador WebView2 y tener acceso a las características del explorador. Estas tres grandes clases exponen una amplia gama de API a las que puede acceder la aplicación host para proporcionar muchas categorías de características relacionadas con el explorador para los usuarios.

  • La CoreWebView2Environment clase representa un grupo de controles WebView2 que comparten el mismo proceso del explorador WebView2, la carpeta de datos de usuario y los procesos del representador. A partir de esta CoreWebView2Environment clase, se crean pares de CoreWebView2Controller e CoreWebView2 instancias.

  • La CoreWebView2Controller clase es responsable de la funcionalidad relacionada con el hospedaje, como el foco de la ventana, la visibilidad, el tamaño y la entrada, donde la aplicación hospeda el control WebView2.

  • La CoreWebView2 clase es para las partes específicas de la web del control WebView2, incluidas las redes, la navegación, los scripts y el análisis y la representación de HTML.

Vea también:

Interoperabilidad nativa/web

El control Microsoft Edge WebView2 permite insertar contenido web en aplicaciones nativas. Puede comunicarse entre código nativo y código web mediante mensajes simples, código JavaScript y objetos nativos. Las siguientes son las API principales para la comunicación entre el código nativo y web.

Casos de uso comunes para la interoperabilidad web/nativa:

  • Actualice el título de la ventana del host nativo después de navegar a otro sitio web.
  • Envíe un objeto de cámara nativo y use sus métodos desde una aplicación web.
  • Ejecuta un archivo JavaScript dedicado en el lado web de una aplicación.

Vea también:

Uso compartido de objetos host/web

WebView2 permite que los objetos definidos en código nativo se pasen al código del lado web de la aplicación. Los objetos host son cualquier objeto definido en el código nativo que elija pasar al código del lado web de la aplicación.

Los objetos host se pueden proyectar en JavaScript, de modo que puedes llamar a métodos de objetos nativos (u otras API) desde el código del lado web de la aplicación. Por ejemplo, la aplicación puede llamar a estas API como resultado de la interacción del usuario en el lado web de la aplicación. De esta manera, no es necesario volver a implementar las API de sus objetos nativos, como métodos o propiedades, en su código del lado web.

Ejecución de script

Permite que la aplicación host agregue código JavaScript en el contenido web dentro del control WebView2.

Mensajería web

La aplicación puede enviar mensajes al contenido web que esté dentro del control WebView2 y recibir mensajes de ese contenido web. Los mensajes se envían como cadenas u objetos JSON.

Opcionalmente, puede publicar y recibir objetos DOM junto con el mensaje, a través del additionalObjects parámetro de (.NET, WinRT) o a través PostWebMessageAsJsonWithAdditionalObjects de PostWebMessageAsJson (Win32). La clase WebView2 CoreWebView2FileSystemHandle representa el DOM FileSystemHandley CoreWebView2File representa el DOM File. Consulte también chrome.webview.postMessageWithAdditionalObjects en la Referencia de JavaScript.

Cuadros de diálogo de script

Cuando se hospeda WebView2, la aplicación puede administrar diferentes cuadros de diálogo de JavaScript para suprimirlos o reemplazarlos por cuadros de diálogo personalizados.

Búfer compartido

La API SharedBuffer admite búferes de uso compartido entre el proceso de la aplicación host de WebView2 y el proceso del representador de WebView2, en función de la memoria compartida del sistema operativo.

Vea también:

Características del explorador

El control WebView2 proporciona a la aplicación acceso a muchas características del explorador. Puede modificar estas características del explorador y activarlas o desactivarlas.

Impresión

Puede imprimir una página web en una impresora, un archivo PDF o un flujo PDF mediante la configuración de opciones de impresión personalizadas.

Vea también:

Cookies

Puede usar cookies en WebView2 para administrar sesiones de usuario, almacenar preferencias de personalización del usuario y realizar un seguimiento del comportamiento del usuario.

Vea también:

Captura de imagen

Al hospedar WebView2, la aplicación puede capturar capturas de pantalla e indicar qué formato usar para guardar la imagen.

Controlar si se muestra la interfaz de usuario de captura de pantalla

El ScreenCaptureStarting evento se genera siempre que WebView2 o iframe que corresponde al CoreWebView2Frame (o a cualquiera de sus iframes descendientes) solicita permiso para usar la API de Captura de pantalla antes de que se muestre la interfaz de usuario. Entonces, la aplicación puede bloquear la visualización de la interfaz de usuario o permitir que se muestre la interfaz de usuario.

Buscar

La API Find permite controlar mediante programación las operaciones Find y permite agregar la siguiente funcionalidad a la aplicación:

  • Personalice las opciones de búsqueda, incluido el término de búsqueda, la distinción entre mayúsculas y minúsculas, la coincidencia de Word, el resaltado de coincidencias y la supresión de la interfaz de usuario predeterminada.
  • Buscar cadenas de texto y navegar entre ellas dentro de un control WebView2.
  • Inicie mediante programación las operaciones de búsqueda y navegue por los resultados de búsqueda .
  • Suprimir la interfaz de usuario de búsqueda predeterminada.
  • Realizar un seguimiento del estado de las operaciones de búsqueda .

Hay problemas conocidos con la API Find para documentos PDF. Cuando ve un documento PDF dentro de un control WebView2, la característica Buscar actualmente solo proporciona el primer índice y el número de coincidencias encontradas. Por ejemplo, si la cadena aparece tres veces en un PDF, la interfaz de usuario indicaría 1/3 y no admitiría la llamada mediante programación a Siguiente o Anterior.

Estamos investigando activamente estos problemas y le animamos a que informe de cualquier problema que encuentre mediante el repositorio WebView2Feedback .

Descargas

La aplicación puede administrar la experiencia de descarga en WebView2. La aplicación puede:

  • Permitir o bloquear descargas basadas en metadatos diferentes.
  • Cambie la ubicación de descarga.
  • Configura una interfaz de usuario de descarga personalizada.
  • Personalizar la interfaz de usuario predeterminada.

General:

Modificar la experiencia predeterminada:

Experiencia de descarga personalizada:

Guardar como

Las API Guardar como permiten realizar la operación Guardar como mediante programación. Puede usar estas API para bloquear el cuadro de diálogo predeterminado Guardar como y, a continuación, guardar de forma silenciosa o crear su propia interfaz de usuario para Guardar como. Estas API solo pertenecen al cuadro de diálogo Guardar como , no al cuadro de diálogo Descargar , que usa las API de descarga.

Configurar la advertencia de seguridad al guardar un archivo

Al escuchar el evento, la SaveFileSecurityCheckStarting aplicación puede registrar un controlador en este evento para obtener la ruta de acceso del archivo, la extensión del nombre de archivo y la información URI de origen del documento. A continuación, puede aplicar sus propias reglas para realizar acciones como las siguientes:

  • Permita guardar el archivo sin presentar una interfaz de usuario predeterminada de advertencia de seguridad sobre la directiva de tipo de archivo.
  • Cancelar el guardado.
  • Crea tu propia interfaz de usuario para administrar las directivas de tipo de archivo en tiempo de ejecución.

Control de notificaciones web

Las API de notificación web admiten notificaciones no persistentes. El NotificationReceived evento para CoreWebView2 controla el control de notificaciones web, lo que permite la personalización o supresión por parte de la aplicación host. Las notificaciones no controladas se muestran de forma predeterminada en la interfaz de usuario de WebView2.

Permissions

Diferentes páginas web pueden solicitarle permisos para acceder a algunos recursos privilegiados, como el sensor de geolocalización, la cámara y el micrófono. La aplicación host puede responder a las solicitudes de permisos mediante programación y puede reemplazar la interfaz de usuario de permisos predeterminada por su propia interfaz de usuario.

Menús contextuales

El control WebView2 proporciona un menú contextual predeterminado (menú contextual) que puede personalizar o deshabilitar, y también puede crear su propio menú contextual.

Vea también:

Barra de estado

En la parte inferior izquierda de la página hay una barra de estado que muestra el estado de la página web que se está mostrando. En WebView2 puede habilitar o deshabilitar la barra de estado, obtener el texto de la barra de estado y averiguar cuándo ha cambiado el texto de la barra de estado.

Barras de desplazamiento superpuestas de Fluent

Estiliza las barras de desplazamiento con el diseño de Microsoft Fluent y hace que se superpongan sobre el contenido web. Este diseño de barra de desplazamiento adaptable se ajusta a varios dispositivos y tamaños de ventana.

Para experimentar con las barras de desplazamiento superpuestas de Fluent, en Microsoft Edge vaya a edge://flags y escriba barras de desplazamiento superpuestas Fluent.

Vea también:

  • Marcas del - msEdgeFluentOverlayScrollbarexplorador WebView2 y msOverlayScrollbarWinStyle banderas.

Agente de usuario

El agente de usuario es una cadena que representa la identidad del programa en nombre del usuario, como el nombre del explorador. En WebView2, puede establecer el agente de usuario.

Vea también:

Autorrellenar

La aplicación puede controlar independientemente si la funcionalidad de Autorrellenar del explorador está habilitada para obtener información general o para contraseñas.

Audio

La aplicación puede silenciar y reactivar todo el audio, y averiguar cuándo se está reproduciendo el audio.

Pruebas de aciertos de clics del mouse en regiones

Proporciona resultados de pruebas de aciertos en las regiones que contiene un WebView2. Útil para aplicaciones hospedadas visualmente que desean controlar eventos de mouse en el área no cliente de la ventana WebView2.

Navegación con el gesto de deslizar rápidamente

Al hospedar el control WebView2, la aplicación puede habilitar o deshabilitar la navegación con gestos de deslizamiento en dispositivos habilitados para entrada táctil. Este gesto permite a los usuarios finales:

  • Deslice el dedo hacia la izquierda o hacia la derecha (deslice horizontalmente) para navegar a la página anterior o siguiente del historial de navegación.
  • Tirar para actualizar (deslizar verticalmente) la página actual.

Esta característica está actualmente deshabilitada de forma predeterminada en el explorador. Para habilitar esta característica en WebView2, establezca la AdditionalBrowserArguments propiedad, especificando el --pull-to-refresh modificador.

Habilitar o deshabilitar el explorador que responde a las teclas del acelerador (teclas de método abreviado)

ICoreWebView2AcceleratorKeyPressedEventArgs tiene una IsBrowserAcceleratorKeyEnabled propiedad que le permite controlar si el explorador controla las teclas del acelerador (teclas de método abreviado), como Ctrl+P o F3.

Vea también:

Pantalla completa

En WebView2, puede averiguar cuándo un elemento HTML entra o sale de la vista de pantalla completa.

Barra de herramientas de PDF

En el visor de PDF del explorador, hay una barra de herramientas específica de PDF en la parte superior. En WebView2, puede ocultar algunos de los elementos en la barra de herramientas del visor de PDF.

Creación de temas

En WebView2, puede personalizar el tema de color como sistema, claro u oscuro.

Idioma

La Language propiedad establece el idioma de visualización predeterminado para WebView2 que se aplica a la interfaz de usuario del explorador (como menús contextuales y cuadros de diálogo), junto con la configuración del encabezado HTTP que WebView2 envía a los accept-language sitios web.

La ScriptLocale propiedad permite que la aplicación host establezca la configuración regional predeterminada para todas las Intl API de JavaScript y otras API de JavaScript que dependen de ella, como Intl.DateTimeFormat(), que afecta al formato de cadena en formatos de fecha y hora.

Nueva ventana

WebView2 proporciona funcionalidad para controlar la función window.open()JavaScript.

Cerrar la ventana.

WebView2 proporciona funcionalidad para controlar la función window.close()JavaScript.

Título del documento

La aplicación puede detectar cuándo ha cambiado el título del documento de nivel superior actual.

Favicon

En WebView2, puedes establecer un icono de favoritos para un sitio web o recibir una notificación cuando cambie.

Seguridad y privacidad

Prevención de seguimiento

La prevención de seguimiento permite a la aplicación host controlar el nivel de prevención de seguimiento del control WebView2 asociado al perfil de usuario.

SmartScreen

SmartScreen de Microsoft Defender ("SmartScreen") está habilitado de forma predeterminada. La IsReputationCheckingRequired propiedad controla si SmartScreen está habilitado.

Si no deshabilitas SmartScreen, debes notificar a todos los usuarios que tu software incluye SmartScreen de Microsoft Defender y recopila y envía la información del usuario a Microsoft tal como se describe en la Declaración de privacidad de Microsoft y en SmartScreen en Datos de usuario y privacidad en Microsoft Edge.

Vea también:

Informes de bloqueo personalizados

Si se bloquea algún proceso WebView2, se crean uno o varios archivos de minivolcado y se envían a Microsoft para su diagnóstico. Use esta API para personalizar los informes de bloqueo al ejecutar diagnósticos y realizar análisis.

  • Para evitar que se envíen volcados de memoria a Microsoft, establezca la IsCustomCrashReportingEnabled propiedad en false.
  • Para buscar volcados de memoria y realizar la personalización con ellos, utilice la CrashDumpFolderPath propiedad.

Vea también:

Extensiones del explorador

La aplicación puede insertar un control WebView2 que use una extensión de Microsoft Edge. Una extensión de Microsoft Edge es una pequeña aplicación que los desarrolladores usan para agregar o modificar características de Microsoft Edge para mejorar la experiencia de navegación de un usuario.

Vea también:

Administración de procesos

Obtén información sobre los procesos WebView2 en ejecución, los procesos que salen y los procesos con errores, para que la aplicación pueda tomar medidas en consecuencia.

Información del proceso del marco

La API Frame Process Info, que incluye GetProcessExtendedInfos, proporciona una colección de instantáneas de todos los fotogramas que se ejecutan activamente en el proceso del procesador asociado. Esta API permite que la aplicación detecte qué parte de WebView2 está consumiendo recursos, como la memoria o el uso de CPU.

Habilitar el procesamiento en segundo plano y la compatibilidad sin conexión (API de trabajo WebView2)

Las API de trabajo de WebView2 permiten que las aplicaciones host interactúen con los trabajos web para descargar tareas del subproceso principal, mejorar la capacidad de respuesta y admitir operaciones en segundo plano. Entre estos trabajos web se incluyen los trabajos dedicados, los trabajos compartidos y los trabajos de servicio.

Estas API proporcionan:

  • Eventos del ciclo de vida: Supervisar la creación y destrucción de trabajadores.
  • Interfaces de mensajería: Comuníquese con los trabajadores mediante PostMessage and WebMessageReceived; específicamente:
    • CoreWebView2ServiceWorker.PostWebMessageAsJson
    • CoreWebView2ServiceWorker.PostWebMessageAsString
    • CoreWebView2DedicatedWorker.PostWebMessageAsJson
    • CoreWebView2DedicatedWorker.PostWebMessageAsString
    • CoreWebView2ServiceWorker.WebMessageReceived
    • CoreWebView2DedicatedWorker.WebMessageReceived
    • chrome.webview.postMessage
    • No: chrome.webview.postMessageWithAdditionalObjects
  • Administración de trabajadores: Consultar y recuperar registros e instancias de trabajo.

Navegar por las páginas y administrar el contenido cargado

A través del control WebView2, la aplicación puede administrar la navegación a las páginas web y administrar el contenido que se carga en las páginas web.

Administrar el contenido cargado en WebView2

Estas API cargan, detienen la carga y vuelven a cargar contenido en WebView2. El contenido que se carga puede ser:

  • Contenido de una dirección URL.
  • Una cadena de HTML.
  • Contenido local a través del nombre de host virtual a la asignación de carpetas locales.
  • Contenido de una solicitud de red construida.

Vea también:

Los métodos de historial permiten la navegación hacia atrás y hacia adelante en WebView2 y los eventos de historial proporcionan información sobre los cambios en el historial y en el origen actual de WebView2.

NavigationKind obtiene el tipo de navegación de cada navegación, como Atrás/Adelante, Recargar o navegación a un nuevo documento.

Bloquear la navegación no deseada

El NavigationStarting evento permite a la aplicación cancelar la navegación a direcciones URL especificadas en WebView2, incluidos los fotogramas.

Con NavigationStarting y los otros eventos de navegación, se puede informar a la aplicación del estado de navegación en WebView2. Una navegación es el proceso para cargar una nueva dirección URL.

Vea también:

Administrar solicitudes de red en WebView2

El WebResourceRequested evento permite que la aplicación intercepte y anule todas las solicitudes de red en WebView2. El WebResourceResponseReceived evento permite a la aplicación supervisar la solicitud enviada y la respuesta recibida de la red.

Vea también:

Registro de esquemas personalizados

Permite CustomSchemeRegistration el registro de esquemas personalizados en WebView2 para que la aplicación pueda controlar el WebResourceRequested evento de las solicitudes a esas direcciones URL de esquema personalizado y navegar por WebView2 hasta dichas direcciones URL.

Certificados de cliente

En WebView2, puede usar la API de certificado de cliente para seleccionar el certificado de cliente en el nivel de aplicación. Esta API le permite:

  • Muestre una interfaz de usuario al usuario, si lo desea.
  • Sustituye el mensaje de diálogo del certificado de cliente predeterminado.
  • Consultar los certificados mediante programación.
  • Seleccione un certificado de la lista para que responda al servidor, cuando WebView2 realiza una solicitud a un servidor HTTP que necesita un certificado de cliente para la autenticación HTTP.

Certificados de servidor

En WebView2, puede usar la API de certificado de servidor para confiar en el certificado TLS del servidor en el nivel de aplicación. De esta forma, la aplicación host puede representar la página sin preguntar al usuario sobre el error TLS, o la aplicación host puede cancelar automáticamente la solicitud.

Iniciar un esquema de URI externo

Iniciar un esquema URI que esté registrado con el sistema operativo.

iframes

Los iframes le permiten insertar otras páginas web en su propia página web. En WebView2 puede:

  • Averiguar cuándo se crean los iframes.
  • Averigüe cuándo navegan los iframes.
  • Permitir la omisión de las opciones de fotograma x.

Vea también:

Autenticación

La aplicación puede controlar la autenticación básica mediante el control WebView2. La autenticación básica es un enfoque de autenticación específico que forma parte del protocolo HTTP.

Vea también:

Representar WebView2 en aplicaciones que no son de marco

Use estas API para configurar el sistema de representación WebView2 si la aplicación host no usa un marco de interfaz de usuario. Esta configuración de representación controla cómo WebView2 representa la salida en la aplicación host y cómo WebView2 controla la entrada, el enfoque y la accesibilidad.

Cuándo usar estas API

  • Marco de interfaz de usuario : si usas un marco de interfaz de usuario para la aplicación, debes usar el elemento WebView2 que proporciona ese marco de interfaz de usuario, en lugar de usar estas API.

  • Sin marco de interfaz de usuario y sin uso de composición : si no usa un marco de interfaz de usuario para la aplicación (por ejemplo, si usa Win32 puro directamente) o si el marco de interfaz de usuario no tiene un elemento WebView2, debe crearlo CoreWebView2Controller y representarlo en la aplicación, mediante estas API en esta sección.

  • No hay un marco de interfaz de usuario y se usa la composición: si la interfaz de usuario de la aplicación se compila con DirectComposition o Windows.UI.Composition, debes usar CoreWebView2CompositionController estas API en lugar de usarlas; consulta Representación de WebView2 con composición, a continuación.

Tamaño, posicionamiento y visibilidad

CoreWebView2Controller toma un padre HWND. La Bounds propiedad cambia el tamaño y la posición de WebView2 con respecto al elemento primario HWND. La visibilidad de WebView2 se puede alternar con IsVisible.

Zoom

WebView2 ZoomFactor se usa para escalar solo el contenido web de la ventana. El escalado de la interfaz de usuario también se actualiza cuando el usuario amplía el contenido presionando Ctrl mientras gira la rueda del mouse.

Escala de rasterización

La API RasterizationScale escala toda la interfaz de usuario de WebView2, incluidos los menús contextuales, la información sobre herramientas y los elementos emergentes. La aplicación puede establecer si WebView2 debe detectar, supervisar los cambios de escala y actualizar automáticamente RasterizationScale. BoundsMode se usa para configurar si la propiedad Bounds se interpreta como píxeles sin procesar o DIP (que deben escalarse mediante RasterizationScale).

Foco y pestañas

El control WebView2 genera eventos para permitir que la aplicación sepa cuándo el control gana o pierde el foco. Para tabular (presionar la tecla Tab ), hay una API para mover el foco a WebView2 y un evento para WebView2 para solicitar a la aplicación que recupere el foco.

Ventana principal

WebView2 se puede asociar de nuevo a un identificador de ventana primario diferente (HWND). WebView2 también necesita una notificación cuando cambie la posición de la aplicación en la pantalla.

Aceleradores de teclado

Cuando WebView2 tiene el foco, recibe directamente la entrada del usuario. Es posible que una aplicación quiera interceptar y controlar determinadas combinaciones de teclas del acelerador (teclas de método abreviado) o deshabilitar los comportamientos normales de las teclas del acelerador del explorador.

Consulte también Habilitar o deshabilitar el navegador que responde a las teclas del acelerador (teclas de método abreviado), más arriba.

Color de fondo predeterminado

WebView2 puede especificar un color de fondo predeterminado. El color puede ser cualquier color opaco o transparente. Este color se usará si la página HTML no establece su propio color de fondo.

Vea también:

Representar WebView2 con composición

Para la representación WebView2 basada en la composición, se usa CoreWebView2Environment para crear un CoreWebView2CompositionControllerarchivo . CoreWebView2CompositionController proporciona las mismas API que CoreWebView2Controller, pero también incluye API para la representación basada en la composición.

Conexión al árbol visual

WebView2 puede conectar su árbol de composición a un IDCompositionVisual, IDCompositionTarget o Windows::UI::Composition::ContainerVisual.

Reenvío de entrada

La aplicación recibe la entrada espacial (mouse, táctil, lápiz) y debe enviarse a WebView2. WebView2 notifica a la aplicación cuándo debe actualizarse el cursor en función de la posición del ratón.

Permitir que los mensajes de eventos de entrada pasen por la ventana del explorador

Permite que los mensajes de eventos de entrada de usuario (teclado, mouse, función táctil o lápiz) pasen a través de la ventana del explorador, para ser recibidos por una ventana de proceso de la aplicación.

Arrastrar y soltar

Arrastrar desde un control WebView2 a otra aplicación se admite de forma predeterminada. Sin embargo, arrastrar a un control WebView2 requiere que cuando la aplicación host reciba un IDropTarget evento del sistema, la aplicación host reenvíe el evento al control WebView2. Arrastrar a un control WebView2 incluye operaciones de arrastrar y soltar que están completamente dentro de un control WebView2.

Use las siguientes API para reenviar IDropTarget eventos del sistema al control WebView2.

Accesibilidad

De forma predeterminada, WebView2 se mostrará en el árbol de accesibilidad como un elemento secundario del HWND principal, para las aplicaciones de Win32/C++. WebView2 proporciona una API para colocar mejor el contenido de WebView2 en relación con otros elementos de la aplicación.

No procede.

Opciones de entorno

Datos de usuario

Administre la carpeta de datos de usuario (UDF), que es una carpeta en el equipo del usuario. La UDF contiene datos relacionados con la aplicación host y WebView2. Las aplicaciones WebView2 usan carpetas de datos de usuario para almacenar datos del explorador, como cookies, permisos y recursos en caché.

Vea también:

Borrar datos de exploración:

Múltiples perfiles

Administrar varios perfiles en una única carpeta de datos de usuario.

Vea también:

Cree un objeto de opciones que defina un perfil:

Cree un control WebView2 que use el perfil:

Acceder y manipular el perfil:

Eliminar un perfil

La aplicación puede eliminar perfiles de usuario para un control de explorador web WebView2.

Vea también:

Selección del entorno de ejecución

La selección del tiempo de ejecución admite las pruebas previas a la versión y el autohospedaje. Al crear un entorno WebView2:

  • Para especificar un orden de búsqueda para los canales de vista previa del explorador, utilice la CoreWebView2EnvironmentOptions.ChannelSearchKind propiedad.
  • Para especificar los canales de vista previa del explorador que se buscan, utilice la CoreWebView2EnvironmentOptions.ReleaseChannels propiedad.

Vea también:

Rendimiento y depuración

Analice y depure el rendimiento, controle los eventos relacionados con el rendimiento y administre el uso de memoria para aumentar la capacidad de respuesta de la aplicación.

Destino de uso de memoria

Especifica niveles de consumo de memoria, como low o normal.

Protocolo DevTools de Chrome (CDP)

El protocolo DevTools de Chrome (CDP) proporciona API para instrumentar, inspeccionar, depurar y perfilar navegadores basados en Chromium. El protocolo DevTools de Chrome es la base para las DevTools de Microsoft Edge. Use el protocolo DevTools de Chrome para las características que no están implementadas en la plataforma WebView2.

Vea también:

Abrir:

Llamar:

Receptor:

Vea también

  • Se actualizó por última vez el