TsgcWebView2 Browser Control

Bed een moderne, volledig uitgeruste Microsoft Edge WebView2 (Chromium)-browser in je Delphi VCL-toepassingen in. Plaats het visuele component op een form, navigeer naar elke URL, voer JavaScript uit, beheer cookies en downloads, allemaal vanuit native Delphi- of C++ Builder-code.

TsgcWebView2

Een visueel VCL-component dat Microsoft Edge WebView2 (Chromium) omhult. Stel Parent en Align in, richt DefaultURL op een pagina en je hebt een echte browser ingebed in je app, met volledige COM-interface-toegang wanneer je die nodig hebt.

Componentklasse

TsgcWebView2

Platforms

Alleen Windows

Editie

Standard / Professional / Enterprise

Plaats het component, navigeer

Plaats een TsgcWebView2 op een form, stel Parent en Align in, richt DefaultURL op een pagina, roep daarna Navigate aan, voer JavaScript uit met ExecuteScript en reageer op OnNavigationCompleted.

uses
  sgcWebView2;

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

  // navigeer tijdens runtime
  WebView2.Navigate('https://www.esegece.com');
end;

// voer JavaScript asynchroon uit (resultaat in OnScriptExecuted)
procedure TForm1.Button1Click(Sender: TObject);
begin
  WebView2.ExecuteScript('document.title');
end;

// reageer wanneer de pagina klaar is met laden
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";

// navigeer tijdens runtime
WebView2->Navigate("https://www.esegece.com");

// voer JavaScript asynchroon uit (resultaat 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";

// navigeer tijdens runtime
webView2.Navigate("https://www.esegece.com");

// voer JavaScript asynchroon uit (resultaat in OnScriptExecuted)
webView2.ExecuteScript("document.title");

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

Wat zit erin

Een volledig WebView2-oppervlak blootgesteld als native Delphi-eigenschappen, -methodes en -events, met directe ICoreWebView2 COM-toegang voor alles wat nog niet omhuld is.

Navigate en NavigateToString laden URL's of in-memory HTML, GoBack / GoForward doorlopen de geschiedenis, Reload / Stop sturen het laden aan en NavigateWithPostData stuurt een aangepaste methode, body en headers.

JavaScript

Voer scripts uit met ExecuteScript (asynchroon, resultaat in OnScriptExecuted) of ExecuteScriptSync voor een JSON-retourwaarde. AddInitScript injecteert code bij elke paginalading en PostWebMessageAsJson / PostWebMessageAsString communiceren met de pagina, met antwoorden in OnWebMessageReceived.

De alleen-lezen CookieManager stelt GetCookies, AddOrUpdateCookie, DeleteCookie en DeleteAllCookies beschikbaar zodat je cookies voor elke host kunt lezen, instellen en wissen vanuit Delphi-code.

Downloads

Onderschep en volg bestandsdownloads van begin tot eind met OnDownloadStarting, OnDownloadProgress en OnDownloadCompleted. Annuleer, verleg het doelpad of rapporteer de voortgang in je eigen UI.

Instellingen & configuratie

Stem de ingebedde browser af via Settings (ScriptEnabled, DevToolsEnabled, ContextMenuEnabled), stel ZoomFactor in, isoleer de status met UserDataFolder en pin een fixed-version-runtime via BrowserExecutableFolder.

Geavanceerd

Bewaar pagina's met PrintToPdf / ShowPrintUI, maak een screenshot met CapturePreviewToFile, serveer lokale content via SetVirtualHostNameToFolderMapping, open Edge DevTools met OpenDevToolsWindow, demp audio en verwerk basic-auth- en server-certificaat-events.

Vereist de Microsoft Edge WebView2 Runtime en WebView2Loader.dll naast je executable. Alleen Windows, Delphi 7 tot en met Delphi 13.

Specificaties & referenties

Gezaghebbende bronnen voor de engine die dit component inbedt.

Documentatie & demo's

Deep-link naar de componentreferentie, pak het kant-en-klare demoproject en download de proefversie.

Online-help — TsgcWebView2 Volledige eigenschap-, methode- en eventreferentie voor dit component.
Demoproject — Demos\WebView2 Kant-en-klaar voorbeeldproject. Wordt meegeleverd met het sgcWebSockets-pakket — download hieronder de proefversie.
Gebruikershandleiding (PDF) Uitgebreide handleiding die elk component in de bibliotheek behandelt.

Klaar om een browser in je app in te bedden?

Download de gratis proefversie en bed een moderne Edge/Chromium-browser in je Delphi-toepassingen in.