Platforms to show: All Mac Windows Linux Cross-Platform

WebView2

Control to use Microsoft WebView2 browser based on Chrome in Xojo.

• Classes
  • class WebView2BrowserMBS
    • method AddBrowserExtension(extensionFolderPath as String, theDelegate as AddBrowserExtensionCompletedMBS = nil)
    • method AddScriptToExecuteOnDocumentCreated(JavaScript as String, theDelegate as AddScriptToExecuteOnDocumentCreatedCompletedMBS = nil)
    • method AddWebResourceRequestedFilter(URL as String, resourceType as Integer)
    • method CanGoBack as Boolean
    • method CanGoForward as Boolean
    • method CapturePreview(theDelegate as CapturePreviewCompletedMBS, ImageFormat as Integer = 0)
    • method ClearSelection
    • method ClearVirtualHostNameToFolderMapping(hostName as String)
    • method Copy
    • method CreatePrintSettings as WebView2PrintSettingsMBS
    • method Cut
    • method ExecuteScript(JavaScript as String, theDelegate as ExecuteScriptCompletedMBS = nil)
    • method ExecuteScriptSync(JavaScript as String, byref ErrorCode as Integer) as String
    • method GetFavicon(theDelegate as FaviconCompletedMBS, ImageFormat as Integer = 0)
    • method GoBack
    • method GoForward
    • method HTMLText as String
    • method LoadHTML(HTML as String)
    • method LoadURL(URL as String)
    • method OpenDevToolsWindow
    • method Paste
    • method PlainText as String
    • method PostWebMessageAsJson(webMessageAsJson as String)
    • method PostWebMessageAsString(webMessageAsString as String)
    • method Print
    • method PrintToPdf(File as Folderitem, PrintSettings as WebView2PrintSettingsMBS = nil, theDelegate as PrintCompletedMBS = nil)
    • method PrintToPdf(Path as String, PrintSettings as WebView2PrintSettingsMBS = nil, theDelegate as PrintCompletedMBS = nil)
    • method Reload
    • method RemoveScriptToExecuteOnDocumentCreated(ID as String
    • method RemoveWebResourceRequestedFilter(URL as String, resourceType as Integer)
    • method SelectAll
    • method SetVirtualHostNameToFolderMapping(hostName as String, folderPath as String, accessKind as Integer)
    • method Stop
    • property areBrowserAcceleratorKeysEnabled as Boolean
    • property AreDefaultContextMenusEnabled as Boolean
    • property AreDefaultScriptDialogsEnabled as Boolean
    • property AreDevToolsEnabled as Boolean
    • property AreHostObjectsAllowed as Boolean
    • property BrowserVersionString as String
    • property ContainsFullScreenElement as Boolean
    • property ControllerHandle as Integer
    • property CookieManager as WebView2BrowserMBS
    • property DefaultBackgroundColor as Color
    • property DefaultDownloadFolderPath as String
    • property DocumentTitle as String
    • property EnvironmentHandle as Integer
    • property FaviconURI as String
    • property Handle as Integer
    • property HiddenPdfToolbarItems as Integer
    • property IsBuiltInErrorPageEnabled as Boolean
    • property IsDocumentPlayingAudio as Boolean
    • property IsGeneralAutofillEnabled as Boolean
    • property IsInPrivateModeEnabled as Boolean
    • property IsMuted as Boolean
    • property IsPasswordAutosaveEnabled as Boolean
    • property IsPinchZoomEnabled as Boolean
    • property IsScriptEnabled as Boolean
    • property IsStatusBarEnabled as Boolean
    • property IsSwipeNavigationEnabled as Boolean
    • property IsWebMessageEnabled as Boolean
    • property IsZoomControlEnabled as Boolean
    • property MemoryUsageTargetLevel as Integer
    • property PreferredColorScheme as Integer
    • property ProcessID as Integer
    • property ProfilePath as String
    • property SettingsHandle as Integer
    • property URL as String
    • property UserAgent as String
    • property ZoomFactor as Double
    • delegate AddBrowserExtensionCompletedMBS(Browser as WebView2BrowserMBS, extensionFolderPath as String, errorCode as Integer)
    • delegate AddScriptToExecuteOnDocumentCreatedCompletedMBS(Browser as WebView2BrowserMBS, JavaScript as String, ErrorCode as Integer, ID as String)
    • delegate CapturePreviewCompletedMBS(Browser as WebView2BrowserMBS, ImageFormat as Integer, ErrorCode as Integer, PictureData as String)
    • delegate ExecuteScriptCompletedMBS(Browser as WebView2BrowserMBS, JavaScript as String, ErrorCode as Integer, resultObjectAsJson as String)
    • delegate FaviconCompletedMBS(Browser as WebView2BrowserMBS, ImageFormat as Integer, ErrorCode as Integer, PictureData as String)
    • delegate PrintCompletedMBS(Browser as WebView2BrowserMBS, Path as String, errorCode as Integer, isSuccessful as boolean)
  • class WebView2CookieManagerMBS
    • method AddOrUpdateCookie(cookie as WebView2CookieMBS)
    • method Constructor
    • method Constructor(cookie as WebView2CookieMBS)
    • method CopyCookie(Cookie as WebView2CookieMBS) as WebView2CookieMBS
    • method CreateCookie(Name as String, Value as String, Domain as String, Path as String) as WebView2CookieMBS
    • method DeleteAllCookies
    • method DeleteCookie(cookie as WebView2CookieMBS)
    • method DeleteCookies(Name as String, URI as string)
    • method DeleteCookiesWithDomainAndPath(Name as String, Domain as string, Path as String)
    • method GetCookies(URI as String = "")
    • method GetCookiesSync(URI as String = "") as WebView2CookieMBS()
    • property Handle as Integer
    • event GotCookies(ErrorCode as Integer, Cookies() as WebView2CookieMBS)
  • class WebView2CookieMBS
    • method Constructor
    • property Domain as String
    • property Expires as Double
    • property Handle as Integer
    • property IsHttpOnly as Boolean
    • property IsSecure as Boolean
    • property IsSession as Boolean
    • property Name as String
    • property Path as String
    • property SameSite as Integer
    • property Value as String
  • class WebView2ExceptionMBS
  • class WebView2PrintSettingsMBS
    • method Constructor
    • property Collation as Integer
    • property ColorMode as Integer
    • property Copies as Integer
    • property Duplex as Integer
    • property FooterURI as String
    • property HeaderTitle as String
    • property MarginBottom as Double
    • property MarginLeft as Double
    • property MarginRight as Double
    • property MarginTop as Double
    • property Orientation as Integer
    • property PageHeight as Double
    • property PageRanges as String
    • property PagesPerSide as Integer
    • property PageWidth as Double
    • property PrinterName as String
    • property ScaleFactor as Double
    • property ShouldPrintBackgrounds as Boolean
    • property ShouldPrintHeaderAndFooter as Boolean
    • property ShouldPrintSelectionOnly as Boolean
  • class WebView2WindowFeaturesMBS
    • method Constructor
    • property HasPosition as Boolean
    • property HasSize as Boolean
    • property Height as Integer
    • property Left as Integer
    • property ShouldDisplayMenuBar as Boolean
    • property ShouldDisplayScrollBars as Boolean
    • property ShouldDisplayStatus as Boolean
    • property ShouldDisplayToolbar as Boolean
    • property Top as Integer
    • property Width as Integer
• Controls
  • control DesktopWebView2ControlMBS
    • method AddBrowserExtension(extensionFolderPath as String, tag as Variant = nil)
    • method AddScriptToExecuteOnDocumentCreated(JavaScript as String, tag as variant = nil)
    • method AddWebResourceRequestedFilter(URL as String, resourceType as Integer)
    • shared method AvailableCoreWebView2BrowserVersionString as string
    • method CanGoBack as Boolean
    • method CanGoForward as Boolean
    • method CapturePreview(ImageFormat as Integer = 0)
    • method ClearSelection
    • method ClearVirtualHostNameToFolderMapping(hostName as String)
    • method Copy
    • method CreatePrintSettings as WebView2PrintSettingsMBS
    • method Cut
    • method ExecuteScript(JavaScript as String, tag as variant = nil)
    • method ExecuteScriptSync(JavaScript as String, byref ErrorCode as Integer) as String
    • method GetFavicon(ImageFormat as Integer = 0)
    • method GoBack
    • method GoForward
    • method HTMLText as String
    • method LoadHTML(HTML as String)
    • method LoadURL(URL as String)
    • method MoveFocus(reason as integer = 0)
    • method OpenDevToolsWindow
    • method Paste
    • method PlainText as String
    • method PostWebMessageAsJson(webMessageAsJson as String)
    • method PostWebMessageAsString(webMessageAsString as String)
    • method Print
    • method PrintToPdf(File as FolderItem, PrintSettings as WebView2PrintSettingsMBS = nil)
    • method PrintToPdf(Path as String, PrintSettings as WebView2PrintSettingsMBS = nil)
    • method Reload
    • method RemoveScriptToExecuteOnDocumentCreated(ID as String
    • method RemoveWebResourceRequestedFilter(URL as String, resourceType as Integer)
    • method SelectAll
    • method SetVirtualHostNameToFolderMapping(hostName as String, folderPath as String, accessKind as Integer)
    • method Stop
    • property AdditionalBrowserArguments as String
    • property AllowSingleSignOnUsingOSPrimaryAccount as Boolean
    • property areBrowserAcceleratorKeysEnabled as Boolean
    • property AreBrowserExtensionsEnabled as Boolean
    • property AreDefaultContextMenusEnabled as Boolean
    • property AreDefaultScriptDialogsEnabled as Boolean
    • property AreDevToolsEnabled as Boolean
    • property AreHostObjectsAllowed as Boolean
    • property Browser as WebView2BrowserMBS
    • property BrowserExecutableFolder as String
    • property BrowserVersionString as String
    • property ContainsFullScreenElement as Boolean
    • property CookieManager as WebView2CookieManagerMBS
    • property DefaultBackgroundColor as Color
    • property DefaultDownloadFolderPath as String
    • property DocumentTitle as String
    • property FaviconURI as String
    • property HiddenPdfToolbarItems as Integer
    • property IsBuiltInErrorPageEnabled as Boolean
    • property IsDocumentPlayingAudio as Boolean
    • property IsGeneralAutofillEnabled as Boolean
    • property IsInPrivateModeEnabled as Boolean
    • property IsMuted as Boolean
    • property IsPasswordAutosaveEnabled as Boolean
    • property IsPinchZoomEnabled as Boolean
    • property IsScriptEnabled as Boolean
    • property IsStatusBarEnabled as Boolean
    • property IsSwipeNavigationEnabled as Boolean
    • property IsWebMessageEnabled as Boolean
    • property IsZoomControlEnabled as Boolean
    • property Language as String
    • property MemoryUsageTargetLevel as Integer
    • property PreferredColorScheme as Integer
    • property ProcessID as Integer
    • property ProfilePath as String
    • property TargetCompatibleBrowserVersion as String
    • property URL as String
    • property UserAgent as String
    • property UserDataFolder as String
    • property ZoomFactor as Double
    • event AddBrowserExtensionCompleted(extensionFolderPath as String, errorCode as Integer, Tag as Variant)
    • event AddScriptToExecuteOnDocumentCreatedCompleted(JavaScript as String, ErrorCode as Integer, ID as String, Tag as Variant)
    • event BasicAuthenticationRequested(URL as string, Challenge as String, byref UserName as String, byref Password as String, byref Cancel as boolean)
    • event CapturePreviewCompleted(ImageFormat as Integer, ErrorCode as Integer, PictureData as String)
    • event Closing
    • event Configure
    • event ConstructContextualMenu(base as DesktopMenuItem, x as Integer, y as Integer) As Boolean
    • event ContainsFullScreenElementChanged
    • event ContentLoading(isErrorPage as Boolean, NavigationID as UInt64)
    • event ContextualMenuItemSelected(selectedItem As DesktopMenuItem) As Boolean
    • event DocumentTitleChanged
    • event ExecuteScriptCompleted(JavaScript as String, ErrorCode as Integer, resultObjectAsJson as String, Tag as Variant)
    • event Failed(ErrorCode as Integer, ErrorMessage as String)
    • event FaviconChanged
    • event FaviconCompleted(ImageFormat as Integer, ErrorCode as Integer, PictureData as String)
    • event FocusLost
    • event FocusReceived
    • event FrameNavigationCompleted(isSuccess as Boolean, ErrorStatus as Integer, NavigationID as UInt64)
    • event FrameNavigationStarting(URL as String, IsUserInitiated as Boolean, IsRedirected as Boolean, NavigationID as UInt64) as Boolean
    • event HistoryChanged
    • event LaunchingExternalUriScheme(URI as String, InitiatingOrigin as String, IsUserInitiated as Boolean, byref Cancel as Boolean)
    • event MenuBarSelected
    • event NavigationCompleted(isSuccess as Boolean, ErrorStatus as Integer, NavigationID as UInt64)
    • event NavigationStarting(URL as String, IsUserInitiated as Boolean, IsRedirected as Boolean, NavigationID as UInt64) as Boolean
    • event NewWindowRequested(URL as String, IsUserInitiated as Boolean, WindowFeatures as WebView2WindowFeaturesMBS, byref NewWindow as Variant) as Boolean
    • event Opened
    • event Opening
    • event PermissionRequested(URL as String, PermissionKind as Integer, IsUserInitiated as Boolean, byref State as Integer)
    • event PrintCompleted(Path as String, errorCode as Integer, isSuccessful as boolean)
    • event ProcessFailed(processFailedKind as Integer)
    • event SourceChanged(isNewDocument as Boolean)
    • event WebMessageReceived(Source as String, webMessageAsJson as String, webMessageAsString as String)
    • event WindowCloseRequested
    • event ZoomFactorChanged
  • control WebView2ControlMBS
    • method AddBrowserExtension(extensionFolderPath as String, tag as Variant = nil)
    • method AddScriptToExecuteOnDocumentCreated(JavaScript as String, tag as variant = nil)
    • method AddWebResourceRequestedFilter(URL as String, resourceType as Integer)
    • shared method AvailableCoreWebView2BrowserVersionString as string
    • method CanGoBack as Boolean
    • method CanGoForward as Boolean
    • method CapturePreview(ImageFormat as Integer = 0)
    • method ClearSelection
    • method ClearVirtualHostNameToFolderMapping(hostName as String)
    • method Copy
    • method CreatePrintSettings as WebView2PrintSettingsMBS
    • method Cut
    • method ExecuteScript(JavaScript as String, tag as variant = nil)
    • method ExecuteScriptSync(JavaScript as String, byref ErrorCode as Integer) as String
    • method GetFavicon(ImageFormat as Integer = 0)
    • method GoBack
    • method GoForward
    • method HTMLText as String
    • method LoadHTML(HTML as String)
    • method LoadURL(URL as String)
    • method MoveFocus(reason as integer = 0)
    • method OpenDevToolsWindow
    • method Paste
    • method PlainText as String
    • method PostWebMessageAsJson(webMessageAsJson as String)
    • method PostWebMessageAsString(webMessageAsString as String)
    • method Print
    • method PrintToPdf(File as FolderItem, PrintSettings as WebView2PrintSettingsMBS = nil)
    • method PrintToPdf(Path as String, PrintSettings as WebView2PrintSettingsMBS = nil)
    • method Reload
    • method RemoveScriptToExecuteOnDocumentCreated(ID as String
    • method RemoveWebResourceRequestedFilter(URL as String, resourceType as Integer)
    • method SelectAll
    • method SetVirtualHostNameToFolderMapping(hostName as String, folderPath as String, accessKind as Integer)
    • method Stop
    • property AdditionalBrowserArguments as String
    • property AllowSingleSignOnUsingOSPrimaryAccount as Boolean
    • property areBrowserAcceleratorKeysEnabled as Boolean
    • property AreBrowserExtensionsEnabled as Boolean
    • property AreDefaultContextMenusEnabled as Boolean
    • property AreDefaultScriptDialogsEnabled as Boolean
    • property AreDevToolsEnabled as Boolean
    • property AreHostObjectsAllowed as Boolean
    • property Browser as WebView2BrowserMBS
    • property BrowserExecutableFolder as String
    • property BrowserVersionString as String
    • property ContainsFullScreenElement as Boolean
    • property CookieManager as WebView2CookieManagerMBS
    • property DefaultBackgroundColor as Color
    • property DefaultDownloadFolderPath as String
    • property DocumentTitle as String
    • property FaviconURI as String
    • property HiddenPdfToolbarItems as Integer
    • property IsBuiltInErrorPageEnabled as Boolean
    • property IsDocumentPlayingAudio as Boolean
    • property IsGeneralAutofillEnabled as Boolean
    • property IsInPrivateModeEnabled as Boolean
    • property IsMuted as Boolean
    • property IsPasswordAutosaveEnabled as Boolean
    • property IsPinchZoomEnabled as Boolean
    • property IsScriptEnabled as Boolean
    • property IsStatusBarEnabled as Boolean
    • property IsSwipeNavigationEnabled as Boolean
    • property IsWebMessageEnabled as Boolean
    • property IsZoomControlEnabled as Boolean
    • property Language as String
    • property MemoryUsageTargetLevel as Integer
    • property PreferredColorScheme as Integer
    • property ProcessID as Integer
    • property ProfilePath as String
    • property TargetCompatibleBrowserVersion as String
    • property URL as String
    • property UserAgent as String
    • property UserDataFolder as String
    • property ZoomFactor as Double
    • event AddBrowserExtensionCompleted(extensionFolderPath as String, errorCode as Integer, Tag as Variant)
    • event AddScriptToExecuteOnDocumentCreatedCompleted(JavaScript as String, ErrorCode as Integer, ID as String, Tag as Variant)
    • event BasicAuthenticationRequested(URL as string, Challenge as String, byref UserName as String, byref Password as String, byref Cancel as boolean)
    • event CapturePreviewCompleted(ImageFormat as Integer, ErrorCode as Integer, PictureData as String)
    • event Close
    • event Closing
    • event Configure
    • event ConstructContextualMenu(base as MenuItem, x as Integer, y as Integer) as Boolean
    • event ContainsFullScreenElementChanged
    • event ContentLoading(isErrorPage as Boolean, NavigationID as UInt64)
    • event ContextualMenuAction(hitItem as MenuItem) as Boolean
    • event DocumentTitleChanged
    • event EnableMenuItems
    • event ExecuteScriptCompleted(JavaScript as String, ErrorCode as Integer, resultObjectAsJson as String, Tag as Variant)
    • event Failed(ErrorCode as Integer, ErrorMessage as String)
    • event FaviconChanged
    • event FaviconCompleted(ImageFormat as Integer, ErrorCode as Integer, PictureData as String)
    • event FocusLost
    • event FocusReceived
    • event FrameNavigationCompleted(isSuccess as Boolean, ErrorStatus as Integer, NavigationID as UInt64)
    • event FrameNavigationStarting(URL as String, IsUserInitiated as Boolean, IsRedirected as Boolean, NavigationID as UInt64) as Boolean
    • event GotFocus
    • event HistoryChanged
    • event LaunchingExternalUriScheme(URI as String, InitiatingOrigin as String, IsUserInitiated as Boolean, byref Cancel as Boolean)
    • event LostFocus
    • event MenuBarSelected
    • event NavigationCompleted(isSuccess as Boolean, ErrorStatus as Integer, NavigationID as UInt64)
    • event NavigationStarting(URL as String, IsUserInitiated as Boolean, IsRedirected as Boolean, NavigationID as UInt64) as Boolean
    • event NewWindowRequested(URL as String, IsUserInitiated as Boolean, WindowFeatures as WebView2WindowFeaturesMBS, byref NewWindow as Variant) as Boolean
    • event Open
    • event Opened
    • event Opening
    • event PermissionRequested(URL as String, PermissionKind as Integer, IsUserInitiated as Boolean, byref State as Integer)
    • event PrintCompleted(Path as String, errorCode as Integer, isSuccessful as boolean)
    • event ProcessFailed(processFailedKind as Integer)
    • event SourceChanged(isNewDocument as Boolean)
    • event WebMessageReceived(Source as String, webMessageAsJson as String, webMessageAsString as String)
    • event WindowCloseRequested
    • event ZoomFactorChanged
• Examples
  • /WinFrameworks/WebView2/WebView2BrowserMBS test
  • /WinFrameworks/WebView2/WebView2 Test
• Blog Entries
  • Xojo 2026r2 released
  • MBS Xojo Plugins, version 26.3pr3
  • News from the MBS Xojo Plugins Version 26.0
  • News from the MBS Xojo Plugins in Version 25.1
  • MonkeyBread Software Releases the MBS Xojo Plugins in version 24.5
  • WebView2 for Xojo upgrades
  • MonkeyBread Software Releases the MBS Xojo Plugins in version 23.4
  • News from the MBS Xojo Plugins in version 21.5
  • New desktop controls
  • MonkeyBread Software Releases the MBS Xojo Plugins in version 21.4

Release notes

• Version 26.4
  • Added ZoomFactor, DefaultBackgroundColor, EnvironmentHandle and ControllerHandle properties to WebView2BrowserMBS class.
  • Added PrintToPdf variant taking Folderitem for the path for WebView2ControlMBS and WebView2BrowserMBS classes.
• Version 26.3
  • Added WebView2BrowserMBS class.
  • Added Browser and IsInPrivateModeEnabled properties to WebView2ControlMBS class.
  • Added WebView2BrowserMBS method to HTMLViewer class.
• Version 26.2
  • Added MoveFocus method to WebView2ControlMBS control.
• Version 26.0
  • Added LaunchingExternalUriScheme event to WebView2ControlMBS control.
• Version 25.5
  • Added PreferredColorScheme property and related constants to WebView2ControlMBS class.
  • Added ProfilePath and DefaultDownloadFolderPath properties to WebView2ControlMBS class.
• Version 25.4
  • Added FaviconChanged event to WebView2ControlMBS control.
  • Added FaviconURI property to WebView2ControlMBS control.
  • Added GetFavicon method and FaviconCompleted event to WebView2ControlMBS control.
• Version 25.1
  • Added Failed event to WebView2ControlMBS control to report when a WebView2 could not be created.
• Version 25.0
  • Added BasicAuthenticationRequested event for WebView2ControlMBS control.
  • Fixed an issue with WebView2ControlMBS control not initializing sometimes.
• Version 24.5
  • Added AddBrowserExtension method to WebView2ControlMBS control.
  • Added IsDocumentPlayingAudio and IsMuted properties to WebView2ControlMBS control.

The items on this page are in the following plugins: MBS WinFrameworks Plugin.