TsgcWebView2 Tarayıcı Kontrolü

Delphi VCL uygulamalarınızın içine modern, tam özellikli bir Microsoft Edge WebView2 (Chromium) tarayıcısı gömün. Görsel bileşeni bir forma bırakın, herhangi bir URL'ye gidin, JavaScript çalıştırın, çerezleri ve indirmeleri yönetin, hepsi yerel Delphi veya C++ Builder kodundan.

TsgcWebView2

Microsoft Edge WebView2'yi (Chromium) saran görsel bir VCL bileşeni. Parent ve Align ayarlayın, DefaultURL'yi bir sayfaya yönlendirin ve uygulamanıza gömülü gerçek bir tarayıcıya sahip olun, ihtiyaç duyduğunuzda tam COM arayüzü erişimiyle.

Bileşen sınıfı

TsgcWebView2

Platformlar

Yalnızca Windows

Sürüm

Standard / Professional / Enterprise

Bileşeni bırakın, gezinin

Bir forma TsgcWebView2 bırakın, Parent ve Align ayarlayın, DefaultURL'yi bir sayfaya yönlendirin, ardından Navigate çağırın, ExecuteScript ile JavaScript çalıştırın ve OnNavigationCompleted olayına tepki verin.

uses
  sgcWebView2;

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

  // navigate at runtime
  WebView2.Navigate('https://www.esegece.com');
end;

// run JavaScript asynchronously (result in OnScriptExecuted)
procedure TForm1.Button1Click(Sender: TObject);
begin
  WebView2.ExecuteScript('document.title');
end;

// react when the page has finished loading
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";

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

// run JavaScript asynchronously (result 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";

// navigate at runtime
webView2.Navigate("https://www.esegece.com");

// run JavaScript asynchronously (result in OnScriptExecuted)
webView2.ExecuteScript("document.title");

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

İçeriğinde neler var

Yerel Delphi özellikleri, metotları ve olayları olarak sunulan tam bir WebView2 yüzey alanı, henüz sarmalanmamış her şey için doğrudan ICoreWebView2 COM erişimiyle.

Gezinme

Navigate ve NavigateToString URL'leri veya bellek içi HTML'yi yükler, GoBack / GoForward geçmişte gezinir, Reload / Stop yüklemeyi kontrol eder ve NavigateWithPostData özel bir metot, gövde ve başlıklar gönderir.

JavaScript

Komut dosyalarını ExecuteScript (asenkron, sonuç OnScriptExecuted içinde) veya JSON dönüş değeri için ExecuteScriptSync ile çalıştırın. AddInitScript her sayfa yüklemesinde kod enjekte eder ve PostWebMessageAsJson / PostWebMessageAsString sayfayla konuşur, yanıtlar OnWebMessageReceived içinde gelir.

Çerez yönetimi

Salt okunur CookieManager, GetCookies, AddOrUpdateCookie, DeleteCookie ve DeleteAllCookies sunar, böylece Delphi kodundan herhangi bir ana bilgisayar için çerezleri okuyabilir, ayarlayabilir ve temizleyebilirsiniz.

İndirmeler

Dosya indirmelerini OnDownloadStarting, OnDownloadProgress ve OnDownloadCompleted ile uçtan uca yakalayın ve izleyin. İptal edin, hedef yolu yeniden yönlendirin veya kendi arayüzünüzde ilerlemeyi bildirin.

Ayarlar ve yapılandırma

Gömülü tarayıcıyı Settings (ScriptEnabled, DevToolsEnabled, ContextMenuEnabled) aracılığıyla ayarlayın, ZoomFactor belirleyin, durumu UserDataFolder ile yalıtın ve BrowserExecutableFolder aracılığıyla sabit sürümlü bir çalışma zamanını sabitleyin.

Gelişmiş

Sayfaları PrintToPdf / ShowPrintUI ile kaydedin, CapturePreviewToFile ile bir ekran görüntüsü alın, yerel içeriği SetVirtualHostNameToFolderMapping aracılığıyla sunun, Edge DevTools'u OpenDevToolsWindow ile açın, sesi kapatın ve basic-auth ile sunucu sertifikası olaylarını işleyin.

Microsoft Edge WebView2 Runtime ve yürütülebilir dosyanızın yanına yerleştirilmiş WebView2Loader.dll gerektirir. Yalnızca Windows, Delphi 7'den Delphi 13'e kadar.

Spesifikasyonlar ve referanslar

Bu bileşenin gömdüğü motor için yetkili kaynaklar.

Belgeler ve Demolar

Bileşen referansına doğrudan bağlanın, kullanıma hazır demo projesini alın ve denemeyi indirin.

Çevrimiçi Yardım — TsgcWebView2 Bu bileşen için tam özellik, metot ve olay referansı.
Demo Projesi — Demos\WebView2 Kullanıma hazır örnek proje. sgcWebSockets paketi içinde gelir — aşağıdan denemeyi indirin.
Kullanıcı Kılavuzu (PDF) Kütüphanedeki her bileşeni kapsayan kapsamlı kılavuz.

Uygulamanıza Bir Tarayıcı Gömmeye Hazır mısınız?

Ücretsiz denemeyi indirin ve Delphi uygulamalarınıza modern bir Edge/Chromium tarayıcısı gömün.