Chromium Embedded Framework (CEF)  130.1.2+g48f3ef6+chromium-130.0.6723.44
CefBrowserProcessHandler Class Reference

Class used to implement browser process callbacks. More...

#include "include/cef_browser_process_handler.h"

Inheritance diagram for CefBrowserProcessHandler:
CefBaseRefCounted

Public Member Functions

virtual void OnRegisterCustomPreferences (cef_preferences_type_t type, CefRawPtr< CefPreferenceRegistrar > registrar)
 Provides an opportunity to register custom preferences prior to global and request context initialization. More...
 
virtual void OnContextInitialized ()
 Called on the browser process UI thread immediately after the CEF context has been initialized. More...
 
virtual void OnBeforeChildProcessLaunch (CefRefPtr< CefCommandLine > command_line)
 Called before a child process is launched. More...
 
virtual bool OnAlreadyRunningAppRelaunch (CefRefPtr< CefCommandLine > command_line, const CefString &current_directory)
 Implement this method to provide app-specific behavior when an already running app is relaunched with the same CefSettings.root_cache_path value. More...
 
virtual void OnScheduleMessagePumpWork (int64_t delay_ms)
 Called from any thread when work has been scheduled for the browser process main (UI) thread. More...
 
virtual CefRefPtr< CefClientGetDefaultClient ()
 Return the default client for use with a newly created browser window (CefBrowser object). More...
 
virtual CefRefPtr< CefRequestContextHandlerGetDefaultRequestContextHandler ()
 Return the default handler for use with a new user or incognito profile (CefRequestContext object). More...
 
- Public Member Functions inherited from CefBaseRefCounted
virtual void AddRef () const =0
 Called to increment the reference count for the object. More...
 
virtual bool Release () const =0
 Called to decrement the reference count for the object. More...
 
virtual bool HasOneRef () const =0
 Returns true if the reference count is 1. More...
 
virtual bool HasAtLeastOneRef () const =0
 Returns true if the reference count is at least 1. More...
 

Additional Inherited Members

- Protected Member Functions inherited from CefBaseRefCounted
virtual ~CefBaseRefCounted ()
 

Detailed Description

Class used to implement browser process callbacks.

The methods of this class will be called on the browser process main thread unless otherwise indicated.

Member Function Documentation

◆ GetDefaultClient()

virtual CefRefPtr<CefClient> CefBrowserProcessHandler::GetDefaultClient ( )
inlinevirtual

Return the default client for use with a newly created browser window (CefBrowser object).

If null is returned the CefBrowser will be unmanaged (no callbacks will be executed for that CefBrowser) and application shutdown will be blocked until the browser window is closed manually. This method is currently only used with Chrome style when creating new browser windows via Chrome UI.

◆ GetDefaultRequestContextHandler()

virtual CefRefPtr<CefRequestContextHandler> CefBrowserProcessHandler::GetDefaultRequestContextHandler ( )
inlinevirtual

Return the default handler for use with a new user or incognito profile (CefRequestContext object).

If null is returned the CefRequestContext will be unmanaged (no callbacks will be executed for that CefRequestContext). This method is currently only used with Chrome style when creating new browser windows via Chrome UI.

◆ OnAlreadyRunningAppRelaunch()

virtual bool CefBrowserProcessHandler::OnAlreadyRunningAppRelaunch ( CefRefPtr< CefCommandLine command_line,
const CefString current_directory 
)
inlinevirtual

Implement this method to provide app-specific behavior when an already running app is relaunched with the same CefSettings.root_cache_path value.

For example, activate an existing app window or create a new app window. |command_line| will be read-only. Do not keep a reference to |command_line| outside of this method. Return true if the relaunch is handled or false for default relaunch behavior. Default behavior will create a new default styled Chrome window.

To avoid cache corruption only a single app instance is allowed to run for a given CefSettings.root_cache_path value. On relaunch the app checks a process singleton lock and then forwards the new launch arguments to the already running app process before exiting early. Client apps should therefore check the CefInitialize() return value for early exit before proceeding.

This method will be called on the browser process UI thread.

◆ OnBeforeChildProcessLaunch()

virtual void CefBrowserProcessHandler::OnBeforeChildProcessLaunch ( CefRefPtr< CefCommandLine command_line)
inlinevirtual

Called before a child process is launched.

Will be called on the browser process UI thread when launching a render process and on the browser process IO thread when launching a GPU process. Provides an opportunity to modify the child process command line. Do not keep a reference to |command_line| outside of this method.

◆ OnContextInitialized()

virtual void CefBrowserProcessHandler::OnContextInitialized ( )
inlinevirtual

Called on the browser process UI thread immediately after the CEF context has been initialized.

◆ OnRegisterCustomPreferences()

virtual void CefBrowserProcessHandler::OnRegisterCustomPreferences ( cef_preferences_type_t  type,
CefRawPtr< CefPreferenceRegistrar registrar 
)
inlinevirtual

Provides an opportunity to register custom preferences prior to global and request context initialization.

If |type| is CEF_PREFERENCES_TYPE_GLOBAL the registered preferences can be accessed via CefPreferenceManager::GetGlobalPreferences after OnContextInitialized is called. Global preferences are registered a single time at application startup. See related cef_settings_t.cache_path configuration.

If |type| is CEF_PREFERENCES_TYPE_REQUEST_CONTEXT the preferences can be accessed via the CefRequestContext after CefRequestContextHandler::OnRequestContextInitialized is called. Request context preferences are registered each time a new CefRequestContext is created. It is intended but not required that all request contexts have the same registered preferences. See related cef_request_context_settings_t.cache_path configuration.

Do not keep a reference to the |registrar| object. This method is called on the browser process UI thread.

◆ OnScheduleMessagePumpWork()

virtual void CefBrowserProcessHandler::OnScheduleMessagePumpWork ( int64_t  delay_ms)
inlinevirtual

Called from any thread when work has been scheduled for the browser process main (UI) thread.

This callback is used in combination with cef_settings_t.external_message_pump and CefDoMessageLoopWork() in cases where the CEF message loop must be integrated into an existing application message loop (see additional comments and warnings on CefDoMessageLoopWork). This callback should schedule a CefDoMessageLoopWork() call to happen on the main (UI) thread. |delay_ms| is the requested delay in milliseconds. If |delay_ms| is <= 0 then the call should happen reasonably soon. If |delay_ms| is > 0 then the call should be scheduled to happen after the specified delay and any currently pending scheduled call should be cancelled.


The documentation for this class was generated from the following file: