IWinFormsWebBrowser Interface |
Namespace: CefSharp.WinForms
The IWinFormsWebBrowser type exposes the following members.
Name | Description | |
---|---|---|
Address |
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).
(Inherited from IWebBrowser.) | |
AudioHandler |
Implement IAudioHandler to handle audio events.
(Inherited from IWebBrowser.) | |
CanExecuteJavascriptInMainFrame |
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
(Inherited from IWebBrowser.) | |
CanGoBack |
A flag that indicates whether the state of the control current supports the GoBack action (true) or not (false).
(Inherited from IWebBrowser.) | |
CanGoForward |
A flag that indicates whether the state of the control currently supports the GoForward action (true) or not (false).
(Inherited from IWebBrowser.) | |
DialogHandler |
Implement IDialogHandler and assign to handle dialog events.
(Inherited from IWebBrowser.) | |
DisplayHandler |
Implement IDisplayHandler and assign to handle events related to browser display state.
(Inherited from IWebBrowser.) | |
DownloadHandler |
Implement IDownloadHandler and assign to handle events related to downloading files.
(Inherited from IWebBrowser.) | |
DragHandler |
Implement IDragHandler and assign to handle events related to dragging.
(Inherited from IWebBrowser.) | |
FindHandler |
Implement IFindHandler to handle events related to find results.
(Inherited from IWebBrowser.) | |
FocusHandler |
Implement IFocusHandler and assign to handle events related to the browser component's focus
(Inherited from IWebBrowser.) | |
IsBrowserInitialized |
A flag that indicates whether the WebBrowser is initialized (true) or not (false).
(Inherited from IWebBrowser.) | |
IsDisposed |
A flag that indicates whether the WebBrowser has been disposed () or not ()
(Inherited from IWebBrowser.) | |
IsLoading |
A flag that indicates whether the control is currently loading one or more web pages (true) or not (false).
(Inherited from IWebBrowser.) | |
JavascriptObjectRepository |
The javascript object repository, one repository per ChromiumWebBrowser instance.
(Inherited from IWebBrowser.) | |
JsDialogHandler |
Implement IJsDialogHandler and assign to handle events related to JavaScript Dialogs.
(Inherited from IWebBrowser.) | |
KeyboardHandler |
Implement IKeyboardHandler and assign to handle events related to key press.
(Inherited from IWebBrowser.) | |
LifeSpanHandler |
Implement ILifeSpanHandler and assign to handle events related to popups.
(Inherited from IWebBrowser.) | |
LoadHandler |
Implement ILoadHandler and assign to handle events related to browser load status.
(Inherited from IWebBrowser.) | |
MenuHandler |
Implement IContextMenuHandler and assign to handle events related to the browser context menu
(Inherited from IWebBrowser.) | |
RenderProcessMessageHandler |
Implement IRenderProcessMessageHandler and assign to handle messages from the render process.
(Inherited from IWebBrowser.) | |
RequestContext |
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()
(Inherited from IWebBrowser.) | |
RequestHandler |
Implement IRequestHandler and assign to handle events related to browser requests.
(Inherited from IWebBrowser.) | |
ResourceRequestHandlerFactory |
Implement IResourceRequestHandlerFactory and control the loading of resources
(Inherited from IWebBrowser.) | |
TooltipText |
The text that will be displayed as a ToolTip
(Inherited from IWebBrowser.) |
Name | Description | |
---|---|---|
Dispose | Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from IDisposable.) | |
Focus |
Attempts to give focus to the IWebBrowser control.
(Inherited from IWebBrowser.) | |
GetBrowser |
Returns the current CEF Browser Instance
(Inherited from IWebBrowser.) | |
Load |
Loads the specified URL.
(Inherited from IWebBrowser.) |
Name | Description | |
---|---|---|
AddressChanged |
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.
| |
ConsoleMessage |
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 your running with settings.MultiThreadedMessageLoop = false, then they'll be the same thread).
(Inherited from IWebBrowser.) | |
FrameLoadEnd |
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.
(Inherited from IWebBrowser.) | |
FrameLoadStart |
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.
(Inherited from IWebBrowser.) | |
JavascriptMessageReceived |
Event handler that will get called when the message that originates from CefSharp.PostMessage
(Inherited from IWebBrowser.) | |
LoadError |
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.
(Inherited from IWebBrowser.) | |
LoadingStateChanged |
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.
(Inherited from IWebBrowser.) | |
StatusMessage |
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 your running with settings.MultiThreadedMessageLoop = false, then they'll be the same thread).
(Inherited from IWebBrowser.) | |
TitleChanged |
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.
|
Name | Description | |
---|---|---|
AddWordToDictionary |
Add the specified word to the spelling dictionary.
(Defined by WebBrowserExtensions.) | |
Back |
Navigates back, must check CanGoBack before calling this method.
(Defined by WebBrowserExtensions.) | |
CloseDevTools |
Explicitly close the developer tools window if one exists for this browser instance.
(Defined by WebBrowserExtensions.) | |
Copy |
Execute Copy on the focused frame
(Defined by WebBrowserExtensions.) | |
Cut |
Execute Cut on the focused frame
(Defined by WebBrowserExtensions.) | |
Delete |
Execute Delete on the focused frame
(Defined by WebBrowserExtensions.) | |
EnsureObjectBoundAsync |
Make sure an object is bound in javascript. Executes against the main frame
(Defined by JavascriptBindingExtensions.) | |
EvaluateScriptAsync(String, NullableTimeSpan) | Overloaded. (Defined by WebBrowserExtensions.) | |
EvaluateScriptAsync(String, Object) | Overloaded.
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)
(Defined by WebBrowserExtensions.) | |
EvaluateScriptAsync(NullableTimeSpan, String, Object) | Overloaded.
Evaluate some 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).
(Defined by WebBrowserExtensions.) | |
ExecuteScriptAsync(String) | Overloaded.
Execute some Javascript code in the context of this WebBrowser. As the method name implies, the script will be
executed asynchronously, and the method therefore returns before the script has actually been executed.
(Defined by WebBrowserExtensions.) | |
ExecuteScriptAsync(String, Object) | Overloaded.
Execute some Javascript code in the context of this WebBrowser. 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)
(Defined by WebBrowserExtensions.) | |
ExecuteScriptAsyncWhenPageLoaded |
Execute Javascript code in the context of this WebBrowser. 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.
(Defined by WebBrowserExtensions.) | |
Find |
Search for text within the current page.
(Defined by WebBrowserExtensions.) | |
Forward |
Navigates forward, must check CanGoForward before calling this method.
(Defined by WebBrowserExtensions.) | |
GetBrowserHost |
Shortcut method to get the browser IBrowserHost
(Defined by WebBrowserExtensions.) | |
GetCookieManager |
Gets the default cookie manager associated with the IWebBrowser
(Defined by WebBrowserExtensions.) | |
GetFocusedFrame |
Returns the focused frame for the browser window.
(Defined by WebBrowserExtensions.) | |
GetMainFrame |
Returns the main (top-level) frame for the browser window.
(Defined by WebBrowserExtensions.) | |
GetSourceAsync |
Retrieve the main frame's HTML source using a TaskTResult.
(Defined by WebBrowserExtensions.) | |
GetTextAsync |
Retrieve the main frame's display text using a TaskTResult.
(Defined by WebBrowserExtensions.) | |
GetZoomLevelAsync |
Asynchronously gets the current Zoom Level.
(Defined by WebBrowserExtensions.) | |
LoadHtml(String, String) | Overloaded.
Registers and loads a ResourceHandler that represents the HTML content.
(Defined by WebBrowserExtensions.) | |
LoadHtml(String, Boolean) | Overloaded.
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
(Defined by WebBrowserExtensions.) | |
LoadHtml(String, String, Encoding, Boolean) | Overloaded.
Registers and loads a ResourceHandler that represents the HTML content.
(Defined by WebBrowserExtensions.) | |
LoadString |
Load the string contents with the specified dummy url. Web security restrictions may not behave as expected.
(Defined by WebBrowserExtensions.) | |
LoadUrlWithPostData |
Creates a new instance of IRequest with the specified Url and Method = POST
and then calls LoadRequest(IRequest).
LoadRequest(IRequest) can only be used if a renderer process already exists.
In newer versions initially loading about:blank no longer creates a renderer process. You
can load a Data Uri initially then call this method.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs
(Defined by WebBrowserExtensions.) | |
Paste |
Execute Paste on the focused frame
(Defined by WebBrowserExtensions.) | |
Opens a Print Dialog which if used (can be user cancelled) will print the browser contents.
(Defined by WebBrowserExtensions.) | ||
PrintToPdfAsync |
Asynchronously prints the current browser contents to the PDF file specified.
The caller is responsible for deleting the file when done.
(Defined by WebBrowserExtensions.) | |
Redo |
Execute Redo on the focused frame
(Defined by WebBrowserExtensions.) | |
RegisterAsyncJsObject | Asynchronously registers a Javascript object in this specific browser instance. Only methods of the object will be availabe. | |
RegisterJsObject |
Registers a Javascript object in this specific browser instance.
(Defined by WebBrowserExtensions.) | |
RegisterResourceHandler |
Register a ResourceHandler. Can only be used when browser.ResourceHandlerFactory is an instance of DefaultResourceHandlerFactory
(Defined by WebBrowserExtensions.) | |
Reload | Overloaded.
Reloads the page being displayed. This method will use data from the browser's cache, if available.
(Defined by WebBrowserExtensions.) | |
Reload(Boolean) | Overloaded.
Reloads the page being displayed, optionally ignoring the cache (which means the whole page including all .css, .js
etc. resources will be re-fetched).
(Defined by WebBrowserExtensions.) | |
ReplaceMisspelling |
If a misspelled word is currently selected in an editable node calling
this method will replace it with the specified word.
(Defined by WebBrowserExtensions.) | |
SelectAll |
Execute SelectAll on the focused frame
(Defined by WebBrowserExtensions.) | |
SendMouseWheelEvent | (Defined by WebBrowserExtensions.) | |
SetAsPopup | (Defined by WebBrowserExtensions.) | |
SetZoomLevel |
Change the ZoomLevel to the specified value. Can be set to 0.0 to clear the zoom level.
(Defined by WebBrowserExtensions.) | |
ShowDevTools |
Open developer tools in its own window.
(Defined by WebBrowserExtensions.) | |
Stop |
Stops loading the current page.
(Defined by WebBrowserExtensions.) | |
StopFinding |
Cancel all searches that are currently going on.
(Defined by WebBrowserExtensions.) | |
ThrowExceptionIfBrowserNotInitialized | (Defined by WebBrowserExtensions.) | |
Undo |
Execute Undo on the focused frame
(Defined by WebBrowserExtensions.) | |
UnRegisterResourceHandler |
Unregister a ResourceHandler. Can only be used when browser.ResourceHandlerFactory is an instance of DefaultResourceHandlerFactory
(Defined by WebBrowserExtensions.) | |
ViewSource |
Opens up a new program window (using the default text editor) where the source code of the currently displayed web
page is shown.
(Defined by WebBrowserExtensions.) |