WebView2 Package

The WebView2Package wraps the Microsoft Edge WebView2 runtime and exposes it as an ordinary twinBASIC control. Drop a WebView2 onto a form and the running Edge engine renders web content inside it --- navigate to URLs, run JavaScript, intercept HTTP requests, post messages between BASIC and JavaScript, and print pages to PDF.

The package is a built-in package shipped with twinBASIC. See the WebView2 tutorials for how to reference it in a project, and worked samples.

Beyond the control itself, the package exposes a small set of wrapper objects that appear inside the control's event arguments --- the request / response pair on WebResourceRequested, the request-header collection on NavigationStarting, the environment-options object configured before Create --- together with the wv2… enumerations used to spell out option values.

Classes

• WebView2 -- the control: navigation, scripting, settings, deferral-aware events, and PDF / suspend / download / task-manager features controlled by the underlying Edge runtime
• WebView2EnvironmentOptions -- pre-creation configuration for the WebView2 environment (user-data folder, executable folder, locale, tracking-prevention, …); reached via the control's EnvironmentOptions property
• WebView2Header -- one HTTP header (Name / Value); the element type yielded by header iteration
• WebView2HeadersCollection -- enumerable wrapper used by For Each over request / response headers
• WebView2Request -- the request side of a WebResourceRequested event -- Method, Uri, Headers, and the request body as bytes or UTF-8 text
• WebView2RequestHeaders -- mutable request-header collection passed to NavigationStarting and reached via WebView2Request.Headers
• WebView2Response -- the response side of a WebResourceRequested event -- StatusCode, ReasonPhrase, Headers, and the body as bytes or UTF-8 text
• WebView2ResponseHeaders -- mutable response-header collection reached via WebView2Response.Headers

Enumerations

• wv2DefaultDownloadCornerAlign -- anchors the built-in download-progress dialog to one corner of the control
• wv2ErrorStatus -- reason a navigation failed; reported by NavigationComplete
• wv2HostResourceAccessKind -- access policy for a virtual hostname registered with SetVirtualHostNameToFolderMapping
• wv2KeyEventKind -- the kind of accelerator-key keyboard message in AcceleratorKeyPressed
• wv2PermissionKind -- device or browser capability a page is asking permission to use; passed by PermissionRequested
• wv2PermissionState -- the host's decision (grant / deny / default) on a PermissionRequested event
• wv2PrintOrientation -- page orientation passed to PrintToPdf
• wv2ProcessFailedKind -- which of the external WebView2 processes failed; reported by ProcessFailed
• wv2ScriptDialogKind -- which JavaScript-dialog primitive is opening; passed by ScriptDialogOpening
• wv2WebResourceContext -- kind of HTTP request a filter registered with AddWebResourceRequestedFilter should match

Types

• COREWEBVIEW2_PHYSICAL_KEY_STATUS -- decoded WM_KEYDOWN / WM_KEYUP lParam bit-fields; delivered via the AcceleratorKeyPressed event

Tutorials

• Getting started -- adding the package references and dropping a control onto a form
• Customize the UserDataFolder -- relocating the runtime's working folder for hosted scenarios (Office add-ins, kiosk installs)
• Re-entrancy -- what the control's deferred-event machinery handles automatically, and the AddObject synchronous-vs-deferred trade-off
• Building a browser shell -- address bar, back / forward / reload, zoom, PDF export
• Hosting local web assets -- serve HTML / JS / CSS from a project resource folder, without an HTTP server
• JavaScript interop -- the three bridges between BASIC and the page: host objects, messages, and scripted calls
• Driving Monaco from twinBASIC -- case study combining everything above