ChromiumWebBrowser Class

Important!!! This constructor exists as the WinForms designer requires a parameterless constructor, if you are instantiating an instance of this class in code then use the ChromiumWebBrowser(String, IRequestContext) constructor overload instead. Using this constructor in code is unsupported and you may experience NullReferenceException's when attempting to access some of the properties immediately after instantiation.

Initializes a new instance of the ChromiumWebBrowser class. **Important** - When using this constructor the Dock property will default to Fill.

Initializes a new instance of the ChromiumWebBrowser class. **Important** - When using this constructor the Dock property will default to Fill.

Gets the AccessibleObject assigned to the control.

Gets or sets the default action description of the control for use by accessibility client applications.

Gets or sets the description of the control used by accessibility client applications.

Gets or sets the name of the control used by accessibility client applications.

Gets or sets the accessible role of the control

Activates browser upon creation, the default value is false. Prior to version 73 the default behaviour was to activate browser on creation (Equivalent of setting this property to true). To restore this behaviour set this value to true immediately after you create the ChromiumWebBrowser instance. https://github.com/chromiumembedded/cef/issues/1856

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).

Gets or sets a value indicating whether the control can accept data that the user drags onto it.

Gets or sets the edges of the container to which a control is bound and determines how a control is resized with its parent.

Implement IAudioHandler to handle audio events.

Gets or sets where this control is scrolled to in ScrollControlIntoView(Control).

This property is not relevant for this class.

Gets or sets the background color for the control.

Gets or sets the background image displayed in the control.

Gets or sets the background image layout as defined in the ImageLayout enumeration.

Gets or sets the BindingContext for the control.

Gets the distance, in pixels, between the bottom edge of the control and the top edge of its container's client area.

Gets or sets the size and location of the control including its nonclient elements, in pixels, relative to the parent control.

Get access to the core IBrowser instance. Maybe null if the underlying CEF Browser has not yet been created or if this control has been disposed. Check IsDisposed before accessing.

IntPtr that represents the CefBrowser Hwnd Used for sending messages to the browser e.g. resize

Gets or sets the browser settings.

Gets a value indicating whether the ImeMode property can be set to an active value, to enable IME support.

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

Gets a value indicating whether the control can receive focus.

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).

Determines if events can be raised on the control.

Gets a value indicating whether the control can be selected.

Gets or sets a value indicating whether the control has captured the mouse.

Gets or sets a value indicating whether the control causes validation to be performed on any controls that require validation when it receives focus.

Gets the rectangle that represents the client area of the control.

Gets or sets the height and width of the client area of the control.

Gets the name of the company or creator of the application containing the control.

Gets the IContainer that contains the Component.

Gets a value indicating whether the control, or one of its child controls, currently has the input focus.

Gets or sets the shortcut menu associated with the control.

Gets or sets the ContextMenuStrip associated with this control.

Gets the collection of controls contained within the control.

Gets a value indicating whether the control has been created.

Gets the required creation parameters when the control handle is created.

Gets or sets the cursor that is displayed when the mouse pointer is over the control.

Gets the data bindings for the control.

Gets or sets the default cursor for the control.

Gets the default Input Method Editor (IME) mode supported by the control.

Gets the space, in pixels, that is specified by default between controls.

Gets the length and height, in pixels, that is specified as the default maximum size of a control.

Gets the length and height, in pixels, that is specified as the default minimum size of a control.

Gets the internal spacing, in pixels, of the contents of a control.

Gets the default size of the control.

Gets a value that indicates whether the Component is currently in design mode.

Implement IDialogHandler and assign to handle dialog events.

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

Gets the rectangle that represents the display area of the control.

Gets a value indicating whether the base Control class is in the process of disposing.

Gets or sets which control borders are docked to its parent control and determines how a control is resized with its parent.

Gets or sets a value indicating whether this control should redraw its surface using a secondary buffer to reduce or prevent flicker.

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

Implement IDragHandler and assign to handle events related to dragging.

Gets or sets a value indicating whether the control can respond to user interaction.

Gets the list of event handlers that are attached to this Component.

Implement IFindHandler to handle events related to find results.

Manually implement Focused because cef does not implement it.

The IFocusHandler for this ChromiumWebBrowser.

Gets or sets the font of the text displayed by the control.

Gets or sets the height of the font of the control.

Gets or sets the foreground color of the control.

Implement IFrameHandler to handle frame events.

Gets the window handle that the control is bound to.

Gets a value indicating whether the control contains one or more child controls.

Gets or sets the height of the control.

Gets or sets the Input Method Editor (IME) mode of the control.

Gets or sets the IME mode of a control.

Gets a value indicating whether the caller must call an invoke method when making method calls to the control because the caller is on a different thread than the one the control was created on.

Gets or sets a value indicating whether the control is visible to accessibility applications.

Set to true while handing an activating WM_ACTIVATE message. MUST ONLY be cleared by DefaultFocusHandler.

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

Gets a value indicating whether this instance is disposed.

Gets a value indicating whether the control has a handle associated with it.

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

Gets a value indicating whether the control is mirrored.

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.

Gets a cached instance of the control's layout engine.

Gets or sets the distance, in pixels, between the left edge of the control and the left edge of its container's client area.

Implement ILifeSpanHandler and assign to handle events related to popups.

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

Gets or sets the coordinates of the upper-left corner of the control relative to the upper-left corner of its container.

Gets or sets the space between controls.

Gets or sets the size that is the upper limit that GetPreferredSize(Size) can specify.

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

Gets or sets the size that is the lower limit that GetPreferredSize(Size) can specify.

Gets or sets the name of the control.

Gets or sets padding within the control.

Gets or sets the parent container of the control.

By default when OnHandleDestroyed(EventArgs) is called the underlying Browser Hwnd is only parked (moved to a temp parent) when RecreatingHandle is true, there are a few other cases where parking of the control is desired, you can force parking by setting this property to true.

Implement IPermissionHandler to handle events related to permission requests.

Gets the size of a rectangular area into which the control can fit.

Gets the product name of the assembly containing the control.

Gets the version of the assembly containing the control.

Gets a value indicating whether the control is currently re-creating its handle.

Gets or sets the window region associated with the control.

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

This property is now obsolete.

Gets or sets the request context.

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

Gets or sets a value indicating whether the control redraws itself when resized.

Implement IResourceRequestHandlerFactory and control the loading of resources

Gets the distance, in pixels, between the right edge of the control and the left edge of its container's client area.

Gets or sets a value indicating whether control's elements are aligned to support locales using right-to-left fonts.

Gets a value that determines the scaling of child controls.

Gets a value indicating whether the control should display focus rectangles.

Gets a value indicating whether the user interface is in the appropriate state to show or hide keyboard accelerators.

Gets or sets the site of the control.

Gets or sets the height and width of the control.

Gets or sets the tab order of the control within its container.

Gets or sets a value indicating whether the user can give the focus to this control using the TAB key.

Gets or sets the object that contains data about the control.

Gets or sets the text associated with this control.

The text that will be displayed as a ToolTip

Gets or sets the distance, in pixels, between the top edge of the control and the top edge of its container's client area.

Gets the parent control that is not parented by another Windows Forms control. Typically, this is the outermost Form that the control is contained in.

ParentFormMessageInterceptor hooks the Form handle and forwards the move/active messages to the browser, the default is true and should only be required when using MultiThreadedMessageLoop set to true.

Gets or sets a value indicating whether to use the wait cursor for the current control and all child controls.

Gets or sets a value indicating whether the control and all its child controls are displayed.

Gets or sets the width of the control.

This property is not relevant for this class.

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control.

Notifies the accessibility client applications of the specified AccessibleEvents for the specified child control .

Executes the specified delegate asynchronously on the thread that the control's underlying handle was created on.

Executes the specified delegate asynchronously with the specified arguments, on the thread that the control's underlying handle was created on.

Brings the control to the front of the z-order.

Capture page screenshot.

Retrieves a value indicating whether the specified control is a child of the control.

Creates a new accessibility object for the control.

Override this method to handle creation of WindowInfo. This method can be used to customise aspects of browser creation including configuration of settings such as ExStyle. Window Activation is disabled by default, you can re-enable it by overriding and removing the WS_EX_NOACTIVATE style from ExStyle.

Forces the creation of the visible control, including the creation of the handle and any visible child controls.

Creates a new instance of the control collection for the control.

Creates the Graphics for the control.

Creates a handle for the control.

Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

Sends the specified message to the default window procedure.

Destroys the handle associated with the control.

Releases all resources used by the Component.

If not in design mode; Releases unmanaged and - optionally - managed resources for the ChromiumWebBrowser

Begins a drag-and-drop operation.

Supports rendering to the specified bitmap.

Retrieves the return value of the asynchronous operation represented by the IAsyncResult passed.

Determines whether the specified object is equal to the current object.

Releases unmanaged resources and performs other cleanup operations before the Component is reclaimed by garbage collection.

Retrieves the form that the control is on.

Sets input focus to the control.

Gets the ChromiumWebBrowser associated with a specific IBrowser instance.

Retrieves the specified AccessibleObject.

Retrieves a value indicating how a control will behave when its AutoSize property is enabled.

Returns the current IBrowser Instance

Retrieves the child control that is located at the specified coordinates.

Retrieves the child control that is located at the specified coordinates, specifying whether to ignore child controls of a certain type.

Returns the next ContainerControl up the control's chain of parent controls.

Size of scrollable area in CSS pixels

Serves as the default hash function.

Retrieves the current lifetime service object that controls the lifetime policy for this instance.

Retrieves the next control forward or back in the tab order of child controls.

Retrieves the size of a rectangular area into which a control can be fitted.

Retrieves the bounds within which the control is scaled.

Returns an object that represents a service provided by the Component or by its Container.

Retrieves the value of the specified control style bit for the control.

Determines if the control is a top-level control.

Gets the Type of the current instance.

Conceals the control from the user.

Obtains a lifetime service object to control the lifetime policy for this instance.

Called after the control has been added to another container.

Invalidates the entire surface of the control and causes the control to be redrawn.

Invalidates a specific region of the control and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control.

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

Invalidates the specified region of the control (adds it to the control's update region, which is the area that will be repainted at the next paint operation), and causes a paint message to be sent to the control. Optionally, invalidates the child controls assigned to the control.

Executes the specified delegate on the thread that owns the control's underlying window handle.

Executes the specified delegate, on the thread that owns the control's underlying window handle, with the specified list of arguments.

Raises the GotFocus event for the specified control.

Raises the LostFocus event for the specified control.

Raises the Click event for the specified control.

Raises the Paint event for the specified control.

Raises the PaintBackground event for the specified control.

Determines if a character is an input character that the control recognizes.

Makes certain keys as Input keys when CefSettings.MultiThreadedMessageLoop = false

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

Creates a shallow copy of the current Object.

Creates a shallow copy of the current MarshalByRefObject object.

Raises the Invalidated event with a specified region of the control to invalidate.

Raises the AutoSizeChanged event.

Raises the BackColorChanged event.

Raises the BackgroundImageChanged event.

Raises the BackgroundImageLayoutChanged event.

Raises the BindingContextChanged event.

Raises the CausesValidationChanged event.

Raises the ChangeUICues event.

Raises the Click event.

Raises the ClientSizeChanged event.

Raises the ContextMenuChanged event.

Raises the ContextMenuStripChanged event.

Raises the ControlAdded event.

Raises the ControlRemoved event.

Raises the CreateControl method.

Raises the CursorChanged event.

Raises the DockChanged event.

Raises the DoubleClick event.

Raises the DragDrop event.

Raises the DragEnter event.

Raises the DragLeave event.

Raises the DragOver event.

Raises the EnabledChanged event.

Raises the Enter event.

Raises the FontChanged event.

Raises the ForeColorChanged event.

Raises the GiveFeedback event.

Raises the GotFocus event.

Raises the HandleCreated event.

Raises the HelpRequested event.

Raises the ImeModeChanged event.

Raises the Invalidated event.

Raises the KeyDown event.

Raises the KeyPress event.

Raises the KeyUp event.

Raises the Layout event.

Raises the Leave event.

Raises the LocationChanged event.

Raises the LostFocus event.

Raises the MarginChanged event.

Raises the MouseCaptureChanged event.

Raises the MouseClick event.

Raises the MouseDoubleClick event.

Raises the MouseDown event.

Raises the MouseEnter event.

Raises the MouseHover event.

Raises the MouseLeave event.

Raises the MouseMove event.

Raises the MouseUp event.

Raises the MouseWheel event.

Raises the Move event.

Notifies the control of Windows messages.

Raises the PaddingChanged event.

Raises the Paint event.

Paints the background of the control.

Raises the BackColorChanged event when the BackColor property value of the control's container changes.

Raises the BackgroundImageChanged event when the BackgroundImage property value of the control's container changes.

Raises the BindingContextChanged event when the BindingContext property value of the control's container changes.

Raises the ParentChanged event.

Raises the CursorChanged event.

Raises the EnabledChanged event when the Enabled property value of the control's container changes.

Raises the FontChanged event when the Font property value of the control's container changes.

Raises the ForeColorChanged event when the ForeColor property value of the control's container changes.

Raises the RightToLeftChanged event when the RightToLeft property value of the control's container changes.

Raises the VisibleChanged event when the Visible property value of the control's container changes.

Raises the PreviewKeyDown event.

Raises the Paint event.

Raises the QueryContinueDrag event.

Raises the RegionChanged event.

Raises the Resize event.

Raises the RightToLeftChanged event.

Called from OnAfterBrowserCreated(IBrowser) when we set focus to the CefBrowser instance via SetFocus(Boolean). Method is only called if the browser got focus via OnGotFocus(EventArgs) before the call to OnAfterBrowserCreated(IBrowser). Can be overridden to provide custom behaviour.

Raises the SizeChanged event.

Raises the StyleChanged event.

Raises the SystemColorsChanged event.

Raises the TabIndexChanged event.

Raises the TabStopChanged event.

Raises the TextChanged event.

Raises the Validated event.

Raises the Validating event.

Raises the VisibleChanged event.

Forces the control to apply layout logic to all its child controls.

Forces the control to apply layout logic to all its child controls.

Computes the location of the specified screen point into client coordinates.

Computes the location of the specified client point into screen coordinates.

Preprocesses keyboard or input messages within the message loop before they are dispatched.

Preprocesses keyboard or input messages within the message loop before they are dispatched.

Processes a command key.

Processes a dialog character.

Processes a dialog key.

Processes a key message and generates the appropriate control events.

Processes a keyboard message.

Previews a keyboard message.

Processes a mnemonic character.

Raises the appropriate drag event.

Raises the appropriate key event.

Raises the appropriate mouse event.

Raises the appropriate paint event.

Forces the re-creation of the handle for the control.

Computes the size and location of the specified screen rectangle in client coordinates.

Computes the size and location of the specified client rectangle in screen coordinates.

Forces the control to invalidate its client area and immediately redraw itself and any child controls.

Resets the BackColor property to its default value.

Causes a control bound to the BindingSource to reread all the items in the list and refresh their displayed values.

Resets the Cursor property to its default value.

Resets the Font property to its default value.

Resets the ForeColor property to its default value.

Resets the ImeMode property to its default value.

Resets the control to handle the MouseLeave event.

Resets the RightToLeft property to its default value.

Resets the Text property to its default value.

Resizes the browser to the specified width and height. If width and height are both 0 then the browser will be hidden and resource usage will be minimised.

Resumes usual layout logic.

Resumes usual layout logic, optionally forcing an immediate layout of pending layout requests.

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

Converts the specified ContentAlignment to the appropriate ContentAlignment to support right-to-left text.

Converts the specified HorizontalAlignment to the appropriate HorizontalAlignment to support right-to-left text.

Converts the specified LeftRightAlignment to the appropriate LeftRightAlignment to support right-to-left text.

Scales the control and any child controls.

Scales the control and all child controls by the specified scaling factor.

Scales the entire control and any child controls.

Scales a control's location, size, padding and margin.

This method is not relevant for this class.

Activates the control.

Activates a child control. Optionally specifies the direction in the tab order to select the control from.

Activates the next control.

Sends the control to the back of the z-order.

Sets a value indicating how a control will behave when its AutoSize property is enabled.

Sets the bounds of the control to the specified location and size.

Sets the specified bounds of the control to the specified location and size.

Performs the work of setting the specified bounds of this control.

Sets the size of the client area of the control.

Sets a specified ControlStyles flag to either true or false.

Sets the control as the top-level control.

Sets the control to the specified visible state.

Displays the control to the user.

Determines the size of the entire control from the height and width of its client area.

Temporarily suspends the layout logic for the control.

Returns a String containing the name of the Component, if any. This method should not be overridden.

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.

To control how Shutdown is called, this method will unsubscribe from ApplicationExit,

Causes the control to redraw the invalidated regions within its client area.

Updates the bounds of the control with the current size and location.

Updates the bounds of the control with the specified size and location.

Updates the bounds of the control with the specified size, location, and client size.

Forces the assigned styles to be reapplied to the control.

Updates the control in its parent's z-order.

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.

Processes Windows messages.

Occurs when the browser address changed. 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.

This event is not relevant for this class.

Occurs when the value of the BackColor property changes.

Occurs when the value of the BackgroundImage property changes.

Occurs when the BackgroundImageLayout property changes.

Occurs when the value of the BindingContext property changes.

Occurs when the value of the CausesValidation property changes.

Occurs when the focus or keyboard user interface (UI) cues change.

Occurs when the control is clicked.

Occurs when the value of the ClientSize property changes.

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).

Occurs when the value of the ContextMenu property changes.

Occurs when the value of the ContextMenuStrip property changes.

Occurs when a new control is added to the ControlControlCollection.

Occurs when a control is removed from the ControlControlCollection.

Occurs when the value of the Cursor property changes.

Occurs when the component is disposed by a call to the Dispose method.

Occurs when the value of the Dock property changes.

Occurs when the control is double-clicked.

Occurs when a drag-and-drop operation is completed.

Occurs when an object is dragged into the control's bounds.

Occurs when an object is dragged out of the control's bounds.

Occurs when an object is dragged over the control's bounds.

Occurs when the Enabled property value has changed.

Occurs when the control is entered.

Occurs when the Font property value changes.

Occurs when the ForeColor property value changes.

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 during a drag operation.

Occurs when the control receives focus.

Occurs when a handle is created for the control.

Occurs when the control's handle is in the process of being destroyed.

Occurs when the user requests help for a control.

Occurs when the ImeMode property has changed.

Occurs when a control's display requires redrawing.

Event called after the underlying CEF browser instance has been created. 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 message that originates from CefSharp.PostMessage

Occurs when a key is pressed while the control has focus.

Occurs when a key is pressed while the control has focus.

Occurs when a key is released while the control has focus.

Occurs when a control should reposition its child controls.

Occurs when the input focus leaves the control.

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 Location property value has changed.

Occurs when the control loses focus.

Occurs when the control's margin changes.

Occurs when the control loses mouse capture.

Occurs when the control is clicked by the mouse.

Occurs when the control is double clicked by the mouse.

Occurs when the mouse pointer is over the control and a mouse button is pressed.

Occurs when the mouse pointer enters the control.

Occurs when the mouse pointer rests on the control.

Occurs when the mouse pointer leaves the control.

Occurs when the mouse pointer is moved over the control.

Occurs when the mouse pointer is over the control and a mouse button is released.

Occurs when the mouse wheel moves while the control has focus.

Occurs when the control is moved.

Occurs when the control's padding changes.

Occurs when the control is redrawn.

Occurs when the Parent property value changes.

Occurs before the KeyDown event when a key is pressed while focus is on this control.

Occurs when AccessibleObject is providing help to accessibility applications.

Occurs during a drag-and-drop operation and enables the drag source to determine whether the drag-and-drop operation should be canceled.

Occurs when the value of the Region property changes.

Occurs when the control is resized.

Occurs when the RightToLeft property value changes.

Occurs when the Size property value changes.

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 control style changes.

Occurs when the system colors change.

Occurs when the TabIndex property value changes.

Occurs when the TabStop property value changes.

Occurs when the Text property value changes.

Occurs when the browser title changed. 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 control is finished validating.

Occurs when the control is validating.

Occurs when the Visible property value changes.

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.

Dispose of the DevToolsContext (if any). Used in conjunction with CefSharp.Dom

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.

Set the DevToolsContext property to null. Used in conjunction with CefSharp.Dom

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.