IWpfWebBrowser Interface

The address (URL) which the browser control is currently displaying. Will automatically be updated as the user navigates to another page (e.g. by clicking on a link).

Implement IAudioHandler to handle audio events.

Navigates to the previous page in the browser history. Will automatically be enabled/disabled depending on the browser state.

Returns the current IBrowser Instance or null. IBrowser is the the underlying CefBrowser instance and provides access to frames/browserhost etc.

A flag that indicates if you can execute javascript in the main frame. Flag is set to true in IRenderProcessMessageHandler.OnContextCreated. and false in IRenderProcessMessageHandler.OnContextReleased

A flag that indicates whether the state of the control current supports the GoBack action (true) or not (false).

A flag that indicates whether the state of the control currently supports the GoForward action (true) or not (false).

Command which cleans up the Resources used by the ChromiumWebBrowser

Copy selected text to the clipboard.

Cut selected text to the clipboard.

Implement IDialogHandler and assign to handle dialog events.

Gets the Dispatcher associated with this instance.

Implement IDisplayHandler and assign to handle events related to browser display state.

Implement IDownloadHandler and assign to handle events related to downloading files.

Implement IDragHandler and assign to handle events related to dragging.

Implement IFindHandler to handle events related to find results.

Gets or sets a value that indicates whether focus can be set to this element.

Implement IFocusHandler and assign to handle events related to the browser component's focus

Navigates to the next page in the browser history. Will automatically be enabled/disabled depending on the browser state.

Implement IFrameHandler to handle frame events.

A flag that indicates whether the WebBrowser is initialized (true) or not (false).

A flag that indicates whether the WebBrowser has been disposed () or not ()

Gets a value that indicates whether this element is enabled in the user interface (UI).

Gets a value that indicates whether this element has keyboard focus.

Gets a value that indicates whether keyboard focus is anywhere inside the element bounds, including if keyboard focus is inside the bounds of any visual child elements.

A flag that indicates whether the control is currently loading one or more web pages (true) or not (false).

Gets a value that indicates whether the mouse is captured to this element.

Gets a value that indicates whether the mouse pointer is over this element in the strictest hit testing sense.

Gets a value that indicates whether the mouse pointer is located over this element (including visual children elements that are inside its bounds).

Gets a value that indicates whether the stylus is captured to this element.

Gets a value that indicates whether the stylus is over this element in the strictest hit testing sense.

Gets a value that indicates whether the stylus is located over this element (or over visual child elements that are inside its bounds).

The javascript object repository, one repository per ChromiumWebBrowser instance.

Implement IJsDialogHandler and assign to handle events related to JavaScript Dialogs.

Implement IKeyboardHandler and assign to handle events related to key press.

Implement ILifeSpanHandler and assign to handle events related to popups.

Implement ILoadHandler and assign to handle events related to browser load status.

Implement IContextMenuHandler and assign to handle events related to the browser context menu

Paste text from the clipboard.

Implement IPermissionHandler to handle events related to permission requests.

Prints the current browser contents.

Redo last action.

Reloads the content of the current page. Will automatically be enabled/disabled depending on the browser state.

Implement IRenderProcessMessageHandler and assign to handle messages from the render process.

Gets the custom request context assigned to this browser instance If no instance was assigned this will be null and the global request context will have been used for this browser. You can access the global request context through Cef.GetGlobalRequestContext()

Implement IRequestHandler and assign to handle events related to browser requests.

Implement IResourceRequestHandlerFactory and control the loading of resources

Select all text.

Stops loading the current page.

The title of the web page being currently displayed.

Toggles the audio mute for the current browser.

The text that will be displayed as a ToolTip

Undo last action.

Opens up a new program window (using the default text editor) where the source code of the currently displayed web page is shown.

Increases the zoom level.

The zoom level at which the browser control is currently displaying. Can be set to 0 to clear the zoom level (resets to default zoom level).

The increment at which the ZoomLevel property will be incremented/decremented.

Decreases the zoom level.

Resets the zoom level to the default. (100%)

Adds a routed event handler for a specific routed event to an element.

Attempts to force capture of the mouse to this element.

Attempts to force capture of the stylus to this element.

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Attempts to give focus to the IWebBrowser control.

Returns the current CEF Browser Instance

Size of scrollable area in CSS pixels

Loads the specified url in the Main Frame. If IsDisposed is true then the method call will be ignored. Same as calling LoadUrl(String)

Loads the specified url in the Main Frame. Same as calling Load(String)

Load the url in the main frame of the browser

Raises the routed event that is specified by the RoutedEvent property within the provided RoutedEventArgs.

Releases the mouse capture, if this element holds the capture.

Releases the stylus capture, if this element holds the capture.

Removes all instances of the specified routed event handler from this element.

Try and get a reference to the IBrowser instance that matches the browserId. Primarily used for geting a reference to the IBrowser used by popups.

Wait for the Browser to finish loading the initial web page.

This resolves when the browser navigates to a new URL or reloads. It is useful for when you run code which will indirectly cause the browser to navigate. A common use case would be when executing javascript that results in a navigation. e.g. clicks a link This must be called before executing the action that navigates the browser. It may not resolve correctly if called after.

Event handler for receiving Javascript console messages being sent from web pages. It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread. It is unwise to block on this thread for any length of time as your browser will become unresponsive and/or hang.. To access UI elements you'll need to Invoke/Dispatch onto the UI Thread. (The exception to this is when you're running with settings.MultiThreadedMessageLoop = false, then they'll be the same thread).

Event handler that will get called when the browser is done loading a frame. Multiple frames may be loading at the same time. Sub-frames may start or continue loading after the main frame load has ended. This method will always be called for all frames irrespective of whether the request completes successfully. It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread. It is unwise to block on this thread for any length of time as your browser will become unresponsive and/or hang.. To access UI elements you'll need to Invoke/Dispatch onto the UI Thread.

Event handler that will get called when the browser begins loading a frame. Multiple frames may be loading at the same time. Sub-frames may start or continue loading after the main frame load has ended. This method may not be called for a particular frame if the load request for that frame fails. For notification of overall browser load status use OnLoadingStateChange instead. It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread. It is unwise to block on this thread for any length of time as your browser will become unresponsive and/or hang.. To access UI elements you'll need to Invoke/Dispatch onto the UI Thread.

Occurs when the keyboard is focused on this element.

Occurs when the element captures the mouse.

Occurs when the element captures the stylus.

Event handler that will get called when the message that originates from CefSharp.PostMessage

Occurs when a key is pressed while the keyboard is focused on this element.

Occurs when a key is released while the keyboard is focused on this element.

Event handler that will get called when the resource load for a navigation fails or is canceled. It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread. It is unwise to block on this thread for any length of time as your browser will become unresponsive and/or hang.. To access UI elements you'll need to Invoke/Dispatch onto the UI Thread.

Event handler that will get called when the Loading state has changed. This event will be fired twice. Once when loading is initiated either programmatically or by user action, and once when loading is terminated due to completion, cancellation of failure. It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread. It is unwise to block on this thread for any length of time as your browser will become unresponsive and/or hang.. To access UI elements you'll need to Invoke/Dispatch onto the UI Thread.

Occurs when the keyboard is no longer focused on this element.

Occurs when this element loses mouse capture.

Occurs when this element loses stylus capture.

Occurs when the mouse pointer enters the bounds of this element.

Occurs when the mouse pointer leaves the bounds of this element.

Occurs when the left mouse button is pressed while the mouse pointer is over the element.

Occurs when the left mouse button is released while the mouse pointer is over the element.

Occurs when the mouse pointer moves while the mouse pointer is over the element.

Occurs when the right mouse button is pressed while the mouse pointer is over the element.

Occurs when the right mouse button is released while the mouse pointer is over the element.

Occurs when the mouse wheel moves while the mouse pointer is over this element.

Raised every time OnPaint(PaintElementType, Rect, IntPtr, Int32, Int32) is called. You can access the underlying buffer, though it's preferable to either override OnPaint(Boolean, Rect, IntPtr, Int32, Int32) or implement your own IRenderHandler as there is no outwardly accessible locking (locking is done within the default IRenderHandler implementations). It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread

Occurs when the keyboard is focused on this element.

Occurs when a key is pressed while the keyboard is focused on this element.

Occurs when a key is released while the keyboard is focused on this element.

Occurs when the keyboard is no longer focused on this element.

Occurs when the left mouse button is pressed while the mouse pointer is over the element.

Occurs when the left mouse button is released while the mouse pointer is over the element.

Occurs when the mouse pointer moves while the mouse pointer is over the element.

Occurs when the right mouse button is pressed while the mouse pointer is over the element.

Occurs when the right mouse button is released while the mouse pointer is over the element.

Occurs when the mouse wheel moves while the mouse pointer is over this element.

Occurs when the stylus button is pressed down while the stylus is over this element.

Occurs when the stylus button is released while the stylus is over this element.

Occurs when the stylus touches the digitizer while over this element.

Occurs when the stylus moves over an element, but without touching the digitizer.

Occurs when the stylus is close enough to the digitizer to be detected.

Occurs when the stylus moves while the stylus is over the element.

Occurs when the stylus is too far from the digitizer to be detected.

Occurs when one of several stylus gestures are detected, for example, Tap or Drag.

Occurs when the stylus is raised off the digitizer while over this element.

Occurs when this element gets text in a device-independent manner.

Event handler for changes to the status message. It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread. It is unwise to block on this thread for any length of time as your browser will become unresponsive and/or hang. To access UI elements you'll need to Invoke/Dispatch onto the UI Thread. (The exception to this is when you're running with settings.MultiThreadedMessageLoop = false, then they'll be the same thread).

Occurs when the stylus button is pressed while the stylus is over this element.

Occurs when the stylus button is released while the stylus is over this element.

Occurs when the stylus touches the digitizer while over this element.

Occurs when the stylus cursor enters the bounds of the element.

Occurs when the stylus moves over an element, but without touching the digitizer.

Occurs when the stylus is close enough to the digitizer to be detected.

Occurs when the stylus cursor leaves the bounds of the element.

Occurs when the stylus cursor moves over the element.

Occurs when the stylus is too far from the digitizer to be detected.

Occurs when one of several stylus gestures are detected, for example, Tap or Drag.

Occurs when the stylus is raised off the digitizer while over this element.

Occurs when this element gets text in a device-independent manner.

Raised every time OnVirtualKeyboardRequested(IBrowser, TextInputMode) is called. It's important to note this event is fired on a CEF UI thread, which by default is not the same as your application UI thread

Add the specified word to the spelling dictionary.

Navigates back, must check CanGoBack before calling this method.

Explicitly close the developer tools window if one exists for this browser instance.

Execute Copy on the focused frame.

Execute Cut on the focused frame.

Execute Delete on the focused frame.

Manually call https://docs.microsoft.com/en-us/windows/win32/api/winuser/nf-winuser-destroywindow passing in the handle returned from GetWindowHandle. This method can be used to manually close the underlying CefBrowser instance. This will avoid the WM_Close message that CEF sends by default to the top level window. (Which closes your application). This method should generally only be used in the WinForms version.

Make sure an object is bound in javascript. Executes against the main frame

Evaluate Javascript in the context of the MainFrame of the ChromiumWebBrowser. The script will be executed asynchronously and the method returns a Task encapsulating the response from the Javascript. The result of the script execution in javascript is Promise.resolve so even no promise values will be treated as a promise. Your javascript should return a value. The javascript will be wrapped in an Immediately Invoked Function Expression. When the promise either trigger then/catch this returned Task will be completed.

Evaluate some Javascript code in the context of this WebBrowser. The script will be executed asynchronously and the method returns a Task encapsulating the response from the Javascript This simple helper extension will encapsulate params in single quotes (unless int, uint, etc)

Evaluate Javascript code in the context of this WebBrowser using the specified timeout. The script will be executed asynchronously and the method returns a Task encapsulating the response from the Javascript This simple helper extension will encapsulate params in single quotes (unless int, uint, etc).

Evaluate Javascript in the context of this Browsers Main Frame. The script will be executed asynchronously and the method returns a Task encapsulating the response from the Javascript

Evaluate Javascript in the context of this Browsers Main Frame. The script will be executed asynchronously and the method returns a Task encapsulating the response from the Javascript

Execute a method call over the DevTools protocol. This is a more structured version of SendDevToolsMessage. ExecuteDevToolsMethod(IBrowserHost, Int32, String, JsonString) can only be called on the CEF UI Thread, this method can be called on any thread. See the DevTools protocol documentation at https://chromedevtools.github.io/devtools-protocol/ for details of supported methods and the expected parameters dictionary contents. See the SendDevToolsMessage documentation for additional usage information.

Execute Javascript in the context of this Browsers Main Frame. As the method name implies, the script will be executed asynchronously, and the method therefore returns before the script has actually been executed.

Execute Javascript code in the context of this Browser. As the method name implies, the script will be executed asynchronously, and the method therefore returns before the script has actually been executed. This simple helper extension will encapsulate params in single quotes (unless int, uint, etc)

Execute Javascript code in the context of this Browsers Main Frame. This extension method uses the LoadingStateChanged event. As the method name implies, the script will be executed asynchronously, and the method therefore returns before the script has actually been executed.

Search for text within the current page.

Navigates forward, must check CanGoForward before calling this method.

Shortcut method to get the browser IBrowserHost.

Gets the default cookie manager associated with the IChromiumWebBrowserBase instance.

Gets a new Instance of the DevTools client for the chromiumWebBrowser instance.

Returns the focused frame for the browser window.

Returns the main (top-level) frame for the browser window.

Gets the RequestContext associated with the IChromiumWebBrowserBase instance.

Retrieve the main frame's HTML source using a TaskTResult.

Retrieve the main frame's display text using a TaskTResult.

Retrieve the current NavigationEntry. Contains information like HttpStatusCode and SslStatus

Asynchronously gets the current Zoom Level.

Registers and loads a ResourceHandler that represents the HTML content.

Loads html as Data Uri See https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs for details If base64Encode is false then html will be Uri encoded.

Registers and loads a ResourceHandler that represents the HTML content.

Creates a new instance of IRequest with the specified Url and Method = POST and then calls LoadRequest(IRequest).

Execute Paste on the focused frame.

Opens a Print Dialog which if used (can be user cancelled) will print the browser contents.

Asynchronously prints the current browser contents to the PDF file specified. The caller is responsible for deleting the file when done.

Execute Redo on the focused frame.

Registers a Javascript object in this specific browser instance.

Register a ResourceHandler. Can only be used when browser.ResourceHandlerFactory is an instance of DefaultResourceHandlerFactory.

Reloads the page being displayed. This method will use data from the browser's cache, if available.

Reloads the page being displayed, optionally ignoring the cache (which means the whole page including all .css, .js etc. resources will be re-fetched).

If a misspelled word is currently selected in an editable node calling this method will replace it with the specified word.

Execute SelectAll on the focused frame.

Send a mouse wheel event to the browser.

An IWebBrowser extension method that sets the HasParent property used when passing a ChromiumWebBrowser instance to OnBeforePopup(IWebBrowser, IBrowser, IFrame, String, String, WindowOpenDisposition, Boolean, IPopupFeatures, IWindowInfo, IBrowserSettings, Boolean, IWebBrowser)

Set the Document Content for the Main Frame using DevTools Protocol.

Change the ZoomLevel to the specified value. Can be set to 0.0 to clear the zoom level.

Open developer tools in its own window.

Open DevTools using your own Control as the parent. If inspectElementAtX and/or inspectElementAtY are specified then the element at the specified (x,y) location will be inspected. For resize/moving to work correctly you will need to use the LifeSpanHandler implementation. (Set LifeSpanHandler to an instance of LifeSpanHandler)

Open DevTools using parentControl as the parent control. If inspectElementAtX and/or inspectElementAtY are specified then the element at the specified (x,y) location will be inspected. For resize/moving to work correctly you will need to use the LifeSpanHandler implementation. (Set LifeSpanHandler to an instance of LifeSpanHandler)

Download the file at url using IDownloadHandler.

Stops loading the current page.

Cancel all searches that are currently going on.

Toggles audio mute for the current browser. If the browser is null or has been disposed then this command will be a no-op.

Execute Undo on the focused frame.

Unregister a ResourceHandler. Can only be used when browser.ResourceHandlerFactory is an instance of DefaultResourceHandlerFactory.

Opens up a new program window (using the default text editor) where the source code of the currently displayed web page is shown.

Waits for a DOM element specified by the selector string to be added to or removed from the DOM. A simplified version of Puppeteer WaitForSelector. Uses a MutationObserver to wait for the element to become added or removed.