Kontrolka przeglądarki TsgcWebView2

Osadź nowoczesną, w pełni funkcjonalną przeglądarkę Microsoft Edge WebView2 (Chromium) wewnątrz aplikacji Delphi VCL. Upuść wizualny komponent na formularz, nawiguj do dowolnego URL, uruchamiaj JavaScript, zarządzaj ciasteczkami i pobieraniami, wszystko z natywnego kodu Delphi lub C++ Builder.

TsgcWebView2

Wizualny komponent VCL, który opakowuje Microsoft Edge WebView2 (Chromium). Ustaw Parent i Align, skieruj DefaultURL na stronę, a otrzymasz prawdziwą przeglądarkę osadzoną w swojej aplikacji, z pełnym dostępem do interfejsu COM, gdy go potrzebujesz.

Klasa komponentu

TsgcWebView2

Platformy

Tylko Windows

Edycja

Standard / Professional / Enterprise

Upuść komponent, nawiguj

Upuść TsgcWebView2 na formularz, ustaw Parent i Align, skieruj DefaultURL na stronę, następnie wywołaj Navigate, uruchom JavaScript za pomocą ExecuteScript i reaguj na OnNavigationCompleted.

uses
  sgcWebView2;

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

  // nawiguj w czasie wykonania
  WebView2.Navigate('https://www.esegece.com');
end;

// uruchom JavaScript asynchronicznie (wynik w OnScriptExecuted)
procedure TForm1.Button1Click(Sender: TObject);
begin
  WebView2.ExecuteScript('document.title');
end;

// reaguj, gdy strona zakończy ładowanie
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";

// nawiguj w czasie wykonania
WebView2->Navigate("https://www.esegece.com");

// uruchom JavaScript asynchronicznie (wynik w OnScriptExecuted)
WebView2->ExecuteScript("document.title");

// obsługa 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";

// nawiguj w czasie wykonania
webView2.Navigate("https://www.esegece.com");

// uruchom JavaScript asynchronicznie (wynik w OnScriptExecuted)
webView2.ExecuteScript("document.title");

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

Co jest w środku

Pełna powierzchnia WebView2 udostępniona jako natywne właściwości, metody i zdarzenia Delphi, z bezpośrednim dostępem COM do ICoreWebView2 dla wszystkiego, co nie zostało jeszcze opakowane.

Nawigacja

Navigate i NavigateToString ładują adresy URL lub kod HTML z pamięci, GoBack / GoForward przemieszczają się po historii, Reload / Stop kontrolują ładowanie, a NavigateWithPostData wysyła niestandardową metodę, treść i nagłówki.

JavaScript

Uruchamiaj skrypty za pomocą ExecuteScript (asynchronicznie, wynik w OnScriptExecuted) lub ExecuteScriptSync dla wartości zwracanej w formacie JSON. AddInitScript wstrzykuje kod przy każdym załadowaniu strony, a PostWebMessageAsJson / PostWebMessageAsString komunikują się ze stroną, z odpowiedziami w OnWebMessageReceived.

Zarządzanie ciasteczkami

Tylko do odczytu CookieManager udostępnia GetCookies, AddOrUpdateCookie, DeleteCookie i DeleteAllCookies, dzięki czemu możesz odczytywać, ustawiać i czyścić ciasteczka dla dowolnego hosta z kodu Delphi.

Pobierania

Przechwytuj i śledź pobieranie plików od początku do końca za pomocą OnDownloadStarting, OnDownloadProgress i OnDownloadCompleted. Anuluj, przekieruj ścieżkę docelową lub raportuj postęp we własnym interfejsie.

Ustawienia i konfiguracja

Dostrój wbudowaną przeglądarkę poprzez Settings (ScriptEnabled, DevToolsEnabled, ContextMenuEnabled), ustaw ZoomFactor, izoluj stan za pomocą UserDataFolder i przypnij środowisko uruchomieniowe o stałej wersji przez BrowserExecutableFolder.

Zaawansowane

Zapisuj strony za pomocą PrintToPdf / ShowPrintUI, wykonaj zrzut ekranu za pomocą CapturePreviewToFile, serwuj lokalną zawartość przez SetVirtualHostNameToFolderMapping, otwórz Edge DevTools za pomocą OpenDevToolsWindow, wycisz dźwięk i obsługuj zdarzenia uwierzytelniania basic-auth oraz certyfikatu serwera.

Wymaga środowiska uruchomieniowego Microsoft Edge WebView2 oraz pliku WebView2Loader.dll umieszczonego obok pliku wykonywalnego. Tylko Windows, Delphi 7 do Delphi 13.

Specyfikacje i odniesienia

Wiarygodne źródła dla silnika, który osadza ten komponent.

Dokumentacja i wersje demo

Przejdź bezpośrednio do dokumentacji komponentu, pobierz gotowy do uruchomienia projekt demo i wersję próbną.

Pomoc online — TsgcWebView2 Pełna dokumentacja właściwości, metod i zdarzeń tego komponentu.
Projekt demo — Demos\WebView2 Gotowy do uruchomienia projekt przykładowy. Dostarczany w pakiecie sgcWebSockets — pobierz wersję próbną poniżej.
Podręcznik użytkownika (PDF) Kompleksowy podręcznik obejmujący każdy komponent w bibliotece.

Gotowy, aby osadzić przeglądarkę w swojej aplikacji?

Pobierz bezpłatną wersję próbną i osadź nowoczesną przeglądarkę Edge/Chromium w swoich aplikacjach Delphi.