CefRequestHandler Methods |
The CefRequestHandler type exposes the following members.
Name | Description | |
---|---|---|
Dispose | ||
Equals | Determines whether the specified object is equal to the current object. (Inherited from Object.) | |
Finalize | (Overrides ObjectFinalize.) | |
GetAuthCredentials |
Called on the IO thread when the browser needs credentials from the user.
|isProxy| indicates whether the host is a proxy server. |host| contains the
hostname and |port| contains the port number. |realm| is the realm of the
challenge and may be empty. |scheme| is the authentication scheme used,
such as "basic" or "digest", and will be empty if the source of the request
is an FTP server. Return true to continue the request and call
CefAuthCallback::Continue() either in this method or at a later time when
the authentication information is available. Return false to cancel the
request immediately.
| |
GetHashCode | Serves as the default hash function. (Inherited from Object.) | |
GetResourceHandler |
Called on the IO thread before a resource is loaded. To allow the resource
to load normally return NULL. To specify a handler for the resource return
a CefResourceHandler object. The |request| object should not be modified in
this callback.
| |
GetResourceResponseFilter |
Called on the IO thread to optionally filter resource response content.
|request| and |response| represent the request and response respectively
and cannot be modified in this callback.
| |
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) | |
OnBeforeBrowse |
Called on the UI thread before browser navigation. Return true to cancel
the navigation or false to allow the navigation to proceed. The |request|
object cannot be modified in this callback.
CefLoadHandler::OnLoadingStateChange will be called twice in all cases.
If the navigation is allowed CefLoadHandler::OnLoadStart and
CefLoadHandler::OnLoadEnd will be called. If the navigation is canceled
CefLoadHandler::OnLoadError will be called with an |errorCode| value of
ERR_ABORTED.
| |
OnBeforeResourceLoad |
Called on the IO thread before a resource request is loaded. The |request|
object may be modified. Return RV_CONTINUE to continue the request
immediately. Return RV_CONTINUE_ASYNC and call CefRequestCallback::
Continue() at a later time to continue or cancel the request
asynchronously. Return RV_CANCEL to cancel the request immediately.
| |
OnCertificateError |
Called on the UI thread to handle requests for URLs with an invalid
SSL certificate. Return true and call CefRequestCallback::Continue() either
in this method or at a later time to continue or cancel the request. Return
false to cancel the request immediately. If
CefSettings.ignore_certificate_errors is set all invalid certificates will
be accepted without calling this method.
| |
OnOpenUrlFromTab |
Called on the UI thread before OnBeforeBrowse in certain limited cases
where navigating a new or different browser might be desirable. This
includes user-initiated navigation that might open in a special way (e.g.
links clicked via middle-click or ctrl + left-click) and certain types of
cross-origin navigation initiated from the renderer process (e.g.
navigating the top-level frame to/from a file URL). The |browser| and
|frame| values represent the source of the navigation. The
|target_disposition| value indicates where the user intended to navigate
the browser based on standard Chromium behaviors (e.g. current tab,
new tab, etc). The |user_gesture| value will be true if the browser
navigated via explicit user gesture (e.g. clicking a link) or false if it
navigated automatically (e.g. via the DomContentLoaded event). Return true
to cancel the navigation or false to allow the navigation to proceed in the
source browser's top-level frame.
| |
OnPluginCrashed |
Called on the browser process UI thread when a plugin has crashed.
|plugin_path| is the path of the plugin that crashed.
| |
OnProtocolExecution |
Called on the UI thread to handle requests for URLs with an unknown
protocol component. Set |allow_os_execution| to true to attempt execution
via the registered OS protocol handler, if any.
SECURITY WARNING: YOU SHOULD USE THIS METHOD TO ENFORCE RESTRICTIONS BASED
ON SCHEME, HOST OR OTHER URL ANALYSIS BEFORE ALLOWING OS EXECUTION.
| |
OnQuotaRequest |
Called on the IO thread when JavaScript requests a specific storage quota
size via the webkitStorageInfo.requestQuota function. |origin_url| is the
origin of the page making the request. |new_size| is the requested quota
size in bytes. Return true to continue the request and call
CefRequestCallback::Continue() either in this method or at a later time to
grant or deny the request. Return false to cancel the request immediately.
| |
OnRenderProcessTerminated |
Called on the browser process UI thread when the render process
terminates unexpectedly. |status| indicates how the process
terminated.
| |
OnRenderViewReady |
Called on the browser process UI thread when the render view associated
with |browser| is ready to receive/handle IPC messages in the render
process.
| |
OnResourceLoadComplete |
Called on the IO thread when a resource load has completed. |request| and
|response| represent the request and response respectively and cannot be
modified in this callback. |status| indicates the load completion status.
|received_content_length| is the number of response bytes actually read.
| |
OnResourceRedirect |
Called on the IO thread when a resource load is redirected. The |request|
parameter will contain the old URL and other request-related information.
The |new_url| parameter will contain the new URL and can be changed if
desired. The |request| object cannot be modified in this callback.
| |
OnResourceResponse |
Called on the IO thread when a resource response is received. To allow the
resource to load normally return false. To redirect or retry the resource
modify |request| (url, headers or post body) and return true. The
|response| object cannot be modified in this callback.
| |
ToString | Returns a string that represents the current object. (Inherited from Object.) |
Name | Description | |
---|---|---|
MethodInvoke |
Calls the object method by name.
(Defined by ObjectEx.) | |
PropertyGet(String, Object, Boolean) | Overloaded.
Gets the value of the object property by name.
(Defined by ObjectEx.) | |
PropertyGetT(String, Object, Boolean) | Overloaded.
Gets the value of the object property by name.
(Defined by ObjectEx.) | |
PropertySet |
Sets the value of the object property by name.
(Defined by ObjectEx.) |