TsgcWebView2 Browser-Steuerelement

Betten Sie einen modernen, voll ausgestatteten Microsoft Edge WebView2 (Chromium)-Browser in Ihre Delphi-VCL-Anwendungen ein. Platzieren Sie die visuelle Komponente auf einem Formular, navigieren Sie zu beliebigen URLs, führen Sie JavaScript aus, verwalten Sie Cookies und Downloads, alles aus nativem Delphi- oder C++-Builder-Code.

TsgcWebView2

Eine visuelle VCL-Komponente, die Microsoft Edge WebView2 (Chromium) kapselt. Setzen Sie Parent und Align, richten Sie DefaultURL auf eine Seite, und Sie haben einen echten Browser in Ihre App eingebettet, mit vollem Zugriff auf die COM-Schnittstelle, wenn Sie ihn benötigen.

Komponentenklasse

TsgcWebView2

Plattformen

Nur Windows

Edition

Standard / Professional / Enterprise

Komponente einfügen, navigieren

Platzieren Sie ein TsgcWebView2 auf einem Formular, setzen Sie Parent und Align, richten Sie DefaultURL auf eine Seite, rufen Sie anschließend Navigate auf, führen Sie JavaScript mit ExecuteScript aus und reagieren Sie auf OnNavigationCompleted.

uses
  sgcWebView2;

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

  // zur Laufzeit navigieren
  WebView2.Navigate('https://www.esegece.com');
end;

// JavaScript asynchron ausführen (Ergebnis in OnScriptExecuted)
procedure TForm1.Button1Click(Sender: TObject);
begin
  WebView2.ExecuteScript('document.title');
end;

// reagieren, wenn die Seite vollständig geladen wurde
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";

// zur Laufzeit navigieren
WebView2->Navigate("https://www.esegece.com");

// JavaScript asynchron ausführen (Ergebnis in OnScriptExecuted)
WebView2->ExecuteScript("document.title");

// OnNavigationCompleted-Handler
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";

// zur Laufzeit navigieren
webView2.Navigate("https://www.esegece.com");

// JavaScript asynchron ausführen (Ergebnis in OnScriptExecuted)
webView2.ExecuteScript("document.title");

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

Was steckt drin

Die vollständige WebView2-Funktionsfläche als native Delphi-Eigenschaften, -Methoden und -Events, mit direktem ICoreWebView2-COM-Zugriff für alles, was noch nicht gekapselt ist.

Navigate und NavigateToString laden URLs oder In-Memory-HTML, GoBack / GoForward bewegen sich durch den Verlauf, Reload / Stop steuern das Laden und NavigateWithPostData setzt eine benutzerdefinierte Methode, einen Body und Header ab.

JavaScript

Führen Sie Skripte mit ExecuteScript (asynchron, Ergebnis in OnScriptExecuted) oder ExecuteScriptSync für einen JSON-Rückgabewert aus. AddInitScript injiziert Code bei jedem Seitenaufbau und PostWebMessageAsJson / PostWebMessageAsString kommunizieren mit der Seite, mit Antworten in OnWebMessageReceived.

Der schreibgeschützte CookieManager stellt GetCookies, AddOrUpdateCookie, DeleteCookie und DeleteAllCookies bereit, sodass Sie Cookies für jeden Host aus Delphi-Code lesen, setzen und löschen können.

Downloads

Fangen Sie Dateidownloads von Anfang bis Ende ab und verfolgen Sie sie mit OnDownloadStarting, OnDownloadProgress und OnDownloadCompleted. Brechen Sie ab, leiten Sie den Zielpfad um oder zeigen Sie den Fortschritt in Ihrer eigenen Oberfläche an.

Einstellungen & Konfiguration

Stimmen Sie den eingebetteten Browser über Settings (ScriptEnabled, DevToolsEnabled, ContextMenuEnabled) ab, setzen Sie ZoomFactor, isolieren Sie den Zustand mit UserDataFolder und binden Sie eine Fixed-Version-Runtime über BrowserExecutableFolder ein.

Erweitert

Speichern Sie Seiten mit PrintToPdf / ShowPrintUI, erstellen Sie mit CapturePreviewToFile einen Screenshot, liefern Sie lokale Inhalte über SetVirtualHostNameToFolderMapping aus, öffnen Sie die Edge-DevTools mit OpenDevToolsWindow, schalten Sie den Ton stumm und behandeln Sie Basic-Auth- und Serverzertifikat-Events.

Erfordert die Microsoft Edge WebView2 Runtime und WebView2Loader.dll neben Ihrer ausführbaren Datei. Nur Windows, Delphi 7 bis Delphi 13.

Spezifikationen & Referenzen

Maßgebliche Quellen für die Engine, die diese Komponente einbettet.

Dokumentation & Demos

Springen Sie direkt zur Komponentenreferenz, holen Sie sich das einsatzbereite Demoprojekt und laden Sie die Testversion herunter.

Online-Hilfe — TsgcWebView2 Vollständige Referenz zu Eigenschaften, Methoden und Events dieser Komponente.
Demoprojekt — Demos\WebView2 Einsatzbereites Beispielprojekt. Im sgcWebSockets-Paket enthalten — laden Sie unten die Testversion herunter.
Benutzerhandbuch (PDF) Ausführliches Handbuch zu allen Komponenten der Bibliothek.

Bereit, einen Browser in Ihre App einzubetten?

Laden Sie die kostenlose Testversion herunter und betten Sie einen modernen Edge/Chromium-Browser in Ihre Delphi-Anwendungen ein.