Control de navegador TsgcWebView2

Embeba un navegador Microsoft Edge WebView2 (Chromium) moderno y con todas las funciones dentro de sus aplicaciones VCL de Delphi. Coloque el componente visual en un formulario, navegue a cualquier URL, ejecute JavaScript, gestione cookies y descargas, todo desde código Delphi o C++ Builder nativo.

TsgcWebView2

Un componente VCL visual que envuelve Microsoft Edge WebView2 (Chromium). Establezca Parent y Align, apunte DefaultURL a una página y tendrá un navegador real embebido en su aplicación, con acceso completo a la interfaz COM cuando lo necesite.

Clase del componente

TsgcWebView2

Plataformas

Solo Windows

Edición

Standard / Professional / Enterprise

Coloque el componente y navegue

Coloque un TsgcWebView2 en un formulario, establezca Parent y Align, apunte DefaultURL a una página, luego invoque Navigate, ejecute JavaScript con ExecuteScript y reaccione a OnNavigationCompleted.

uses
  sgcWebView2;

var
  WebView2: TsgcWebView2;
begin
  WebView2 := TsgcWebView2.Create(Self);
  WebView2.Parent := Self;
  WebView2.Align := alClient;
  WebView2.DefaultURL := 'https://www.example.com';

  // navegar en tiempo de ejecución
  WebView2.Navigate('https://www.esegece.com');
end;

// ejecutar JavaScript de forma asíncrona (resultado en OnScriptExecuted)
procedure TForm1.Button1Click(Sender: TObject);
begin
  WebView2.ExecuteScript('document.title');
end;

// reaccionar cuando la página ha terminado de cargar
procedure TForm1.WebView2NavigationCompleted(Sender: TObject;
  aIsSuccess: Boolean; aWebErrorStatus: Integer);
begin
  if aIsSuccess then
    Caption := WebView2.DocumentTitle;
end;
// uses: sgcWebView2
TsgcWebView2 *WebView2 = new TsgcWebView2(this);
WebView2->Parent = this;
WebView2->Align = alClient;
WebView2->DefaultURL = "https://www.example.com";

// navegar en tiempo de ejecución
WebView2->Navigate("https://www.esegece.com");

// ejecutar JavaScript de forma asíncrona (resultado en OnScriptExecuted)
WebView2->ExecuteScript("document.title");

// manejador OnNavigationCompleted
void __fastcall TForm1::WebView2NavigationCompleted(TObject *Sender,
  bool aIsSuccess, int aWebErrorStatus)
{
  if (aIsSuccess)
    Caption = WebView2->DocumentTitle;
}
// namespace: esegece.sgcWebSockets
var webView2 = new TsgcWebView2();
webView2.Parent = this;
webView2.Align = DockStyle.Fill;
webView2.DefaultURL = "https://www.example.com";

// navegar en tiempo de ejecución
webView2.Navigate("https://www.esegece.com");

// ejecutar JavaScript de forma asíncrona (resultado en OnScriptExecuted)
webView2.ExecuteScript("document.title");

// manejador OnNavigationCompleted
webView2.OnNavigationCompleted += (sender, e) =>
{
  if (e.IsSuccess)
    Text = webView2.DocumentTitle;
};

Qué incluye

Una superficie WebView2 completa expuesta como propiedades, métodos y eventos Delphi nativos, con acceso COM directo a ICoreWebView2 para todo lo que aún no esté envuelto.

Navigate y NavigateToString cargan URLs o HTML en memoria, GoBack / GoForward recorren el historial, Reload / Stop controlan la carga, y NavigateWithPostData emite un método, cuerpo y cabeceras personalizados.

JavaScript

Ejecute scripts con ExecuteScript (asíncrono, resultado en OnScriptExecuted) o ExecuteScriptSync para un valor de retorno JSON. AddInitScript inyecta código en cada carga de página, y PostWebMessageAsJson / PostWebMessageAsString dialogan con la página, con las respuestas en OnWebMessageReceived.

Gestión de cookies

El CookieManager de solo lectura expone GetCookies, AddOrUpdateCookie, DeleteCookie y DeleteAllCookies para que pueda leer, establecer y borrar cookies de cualquier host desde código Delphi.

Descargas

Intercepte y rastree las descargas de archivos de principio a fin con OnDownloadStarting, OnDownloadProgress y OnDownloadCompleted. Cancele, redirija la ruta de destino o informe del progreso en su propia interfaz.

Ajustes y configuración

Ajuste el navegador embebido mediante Settings (ScriptEnabled, DevToolsEnabled, ContextMenuEnabled), establezca ZoomFactor, aísle el estado con UserDataFolder y fije un runtime de versión fija mediante BrowserExecutableFolder.

Avanzado

Guarde páginas con PrintToPdf / ShowPrintUI, capture una imagen con CapturePreviewToFile, sirva contenido local mediante SetVirtualHostNameToFolderMapping, abra Edge DevTools con OpenDevToolsWindow, silencie el audio y gestione los eventos de basic-auth y de certificado de servidor.

Requiere el Microsoft Edge WebView2 Runtime y WebView2Loader.dll colocado junto a su ejecutable. Solo Windows, Delphi 7 hasta Delphi 13.

Especificaciones y referencias

Fuentes autorizadas del motor que embebe este componente.

Documentación y Demos

Enlace directo a la referencia del componente, descarga el proyecto demo listo para ejecutar y la prueba gratuita.

Ayuda en línea — TsgcWebView2 Referencia completa de propiedades, métodos y eventos de este componente.
Proyecto demo — Demos\WebView2 Proyecto de ejemplo listo para ejecutar. Se incluye en el paquete sgcWebSockets — descarga la prueba gratuita más abajo.
Manual de usuario (PDF) Manual completo que cubre todos los componentes de la biblioteca.

¿Listo para embeber un navegador en su aplicación?

Descargue la prueba gratuita y embeba un navegador Edge/Chromium moderno en sus aplicaciones Delphi.