Implement this interface to handle audio events. Called on the UI thread to allow configuration of audio stream parameters. Return true to proceed with audio stream capture, or false to cancel it. All members of |params| can optionally be configured here, but they are also pre-filled with some sensible defaults. Called on a browser audio capture thread when the browser starts streaming audio. OnAudioStreamStopped will always be called after OnAudioStreamStarted; both methods may be called multiple times for the same browser. |params| contains the audio parameters like sample rate and channel layout. |channels| is the number of channels. Called on the audio stream thread when a PCM packet is received for the stream. |data| is an array representing the raw PCM data as a floating point type, i.e. 4-byte value(s). |frames| is the number of frames in the PCM packet. |pts| is the presentation timestamp (in milliseconds since the Unix Epoch) and represents the time at which the decompressed packet should be presented to the user. Based on |frames| and the |channel_layout| value passed to OnAudioStreamStarted you can calculate the size of the |data| array in bytes. Called on the UI thread when the stream has stopped. OnAudioSteamStopped will always be called after OnAudioStreamStarted; both methods may be called multiple times for the same stream. Called on the UI or audio stream thread when an error occurred. During the stream creation phase this callback will be called on the UI thread while in the capturing phase it will be called on the audio stream thread. The stream will be stopped immediately. Implement this interface to handle events related to commands. The methods of this class will be called on the UI thread. Called to execute a Chrome command triggered via menu selection or keyboard shortcut. Values for |command_id| can be found in the cef_command_ids.h file. |disposition| provides information about the intended command target. Return true if the command was handled or false for the default implementation. For context menu commands this will be called after CefContextMenuHandler::OnContextMenuCommand. Only used with the Chrome runtime. Called to check if a Chrome app menu item should be visible. Values for |command_id| can be found in the cef_command_ids.h file. Only called for menu items that would be visible by default. Only used with the Chrome runtime. Called to check if a Chrome app menu item should be enabled. Values for |command_id| can be found in the cef_command_ids.h file. Only called for menu items that would be enabled by default. Only used with the Chrome runtime. Called during browser creation to check if a Chrome page action icon should be visible. Only called for icons that would be visible by default. Only used with the Chrome runtime. Called during browser creation to check if a Chrome toolbar button should be visible. Only called for buttons that would be visible by default. Only used with the Chrome runtime. Implement this interface to handle menu model events. The methods of this class will be called on the browser process UI thread unless otherwise indicated. Perform the action associated with the specified |command_id| and optional |event_flags|. Called when the user moves the mouse outside the menu and over the owning window. Called on unhandled open submenu keyboard commands. |is_rtl| will be true if the menu is displaying a right-to-left language. Called on unhandled close submenu keyboard commands. |is_rtl| will be true if the menu is displaying a right-to-left language. The menu is about to show. The menu has closed. Optionally modify a menu item label. Return true if |label| was modified. Supports creation and modification of menus. See cef_menu_id_t for the command ids that have default implementations. All user-defined command ids should be between MENU_ID_USER_FIRST and MENU_ID_USER_LAST. The methods of this class can only be accessed on the browser process the UI thread. Create a new MenuModel with the specified |delegate|. Returns true if this menu is a submenu. Clears the menu. Returns true on success. Returns the number of items in this menu. Add a separator to the menu. Returns true on success. Add an item to the menu. Returns true on success. Add a check item to the menu. Returns true on success. Add a radio item to the menu. Only a single item with the specified |group_id| can be checked at a time. Returns true on success. Add a sub-menu to the menu. The new sub-menu is returned. Insert a separator in the menu at the specified |index|. Returns true on success. Insert an item in the menu at the specified |index|. Returns true on success. Insert a check item in the menu at the specified |index|. Returns true on success. Insert a radio item in the menu at the specified |index|. Only a single item with the specified |group_id| can be checked at a time. Returns true on success. Insert a sub-menu in the menu at the specified |index|. The new sub-menu is returned. Removes the item with the specified |command_id|. Returns true on success. Removes the item at the specified |index|. Returns true on success. Returns the index associated with the specified |command_id| or -1 if not found due to the command id not existing in the menu. Returns the command id at the specified |index| or -1 if not found due to invalid range or the index being a separator. Sets the command id at the specified |index|. Returns true on success. Returns the label for the specified |command_id| or empty if not found. Returns the label at the specified |index| or empty if not found due to invalid range or the index being a separator. Sets the label for the specified |command_id|. Returns true on success. Set the label at the specified |index|. Returns true on success. Returns the item type for the specified |command_id|. Returns the item type at the specified |index|. Returns the group id for the specified |command_id| or -1 if invalid. Returns the group id at the specified |index| or -1 if invalid. Sets the group id for the specified |command_id|. Returns true on success. Sets the group id at the specified |index|. Returns true on success. Returns the submenu for the specified |command_id| or empty if invalid. Returns the submenu at the specified |index| or empty if invalid. Returns true if the specified |command_id| is visible. Returns true if the specified |index| is visible. Change the visibility of the specified |command_id|. Returns true on success. Change the visibility at the specified |index|. Returns true on success. Returns true if the specified |command_id| is enabled. Returns true if the specified |index| is enabled. Change the enabled status of the specified |command_id|. Returns true on success. Change the enabled status at the specified |index|. Returns true on success. Returns true if the specified |command_id| is checked. Only applies to check and radio items. Returns true if the specified |index| is checked. Only applies to check and radio items. Check the specified |command_id|. Only applies to check and radio items. Returns true on success. Check the specified |index|. Only applies to check and radio items. Returns true on success. Returns true if the specified |command_id| has a keyboard accelerator assigned. Returns true if the specified |index| has a keyboard accelerator assigned. Set the keyboard accelerator for the specified |command_id|. |key_code| can be any virtual key or character value. Returns true on success. Set the keyboard accelerator at the specified |index|. |key_code| can be any virtual key or character value. Returns true on success. Remove the keyboard accelerator for the specified |command_id|. Returns true on success. Remove the keyboard accelerator at the specified |index|. Returns true on success. Retrieves the keyboard accelerator for the specified |command_id|. Returns true on success. Retrieves the keyboard accelerator for the specified |index|. Returns true on success. Set the explicit color for |command_id| and |color_type| to |color|. Specify a |color| value of 0 to remove the explicit color. If no explicit color or default color is set for |color_type| then the system color will be used. Returns true on success. Set the explicit color for |command_id| and |index| to |color|. Specify a |color| value of 0 to remove the explicit color. Specify an |index| value of -1 to set the default color for items that do not have an explicit color set. If no explicit color or default color is set for |color_type| then the system color will be used. Returns true on success. Returns in |color| the color that was explicitly set for |command_id| and |color_type|. If a color was not set then 0 will be returned in |color|. Returns true on success. Returns in |color| the color that was explicitly set for |command_id| and |color_type|. Specify an |index| value of -1 to return the default color in |color|. If a color was not set then 0 will be returned in |color|. Returns true on success. Callback interface used for continuation of custom context menu display. Complete context menu display by selecting the specified |command_id| and |event_flags|. Cancel context menu display. Callback interface used for continuation of custom quick menu display. Complete quick menu display by selecting the specified |command_id| and |event_flags|. Cancel quick menu display. Implement this interface to handle context menu events. The methods of this class will be called on the UI thread. Called before a context menu is displayed. |params| provides information about the context menu state. |model| initially contains the default context menu. The |model| can be cleared to show no context menu or modified to show a custom menu. Do not keep references to |params| or |model| outside of this callback. Called to allow custom display of the context menu. |params| provides information about the context menu state. |model| contains the context menu model resulting from OnBeforeContextMenu. For custom display return true and execute |callback| either synchronously or asynchronously with the selected command ID. For default display return false. Do not keep references to |params| or |model| outside of this callback. Called to execute a command selected from the context menu. Return true if the command was handled or false for the default implementation. See cef_menu_id_t for the command ids that have default implementations. All user-defined command ids should be between MENU_ID_USER_FIRST and MENU_ID_USER_LAST. |params| will have the same values as what was passed to OnBeforeContextMenu(). Do not keep a reference to |params| outside of this callback. Called when the context menu is dismissed irregardless of whether the menu was canceled or a command was selected. Called to allow custom display of the quick menu for a windowless browser. |location| is the top left corner of the selected region. |size| is the size of the selected region. |edit_state_flags| is a combination of flags that represent the state of the quick menu. Return true if the menu will be handled and execute |callback| either synchronously or asynchronously with the selected command ID. Return false to cancel the menu. Called to execute a command selected from the quick menu for a windowless browser. Return true if the command was handled or false for the default implementation. See cef_menu_id_t for command IDs that have default implementations. Called when the quick menu for a windowless browser is dismissed irregardless of whether the menu was canceled or a command was selected. Provides information about the context menu state. The methods of this class can only be accessed on browser process the UI thread. Returns the X coordinate of the mouse where the context menu was invoked. Coords are relative to the associated RenderView's origin. Returns the Y coordinate of the mouse where the context menu was invoked. Coords are relative to the associated RenderView's origin. Returns flags representing the type of node that the context menu was invoked on. Returns the URL of the link, if any, that encloses the node that the context menu was invoked on. Returns the link URL, if any, to be used ONLY for "copy link address". We don't validate this field in the frontend process. Returns the source URL, if any, for the element that the context menu was invoked on. Example of elements with source URLs are img, audio, and video. Returns true if the context menu was invoked on an image which has non-empty contents. Returns the title text or the alt text if the context menu was invoked on an image. Returns the URL of the top level page that the context menu was invoked on. Returns the URL of the subframe that the context menu was invoked on. Returns the character encoding of the subframe that the context menu was invoked on. Returns the type of context node that the context menu was invoked on. Returns flags representing the actions supported by the media element, if any, that the context menu was invoked on. Returns the text of the selection, if any, that the context menu was invoked on. Returns the text of the misspelled word, if any, that the context menu was invoked on. Returns true if suggestions exist, false otherwise. Fills in |suggestions| from the spell check service for the misspelled word if there is one. Returns true if the context menu was invoked on an editable node. Returns true if the context menu was invoked on an editable node where spell-check is enabled. Returns flags representing the actions supported by the editable node, if any, that the context menu was invoked on. Returns true if the context menu contains items specified by the renderer process. Callback interface for asynchronous continuation of file dialog requests. Continue the file selection. |file_paths| should be a single value or a list of values depending on the dialog mode. An empty |file_paths| value is treated the same as calling Cancel(). Cancel the file selection. Implement this interface to handle dialog events. The methods of this class will be called on the browser process UI thread. Called to run a file chooser dialog. |mode| represents the type of dialog to display. |title| to the title to be used for the dialog and may be empty to show the default title ("Open" or "Save" depending on the mode). |default_file_path| is the path with optional directory and/or file name component that should be initially selected in the dialog. |accept_filters| are used to restrict the selectable file types and may be any combination of valid lower-cased MIME types (e.g. "text/*" or "image/*") and individual file extensions (e.g. ".txt" or ".png"). |accept_extensions| provides the semicolon-delimited expansion of MIME types to file extensions (if known, or empty string otherwise). |accept_descriptions| provides the descriptions for MIME types (if known, or empty string otherwise). For example, the "image/*" mime type might have extensions ".png;.jpg;.bmp;..." and description "Image Files". |accept_filters|, |accept_extensions| and |accept_descriptions| will all be the same size. To display a custom dialog return true and execute |callback| either inline or at a later time. To display the default dialog return false. If this method returns false it may be called an additional time for the same dialog (both before and after MIME type expansion). Implement this interface to handle events related to browser display state. The methods of this class will be called on the UI thread. Called when a frame's address has changed. Called when the page title changes. Called when the page icon changes. Called when web content in the page has toggled fullscreen mode. If |fullscreen| is true the content will automatically be sized to fill the browser content area. If |fullscreen| is false the content will automatically return to its original size and position. With the Alloy runtime the client is responsible for triggering the fullscreen transition (for example, by calling CefWindow::SetFullscreen when using Views). With the Chrome runtime the fullscreen transition will be triggered automatically. The CefWindowDelegate::OnWindowFullscreenTransition method will be called during the fullscreen transition for notification purposes. Called when the browser is about to display a tooltip. |text| contains the text that will be displayed in the tooltip. To handle the display of the tooltip yourself return true. Otherwise, you can optionally modify |text| and then return false to allow the browser to display the tooltip. When window rendering is disabled the application is responsible for drawing tooltips and the return value is ignored. Called when the browser receives a status message. |value| contains the text that will be displayed in the status message. Called to display a console message. Return true to stop the message from being output to the console. Called when auto-resize is enabled via CefBrowserHost::SetAutoResizeEnabled and the contents have auto-resized. |new_size| will be the desired size in view coordinates. Return true if the resize was handled or false for default handling. Called when the overall page loading progress has changed. |progress| ranges from 0.0 to 1.0. Called when the browser's cursor has changed. If |type| is CT_CUSTOM then |custom_cursor_info| will be populated with the custom cursor information. Return true if the cursor change was handled or false for default handling. Called when the browser's access to an audio and/or video source has changed. Class used to represent a download item. Returns true if this object is valid. Do not call any other methods if this function returns false. Returns true if the download is in progress. Returns true if the download is complete. Returns true if the download has been canceled. Returns true if the download has been interrupted. Returns the most recent interrupt reason. Returns a simple speed estimate in bytes/s. Returns the rough percent complete or -1 if the receive total size is unknown. Returns the total number of bytes. Returns the number of received bytes. Returns the time that the download started. Returns the time that the download ended. Returns the full path to the downloaded or downloading file. Returns the unique identifier for this download. Returns the URL. Returns the original URL before any redirections. Returns the suggested file name. Returns the content disposition. Returns the mime type. Callback interface used to asynchronously continue a download. Call to continue the download. Set |download_path| to the full file path for the download including the file name or leave blank to use the suggested name and the default temp directory. Set |show_dialog| to true if you do wish to show the default "Save As" dialog. Callback interface used to asynchronously cancel a download. Call to cancel the download. Call to pause the download. Call to resume the download. Class used to handle file downloads. The methods of this class will called on the browser process UI thread. Called before a download begins in response to a user-initiated action (e.g. alt + link click or link click that returns a `Content-Disposition: attachment` response from the server). |url| is the target download URL and |request_method| is the target method (GET, POST, etc). Return true to proceed with the download or false to cancel the download. Called before a download begins. |suggested_name| is the suggested name for the download file. Return true and execute |callback| either asynchronously or in this method to continue or cancel the download. Return false to proceed with default handling (cancel with Alloy style, download shelf with Chrome style). Do not keep a reference to |download_item| outside of this method. Called when a download's status or progress information has been updated. This may be called multiple times before and after OnBeforeDownload(). Execute |callback| either asynchronously or in this method to cancel the download if desired. Do not keep a reference to |download_item| outside of this method. Implement this interface to handle events related to dragging. The methods of this class will be called on the UI thread. Called when an external drag event enters the browser window. |dragData| contains the drag event data and |mask| represents the type of drag operation. Return false for default drag handling behavior or true to cancel the drag event. Called whenever draggable regions for the browser window change. These can be specified using the '-webkit-app-region: drag/no-drag' CSS-property. If draggable regions are never defined in a document this method will also never be called. If the last draggable region is removed from a document this method will be called with an empty vector. Implement this interface to handle events related to find results. The methods of this class will be called on the UI thread. Called to report find results returned by CefBrowserHost::Find(). |identifer| is a unique incremental identifier for the currently active search, |count| is the number of matches currently identified, |selectionRect| is the location of where the match was found (in window coordinates), |activeMatchOrdinal| is the current position in the search results, and |finalUpdate| is true if this is the last find notification. Implement this interface to handle events related to focus. The methods of this class will be called on the UI thread. Called when the browser component is about to loose focus. For instance, if focus was on the last HTML element and the user pressed the TAB key. |next| will be true if the browser is giving focus to the next component and false if the browser is giving focus to the previous component. Called when the browser component is requesting focus. |source| indicates where the focus request is originating from. Return false to allow the focus to be set or true to cancel setting the focus. Called when the browser component has received focus. Implement this interface to handle events related to CefFrame life span. The order of callbacks is: (1) During initial CefBrowserHost creation and navigation of the main frame: - CefFrameHandler::OnFrameCreated => The initial main frame object has been created. Any commands will be queued until the frame is attached. - CefFrameHandler::OnMainFrameChanged => The initial main frame object has been assigned to the browser. - CefLifeSpanHandler::OnAfterCreated => The browser is now valid and can be used. - CefFrameHandler::OnFrameAttached => The initial main frame object is now connected to its peer in the renderer process. Commands can be routed. (2) During further CefBrowserHost navigation/loading of the main frame and/or sub-frames: - CefFrameHandler::OnFrameCreated => A new main frame or sub-frame object has been created. Any commands will be queued until the frame is attached. - CefFrameHandler::OnFrameAttached => A new main frame or sub-frame object is now connected to its peer in the renderer process. Commands can be routed. - CefFrameHandler::OnFrameDetached => An existing main frame or sub-frame object has lost its connection to the renderer process. If multiple objects are detached at the same time then notifications will be sent for any sub-frame objects before the main frame object. Commands can no longer be routed and will be discarded. - CefFrameHandler::OnMainFrameChanged => A new main frame object has been assigned to the browser. This will only occur with cross-origin navigation or re-navigation after renderer process termination (due to crashes, etc). (3) During final CefBrowserHost destruction of the main frame: - CefFrameHandler::OnFrameDetached => Any sub-frame objects have lost their connection to the renderer process. Commands can no longer be routed and will be discarded. - CefLifeSpanHandler::OnBeforeClose => The browser has been destroyed. - CefFrameHandler::OnFrameDetached => The main frame object have lost its connection to the renderer process. Notifications will be sent for any sub-frame objects before the main frame object. Commands can no longer be routed and will be discarded. - CefFrameHandler::OnMainFrameChanged => The final main frame object has been removed from the browser. Cross-origin navigation and/or loading receives special handling. When the main frame navigates to a different origin the OnMainFrameChanged callback (2) will be executed with the old and new main frame objects. When a new sub-frame is loaded in, or an existing sub-frame is navigated to, a different origin from the parent frame, a temporary sub-frame object will first be created in the parent's renderer process. That temporary sub-frame will then be discarded after the real cross-origin sub-frame is created in the new/target renderer process. The client will receive cross-origin navigation callbacks (2) for the transition from the temporary sub-frame to the real sub-frame. The temporary sub-frame will not receive or execute commands during this transitional period (any sent commands will be discarded). When a new popup browser is created in a different origin from the parent browser, a temporary main frame object for the popup will first be created in the parent's renderer process. That temporary main frame will then be discarded after the real cross-origin main frame is created in the new/target renderer process. The client will receive creation and initial navigation callbacks (1) for the temporary main frame, followed by cross-origin navigation callbacks (2) for the transition from the temporary main frame to the real main frame. The temporary main frame may receive and execute commands during this transitional period (any sent commands may be executed, but the behavior is potentially undesirable since they execute in the parent browser's renderer process and not the new/target renderer process). Callbacks will not be executed for placeholders that may be created during pre-commit navigation for sub-frames that do not yet exist in the renderer process. Placeholders will have CefFrame::GetIdentifier() == -4. The methods of this class will be called on the UI thread unless otherwise indicated. Called when a new frame is created. This will be the first notification that references |frame|. Any commands that require transport to the associated renderer process (LoadRequest, SendProcessMessage, GetSource, etc.) will be queued until OnFrameAttached is called for |frame|. Called when a frame can begin routing commands to/from the associated renderer process. |reattached| will be true if the frame was re-attached after exiting the BackForwardCache. Any commands that were queued have now been dispatched. Called when a frame loses its connection to the renderer process and will be destroyed. Any pending or future commands will be discarded and CefFrame::IsValid() will now return false for |frame|. If called after CefLifeSpanHandler::OnBeforeClose() during browser destruction then CefBrowser::IsValid() will return false for |browser|. Called when the main frame changes due to (a) initial browser creation, (b) final browser destruction, (c) cross-origin navigation or (d) re-navigation after renderer process termination (due to crashes, etc). |old_frame| will be NULL and |new_frame| will be non-NULL when a main frame is assigned to |browser| for the first time. |old_frame| will be non-NULL and |new_frame| will be NULL and when a main frame is removed from |browser| for the last time. Both |old_frame| and |new_frame| will be non-NULL for cross-origin navigations or re-navigation after renderer process termination. This method will be called after OnFrameCreated() for |new_frame| and/or after OnFrameDetached() for |old_frame|. If called after CefLifeSpanHandler::OnBeforeClose() during browser destruction then CefBrowser::IsValid() will return false for |browser|. Callback interface used for asynchronous continuation of JavaScript dialog requests. Continue the JS dialog request. Set |success| to true if the OK button was pressed. The |user_input| value should be specified for prompt dialogs. Implement this interface to handle events related to JavaScript dialogs. The methods of this class will be called on the UI thread. Called to run a JavaScript dialog. If |origin_url| is non-empty it can be passed to the CefFormatUrlForSecurityDisplay function to retrieve a secure and user-friendly display string. The |default_prompt_text| value will be specified for prompt dialogs only. Set |suppress_message| to true and return false to suppress the message (suppressing messages is preferable to immediately executing the callback as this is used to detect presumably malicious behavior like spamming alert messages in onbeforeunload). Set |suppress_message| to false and return false to use the default implementation (the default implementation will show one modal dialog at a time and suppress any additional dialog requests until the displayed dialog is dismissed). Return true if the application will use a custom dialog or if the callback has been executed immediately. Custom dialogs may be either modal or modeless. If a custom dialog is used the application must execute |callback| once the custom dialog is dismissed. Called to run a dialog asking the user if they want to leave a page. Return false to use the default dialog implementation. Return true if the application will use a custom dialog or if the callback has been executed immediately. Custom dialogs may be either modal or modeless. If a custom dialog is used the application must execute |callback| once the custom dialog is dismissed. Called to cancel any pending dialogs and reset any saved dialog state. Will be called due to events like page navigation irregardless of whether any dialogs are currently pending. Called when the dialog is closed. Implement this interface to handle events related to keyboard input. The methods of this class will be called on the UI thread. Called before a keyboard event is sent to the renderer. |event| contains information about the keyboard event. |os_event| is the operating system event message, if any. Return true if the event was handled or false otherwise. If the event will be handled in OnKeyEvent() as a keyboard shortcut set |is_keyboard_shortcut| to true and return false. Called after the renderer and JavaScript in the page has had a chance to handle the event. |event| contains information about the keyboard event. |os_event| is the operating system event message, if any. Return true if the keyboard event was handled or false otherwise. Implement this interface to handle events related to browser life span. The methods of this class will be called on the UI thread unless otherwise indicated. Called on the UI thread before a new popup browser is created. The |browser| and |frame| values represent the source of the popup request. The |target_url| and |target_frame_name| values indicate where the popup browser should navigate and may be empty if not specified with the request. The |target_disposition| value indicates where the user intended to open the popup (e.g. current tab, new tab, etc). The |user_gesture| value will be true if the popup was opened via explicit user gesture (e.g. clicking a link) or false if the popup opened automatically (e.g. via the DomContentLoaded event). The |popupFeatures| structure contains additional information about the requested popup window. To allow creation of the popup browser optionally modify |windowInfo|, |client|, |settings| and |no_javascript_access| and return false. To cancel creation of the popup browser return true. The |client| and |settings| values will default to the source browser's values. If the |no_javascript_access| value is set to false the new browser will not be scriptable and may not be hosted in the same renderer process as the source browser. Any modifications to |windowInfo| will be ignored if the parent browser is wrapped in a CefBrowserView. Popup browser creation will be canceled if the parent browser is destroyed before the popup browser creation completes (indicated by a call to OnAfterCreated for the popup browser). The |extra_info| parameter provides an opportunity to specify extra information specific to the created popup browser that will be passed to CefRenderProcessHandler::OnBrowserCreated() in the render process. Called on the UI thread before a new DevTools popup browser is created. The |browser| value represents the source of the popup request. Optionally modify |windowInfo|, |client|, |settings| and |extra_info| values. The |client|, |settings| and |extra_info| values will default to the source browser's values. Any modifications to |windowInfo| will be ignored if the parent browser is Views-hosted (wrapped in a CefBrowserView). The |extra_info| parameter provides an opportunity to specify extra information specific to the created popup browser that will be passed to CefRenderProcessHandler::OnBrowserCreated() in the render process. The existing |extra_info| object, if any, will be read-only but may be replaced with a new object. Views-hosted source browsers will create Views-hosted DevTools popups unless |use_default_window| is set to to true. DevTools popups can be blocked by returning true from CefCommandHandler::OnChromeCommand for IDC_DEV_TOOLS. Only used with the Chrome runtime. Called after a new browser is created. It is now safe to begin performing actions with |browser|. CefFrameHandler callbacks related to initial main frame creation will arrive before this callback. See CefFrameHandler documentation for additional usage information. Called when a browser has received a request to close. This may result directly from a call to CefBrowserHost::*CloseBrowser() or indirectly if the browser is parented to a top-level window created by CEF and the user attempts to close that window (by clicking the 'X', for example). The DoClose() method will be called after the JavaScript 'onunload' event has been fired. An application should handle top-level owner window close notifications by calling CefBrowserHost::TryCloseBrowser() or CefBrowserHost::CloseBrowser(false) instead of allowing the window to close immediately (see the examples below). This gives CEF an opportunity to process the 'onbeforeunload' event and optionally cancel the close before DoClose() is called. When windowed rendering is enabled CEF will internally create a window or view to host the browser. In that case returning false from DoClose() will send the standard close notification to the browser's top-level owner window (e.g. WM_CLOSE on Windows, performClose: on OS X, "delete_event" on Linux or CefWindowDelegate::CanClose() callback from Views). If the browser's host window/view has already been destroyed (via view hierarchy tear-down, for example) then DoClose() will not be called for that browser since is no longer possible to cancel the close. When windowed rendering is disabled returning false from DoClose() will cause the browser object to be destroyed immediately. If the browser's top-level owner window requires a non-standard close notification then send that notification from DoClose() and return true. The CefLifeSpanHandler::OnBeforeClose() method will be called after DoClose() (if DoClose() is called) and immediately before the browser object is destroyed. The application should only exit after OnBeforeClose() has been called for all existing browsers. The below examples describe what should happen during window close when the browser is parented to an application-provided top-level window. Example 1: Using CefBrowserHost::TryCloseBrowser(). This is recommended for clients using standard close handling and windows created on the browser process UI thread. 1. User clicks the window close button which sends a close notification to the application's top-level window. 2. Application's top-level window receives the close notification and calls TryCloseBrowser() (which internally calls CloseBrowser(false)). TryCloseBrowser() returns false so the client cancels the window close. 3. JavaScript 'onbeforeunload' handler executes and shows the close confirmation dialog (which can be overridden via CefJSDialogHandler::OnBeforeUnloadDialog()). 4. User approves the close. 5. JavaScript 'onunload' handler executes. 6. CEF sends a close notification to the application's top-level window (because DoClose() returned false by default). 7. Application's top-level window receives the close notification and calls TryCloseBrowser(). TryCloseBrowser() returns true so the client allows the window close. 8. Application's top-level window is destroyed. 9. Application's OnBeforeClose() handler is called and the browser object is destroyed. 10. Application exits by calling CefQuitMessageLoop() if no other browsers exist. Example 2: Using CefBrowserHost::CloseBrowser(false) and implementing the DoClose() callback. This is recommended for clients using non-standard close handling or windows that were not created on the browser process UI thread. 1. User clicks the window close button which sends a close notification to the application's top-level window. 2. Application's top-level window receives the close notification and: A. Calls CefBrowserHost::CloseBrowser(false). B. Cancels the window close. 3. JavaScript 'onbeforeunload' handler executes and shows the close confirmation dialog (which can be overridden via CefJSDialogHandler::OnBeforeUnloadDialog()). 4. User approves the close. 5. JavaScript 'onunload' handler executes. 6. Application's DoClose() handler is called. Application will: A. Set a flag to indicate that the next close attempt will be allowed. B. Return false. 7. CEF sends an close notification to the application's top-level window. 8. Application's top-level window receives the close notification and allows the window to close based on the flag from #6B. 9. Application's top-level window is destroyed. 10. Application's OnBeforeClose() handler is called and the browser object is destroyed. 11. Application exits by calling CefQuitMessageLoop() if no other browsers exist. Called just before a browser is destroyed. Release all references to the browser object and do not attempt to execute any methods on the browser object (other than IsValid, GetIdentifier or IsSame) after this callback returns. CefFrameHandler callbacks related to final main frame destruction will arrive after this callback and CefBrowser::IsValid will return false at that time. Any in-progress network requests associated with |browser| will be aborted when the browser is destroyed, and CefResourceRequestHandler callbacks related to those requests may still arrive on the IO thread after this callback. See CefFrameHandler and DoClose() documentation for additional usage information. Implement this interface to handle events related to browser load status. The methods of this class will be called on the browser process UI thread or render process main thread (TID_RENDERER). Called when the loading state has changed. This callback will be executed 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 will be called before any calls to OnLoadStart and after all calls to OnLoadError and/or OnLoadEnd. Called after a navigation has been committed and before the browser begins loading contents in the frame. The |frame| value will never be empty -- call the IsMain() method to check if this frame is the main frame. |transition_type| provides information about the source of the navigation and an accurate value is only available in the browser process. 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 not be called for same page navigations (fragments, history state, etc.) or for navigations that fail or are canceled before commit. For notification of overall browser load status use OnLoadingStateChange instead. Called when the browser is done loading a frame. The |frame| value will never be empty -- call the IsMain() method to check if this frame is the main 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 not be called for same page navigations (fragments, history state, etc.) or for navigations that fail or are canceled before commit. For notification of overall browser load status use OnLoadingStateChange instead. Called when a navigation fails or is canceled. This method may be called by itself if before commit or in combination with OnLoadStart/OnLoadEnd if after commit. |errorCode| is the error code number, |errorText| is the error text and |failedUrl| is the URL that failed to load. See net\base\net_error_list.h for complete descriptions of the error codes. Callback interface used for asynchronous continuation of media access permission requests. Call to allow or deny media access. If this callback was initiated in response to a getUserMedia (indicated by CEF_MEDIA_PERMISSION_DEVICE_AUDIO_CAPTURE and/or CEF_MEDIA_PERMISSION_DEVICE_VIDEO_CAPTURE being set) then |allowed_permissions| must match |required_permissions| passed to OnRequestMediaAccessPermission. Cancel the media access request. Callback interface used for asynchronous continuation of permission prompts. Complete the permissions request with the specified |result|. Implement this interface to handle events related to permission requests. The methods of this class will be called on the browser process UI thread. Called when a page requests permission to access media. |requesting_origin| is the URL origin requesting permission. |requested_permissions| is a combination of values from cef_media_access_permission_types_t that represent the requested permissions. Return true and call CefMediaAccessCallback methods either in this method or at a later time to continue or cancel the request. Return false to proceed with default handling. With the Chrome runtime, default handling will display the permission request UI. With the Alloy runtime, default handling will deny the request. This method will not be called if the "--enable-media-stream" command-line switch is used to grant all permissions. Called when a page should show a permission prompt. |prompt_id| uniquely identifies the prompt. |requesting_origin| is the URL origin requesting permission. |requested_permissions| is a combination of values from cef_permission_request_types_t that represent the requested permissions. Return true and call CefPermissionPromptCallback::Continue either in this method or at a later time to continue or cancel the request. Return false to proceed with default handling. With the Chrome runtime, default handling will display the permission prompt UI. With the Alloy runtime, default handling is CEF_PERMISSION_RESULT_IGNORE. Called when a permission prompt handled via OnShowPermissionPrompt is dismissed. |prompt_id| will match the value that was passed to OnShowPermissionPrompt. |result| will be the value passed to CefPermissionPromptCallback::Continue or CEF_PERMISSION_RESULT_IGNORE if the dialog was dismissed for other reasons such as navigation, browser closure, etc. This method will not be called if OnShowPermissionPrompt returned false for |prompt_id|. Class representing print settings. Create a new CefPrintSettings object. Returns true if this object is valid. Do not call any other methods if this function returns false. Returns true if the values of this object are read-only. Some APIs may expose read-only objects. Set the page orientation. Returns true if the orientation is landscape. Set the printer printable area in device units. Some platforms already provide flipped area. Set |landscape_needs_flip| to false on those platforms to avoid double flipping. Set the device name. Get the device name. Set the DPI (dots per inch). Get the DPI (dots per inch). Set the page ranges. Returns the number of page ranges that currently exist. Retrieve the page ranges. Set whether only the selection will be printed. Returns true if only the selection will be printed. Set whether pages will be collated. Returns true if pages will be collated. Set the color model. Get the color model. Set the number of copies. Get the number of copies. Set the duplex mode. Get the duplex mode. Callback interface for asynchronous continuation of print dialog requests. Continue printing with the specified |settings|. Cancel the printing. Callback interface for asynchronous continuation of print job requests. Indicate completion of the print job. Implement this interface to handle printing on Linux. Each browser will have only one print job in progress at a time. The methods of this class will be called on the browser process UI thread. Called when printing has started for the specified |browser|. This method will be called before the other OnPrint*() methods and irrespective of how printing was initiated (e.g. CefBrowserHost::Print(), JavaScript window.print() or PDF extension print button). Synchronize |settings| with client state. If |get_defaults| is true then populate |settings| with the default print settings. Do not keep a reference to |settings| outside of this callback. Show the print dialog. Execute |callback| once the dialog is dismissed. Return true if the dialog will be displayed or false to cancel the printing immediately. Send the print job to the printer. Execute |callback| once the job is completed. Return true if the job will proceed or false to cancel the job immediately. Reset client state related to printing. Return the PDF paper size in device units. Used in combination with CefBrowserHost::PrintToPDF(). Implement this interface to receive accessibility notification when accessibility events have been registered. The methods of this class will be called on the UI thread. Called after renderer process sends accessibility tree changes to the browser process. Called after renderer process sends accessibility location changes to the browser process. Implement this interface to handle events when window rendering is disabled. The methods of this class will be called on the UI thread. Return the handler for accessibility notifications. If no handler is provided the default implementation will be used. Called to retrieve the root window rectangle in screen DIP coordinates. Return true if the rectangle was provided. If this method returns false the rectangle from GetViewRect will be used. Called to retrieve the view rectangle in screen DIP coordinates. This method must always provide a non-empty rectangle. Called to retrieve the translation from view DIP coordinates to screen coordinates. Windows/Linux should provide screen device (pixel) coordinates and MacOS should provide screen DIP coordinates. Return true if the requested coordinates were provided. Called to allow the client to fill in the CefScreenInfo object with appropriate values. Return true if the |screen_info| structure has been modified. If the screen info rectangle is left empty the rectangle from GetViewRect will be used. If the rectangle is still empty or invalid popups may not be drawn correctly. Called when the browser wants to show or hide the popup widget. The popup should be shown if |show| is true and hidden if |show| is false. Called when the browser wants to move or resize the popup widget. |rect| contains the new location and size in view coordinates. Called when an element should be painted. Pixel values passed to this method are scaled relative to view coordinates based on the value of CefScreenInfo.device_scale_factor returned from GetScreenInfo. |type| indicates whether the element is the view or the popup widget. |buffer| contains the pixel data for the whole image. |dirtyRects| contains the set of rectangles in pixel coordinates that need to be repainted. |buffer| will be |width|*|height|*4 bytes in size and represents a BGRA image with an upper-left origin. This method is only called when CefWindowInfo::shared_texture_enabled is set to false. Called when an element has been rendered to the shared texture handle. |type| indicates whether the element is the view or the popup widget. |dirtyRects| contains the set of rectangles in pixel coordinates that need to be repainted. |info| contains the shared handle; on Windows it is a HANDLE to a texture that can be opened with D3D11 OpenSharedResource, on macOS it is an IOSurface pointer that can be opened with Metal or OpenGL, and on Linux it contains several planes, each with an fd to the underlying system native buffer. The underlying implementation uses a pool to deliver frames. As a result, the handle may differ every frame depending on how many frames are in-progress. The handle's resource cannot be cached and cannot be accessed outside of this callback. It should be reopened each time this callback is executed and the contents should be copied to a texture owned by the client application. The contents of |info| will be released back to the pool after this callback returns. Called to retrieve the size of the touch handle for the specified |orientation|. Called when touch handle state is updated. The client is responsible for rendering the touch handles. Called when the user starts dragging content in the web view. Contextual information about the dragged content is supplied by |drag_data|. (|x|, |y|) is the drag start location in screen coordinates. OS APIs that run a system message loop may be used within the StartDragging call. Return false to abort the drag operation. Don't call any of CefBrowserHost::DragSource*Ended* methods after returning false. Return true to handle the drag operation. Call CefBrowserHost::DragSourceEndedAt and DragSourceSystemDragEnded either synchronously or asynchronously to inform the web view that the drag operation has ended. Called when the scroll offset has changed. Called when the IME composition range has changed. |selected_range| is the range of characters that have been selected. |character_bounds| is the bounds of each character in view coordinates. Called when text selection has changed for the specified |browser|. |selected_text| is the currently selected text and |selected_range| is the character range. Called when an on-screen keyboard should be shown or hidden for the specified |browser|. |input_mode| specifies what kind of keyboard should be opened. If |input_mode| is CEF_TEXT_INPUT_MODE_NONE, any existing keyboard for this browser should be hidden. Callback interface used for asynchronous continuation of authentication requests. Continue the authentication request. Cancel the authentication request. Class used to represent a web response. The methods of this class may be called on any thread. Create a new CefResponse object. Returns true if this object is read-only. Get the response error code. Returns ERR_NONE if there was no error. Set the response error code. This can be used by custom scheme handlers to return errors during initial request processing. Get the response status code. Set the response status code. Get the response status text. Set the response status text. Get the response mime type. Set the response mime type. Get the response charset. Set the response charset. Get the value for the specified response header field. Set the header |name| to |value|. If |overwrite| is true any existing values will be replaced with the new value. If |overwrite| is false any existing values will not be overwritten. Get all response header fields. Set all response header fields. Get the resolved URL after redirects or changed as a result of HSTS. Set the resolved URL after redirects or changed as a result of HSTS. Callback for asynchronous continuation of CefResourceHandler::Skip(). Callback for asynchronous continuation of CefResourceHandler::Read(). Class used to implement a custom request handler interface. The methods of this class will be called on the IO thread unless otherwise indicated. Open the response stream. To handle the request immediately set |handle_request| to true and return true. To decide at a later time set |handle_request| to false, return true, and execute |callback| to continue or cancel the request. To cancel the request immediately set |handle_request| to true and return false. This method will be called in sequence but not from a dedicated thread. For backwards compatibility set |handle_request| to false and return false and the ProcessRequest method will be called. Begin processing the request. To handle the request return true and call CefCallback::Continue() once the response header information is available (CefCallback::Continue() can also be called from inside this method if header information is available immediately). To cancel the request return false. WARNING: This method is deprecated. Use Open instead. Retrieve response header information. If the response length is not known set |response_length| to -1 and ReadResponse() will be called until it returns false. If the response length is known set |response_length| to a positive value and ReadResponse() will be called until it returns false or the specified number of bytes have been read. Use the |response| object to set the mime type, http status code and other optional header values. To redirect the request to a new URL set |redirectUrl| to the new URL. |redirectUrl| can be either a relative or fully qualified URL. It is also possible to set |response| to a redirect http status code and pass the new URL via a Location header. Likewise with |redirectUrl| it is valid to set a relative or fully qualified URL as the Location header value. If an error occured while setting up the request you can call SetError() on |response| to indicate the error condition. Read response data. If data is available immediately copy up to |bytes_to_read| bytes into |data_out|, set |bytes_read| to the number of bytes copied, and return true. To read the data at a later time set |bytes_read| to 0, return true and call CefCallback::Continue() when the data is available. To indicate response completion return false. WARNING: This method is deprecated. Use Skip and Read instead. Request processing has been canceled. Implement this interface to filter resource response content. The methods of this class will be called on the browser process IO thread. Initialize the response filter. Will only be called a single time. The filter will not be installed if this method returns false. Called to filter a chunk of data. Expected usage is as follows: 1. Read input data from |data_in| and set |data_in_read| to the number of bytes that were read up to a maximum of |data_in_size|. |data_in| will be NULL if |data_in_size| is zero. 2. Write filtered output data to |data_out| and set |data_out_written| to the number of bytes that were written up to a maximum of |data_out_size|. If no output data was written then all data must be read from |data_in| (user must set |data_in_read| = |data_in_size|). 3. Return RESPONSE_FILTER_DONE if all output data was written or RESPONSE_FILTER_NEED_MORE_DATA if output data is still pending. This method will be called repeatedly until the input buffer has been fully read (user sets |data_in_read| = |data_in_size|) and there is no more input data to filter (the resource response is complete). This method may then be called an additional time with an empty input buffer if the user filled the output buffer (set |data_out_written| = |data_out_size|) and returned RESPONSE_FILTER_NEED_MORE_DATA to indicate that output data is still pending. Calls to this method will stop when one of the following conditions is met: 1. There is no more input data to filter (the resource response is complete) and the user sets |data_out_written| = 0 or returns RESPONSE_FILTER_DONE to indicate that all data has been written, or; 2. The user returns RESPONSE_FILTER_ERROR to indicate an error. Do not keep a reference to the buffers passed to this method. Implement this interface to handle events related to browser requests. The methods of this class will be called on the IO thread unless otherwise indicated. Called on the IO thread before a resource request is loaded. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. To optionally filter cookies for the request return a CefCookieAccessFilter object. The |request| object cannot not be modified in this callback. Called on the IO thread before a resource request is loaded. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. To redirect or change the resource load optionally modify |request|. Modification of the request URL will be treated as a redirect. Return RV_CONTINUE to continue the request immediately. Return RV_CONTINUE_ASYNC and call CefCallback methods at a later time to continue or cancel the request asynchronously. Return RV_CANCEL to cancel the request immediately. Called on the IO thread before a resource is loaded. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. To allow the resource to load using the default network loader return NULL. To specify a handler for the resource return a CefResourceHandler object. The |request| object cannot not be modified in this callback. Called on the IO thread when a resource load is redirected. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. The |request| parameter will contain the old URL and other request-related information. The |response| parameter will contain the response that resulted in the redirect. The |new_url| parameter will contain the new URL and can be changed if desired. The |request| and |response| objects cannot be modified in this callback. Called on the IO thread when a resource response is received. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. To allow the resource load to proceed without modification return false. To redirect or retry the resource load optionally modify |request| and return true. Modification of the request URL will be treated as a redirect. Requests handled using the default network loader cannot be redirected in this callback. The |response| object cannot be modified in this callback. WARNING: Redirecting using this method is deprecated. Use OnBeforeResourceLoad or GetResourceHandler to perform redirects. Called on the IO thread to optionally filter resource response content. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. |request| and |response| represent the request and response respectively and cannot be modified in this callback. Called on the IO thread when a resource load has completed. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. |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. This method will be called for all requests, including requests that are aborted due to CEF shutdown or destruction of the associated browser. In cases where the associated browser is destroyed this callback may arrive after the CefLifeSpanHandler::OnBeforeClose callback for that browser. The CefFrame::IsValid method can be used to test for this situation, and care should be taken not to call |browser| or |frame| methods that modify state (like LoadURL, SendProcessMessage, etc.) if the frame is invalid. Called on the IO thread to handle requests for URLs with an unknown protocol component. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. |request| cannot be modified in this callback. 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. Implement this interface to filter cookies that may be sent or received from resource requests. The methods of this class will be called on the IO thread unless otherwise indicated. Called on the IO thread before a resource request is sent. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. |request| cannot be modified in this callback. Return true if the specified cookie can be sent with the request or false otherwise. Called on the IO thread after a resource response is received. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. |request| cannot be modified in this callback. Return true if the specified cookie returned with the response can be saved or false otherwise. Class representing SSL information. Returns a bitmask containing any and all problems verifying the server certificate. Returns the X.509 certificate. Returns true if the certificate status represents an error. Callback interface for asynchronous handling of an unresponsive process. Reset the timeout for the unresponsive process. Terminate the unresponsive process. Callback interface used to select a client certificate for authentication. Chooses the specified certificate for client certificate authentication. NULL value means that no client certificate should be used. Implement this interface to handle events related to browser requests. The methods of this class will be called on the thread indicated. 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. 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). 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. Called on the browser process IO thread before a resource request is initiated. The |browser| and |frame| values represent the source of the request. |request| represents the request contents and cannot be modified in this callback. |is_navigation| will be true if the resource request is a navigation. |is_download| will be true if the resource request is a download. |request_initiator| is the origin (scheme + domain) of the page that initiated the request. Set |disable_default_handling| to true to disable default handling of the request, in which case it will need to be handled via CefResourceRequestHandler::GetResourceHandler or it will be canceled. To allow the resource load to proceed with default handling return NULL. To specify a handler for the resource return a CefResourceRequestHandler object. If this callback returns NULL the same method will be called on the associated CefRequestContextHandler, if any. Called on the IO thread when the browser needs credentials from the user. |origin_url| is the origin making this authentication request. |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. Called on the UI thread to handle requests for URLs with an invalid SSL certificate. Return true and call CefCallback methods either in this method or at a later time to continue or cancel the request. Return false to cancel the request immediately. If cef_settings_t.ignore_certificate_errors is set all invalid certificates will be accepted without calling this method. Called on the UI thread when a client certificate is being requested for authentication. Return false to use the default behavior and automatically select the first certificate available. Return true and call CefSelectClientCertificateCallback::Select either in this method or at a later time to select a certificate. Do not call Select or call it with NULL to continue without using any certificate. |isProxy| indicates whether the host is an HTTPS proxy or the origin server. |host| and |port| contains the hostname and port of the SSL server. |certificates| is the list of certificates to choose from; this list has already been pruned by Chromium so that it only contains certificates from issuers that the server trusts. 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. Called on the browser process UI thread when the render process is unresponsive as indicated by a lack of input event processing for at least 15 seconds. Return false for the default behavior which is an indefinite wait with the Alloy runtime or display of the "Page unresponsive" dialog with the Chrome runtime. Return true and don't execute the callback for an indefinite wait without display of the Chrome runtime dialog. Return true and call CefUnresponsiveProcessCallback::Wait either in this method or at a later time to reset the wait timer, potentially triggering another call to this method if the process remains unresponsive. Return true and call CefUnresponsiveProcessCallback:: Terminate either in this method or at a later time to terminate the unresponsive process, resulting in a call to OnRenderProcessTerminated. OnRenderProcessResponsive will be called if the process becomes responsive after this method is called. This functionality depends on the hang monitor which can be disabled by passing the `--disable-hang-monitor` command-line flag. Called on the browser process UI thread when the render process becomes responsive after previously being unresponsive. See documentation on OnRenderProcessUnresponsive. Called on the browser process UI thread when the render process terminates unexpectedly. |status| indicates how the process terminated. |error_code| and |error_string| represent the error that would be displayed in Chrome's "Aw, Snap!" view. Possible |error_code| values include cef_resultcode_t non-normal exit values and platform-specific crash values (for example, a Posix signal or Windows hardware exception). Called on the browser process UI thread when the window.document object of the main frame has been created. Implement this interface to provide handler implementations. Return the handler for audio rendering events. Return the handler for commands. If no handler is provided the default implementation will be used. Return the handler for context menus. If no handler is provided the default implementation will be used. Return the handler for dialogs. If no handler is provided the default implementation will be used. Return the handler for browser display state events. Return the handler for download events. If no handler is returned downloads will not be allowed. Return the handler for drag events. Return the handler for find result events. Return the handler for focus events. Return the handler for events related to CefFrame lifespan. This method will be called once during CefBrowser creation and the result will be cached for performance reasons. Return the handler for permission requests. Return the handler for JavaScript dialogs. If no handler is provided the default implementation will be used. Return the handler for keyboard events. Return the handler for browser life span events. Return the handler for browser load status events. Return the handler for printing on Linux. If a print handler is not provided then printing will not be supported on the Linux platform. Return the handler for off-screen rendering events. Return the handler for browser request events. Called when a new message is received from a different process. Return true if the message was handled or false otherwise. It is safe to keep a reference to |message| outside of this callback. Class used to create and/or parse command line arguments. Arguments with "--", "-" and, on Windows, "/" prefixes are considered switches. Switches will always precede any arguments without switch prefixes. Switches can optionally have a value specified using the "=" delimiter (e.g. "-switch=value"). An argument of "--" will terminate switch parsing with all subsequent tokens, regardless of prefix, being interpreted as non-switch arguments. Switch names should be lowercase ASCII and will be converted to such if necessary. Switch values will retain the original case and UTF8 encoding. This class can be used before CefInitialize() is called. Create a new CefCommandLine instance. Returns the singleton global CefCommandLine object. The returned object will be read-only. Returns true if this object is valid. Do not call any other methods if this function returns false. Returns true if the values of this object are read-only. Some APIs may expose read-only objects. Returns a writable copy of this object. Initialize the command line with the specified |argc| and |argv| values. The first argument must be the name of the program. This method is only supported on non-Windows platforms. Initialize the command line with the string returned by calling GetCommandLineW(). This method is only supported on Windows. Reset the command-line switches and arguments but leave the program component unchanged. Retrieve the original command line string as a vector of strings. The argv array: `{ program, [(--|-|/)switch[=value]]*, [--], [argument]* }` Constructs and returns the represented command line string. Use this method cautiously because quoting behavior is unclear. Get the program part of the command line string (the first item). Set the program part of the command line string (the first item). Returns true if the command line has switches. Returns true if the command line contains the given switch. Returns the value associated with the given switch. If the switch has no value or isn't present this method returns the empty string. Returns the map of switch names and values. If a switch has no value an empty string is returned. Add a switch to the end of the command line. Add a switch with the specified value to the end of the command line. If the switch has no value pass an empty value string. True if there are remaining command line arguments. Get the remaining command line arguments. Add an argument to the end of the command line. Insert a command before the current command. Common for debuggers, like "valgrind" or "gdb --args". Implement this interface to provide handler implementations. The handler instance will not be released until all objects related to the context have been destroyed. Called on the browser process UI thread immediately after the request context has been initialized. Called on the browser process IO thread before a resource request is initiated. The |browser| and |frame| values represent the source of the request, and may be NULL for requests originating from service workers or CefURLRequest. |request| represents the request contents and cannot be modified in this callback. |is_navigation| will be true if the resource request is a navigation. |is_download| will be true if the resource request is a download. |request_initiator| is the origin (scheme + domain) of the page that initiated the request. Set |disable_default_handling| to true to disable default handling of the request, in which case it will need to be handled via CefResourceRequestHandler::GetResourceHandler or it will be canceled. To allow the resource load to proceed with default handling return NULL. To specify a handler for the resource return a CefResourceRequestHandler object. This method will not be called if the client associated with |browser| returns a non-NULL value from CefRequestHandler::GetResourceRequestHandler for the same request (identified by CefRequest::GetIdentifier). Class used to implement browser process callbacks. The methods of this class will be called on the browser process main thread unless otherwise indicated. 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 and cef_settings_t.persist_user_preferences 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 and cef_request_context_settings_t.persist_user_preferences configuration. Do not keep a reference to the |registrar| object. This method is called on the browser process UI thread. Called on the browser process UI thread immediately after the CEF context has been initialized. 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. 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. 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 the Chrome runtime when creating new browser windows via Chrome UI. 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 the Chrome runtime when creating new browser windows via Chrome UI. Class used to implement render process callbacks. The methods of this class will be called on the render process main thread (TID_RENDERER) unless otherwise indicated. Called after WebKit has been initialized. Called after a browser has been created. When browsing cross-origin a new browser will be created before the old browser with the same identifier is destroyed. |extra_info| is an optional read-only value originating from CefBrowserHost::CreateBrowser(), CefBrowserHost::CreateBrowserSync(), CefLifeSpanHandler::OnBeforePopup() or CefBrowserView::CreateBrowserView(). Called before a browser is destroyed. Return the handler for browser load status events. Called immediately after the V8 context for a frame has been created. To retrieve the JavaScript 'window' object use the CefV8Context::GetGlobal() method. V8 handles can only be accessed from the thread on which they are created. A task runner for posting tasks on the associated thread can be retrieved via the CefV8Context::GetTaskRunner() method. Called immediately before the V8 context for a frame is released. No references to the context should be kept after this method is called. Called for global uncaught exceptions in a frame. Execution of this callback is disabled by default. To enable set cef_settings_t.uncaught_exception_stack_size > 0. Called when a new node in the the browser gets focus. The |node| value may be empty if no specific node has gained focus. The node object passed to this method represents a snapshot of the DOM at the time this method is executed. DOM objects are only valid for the scope of this method. Do not keep references to or attempt to access any DOM objects outside the scope of this method. Called when a new message is received from a different process. Return true if the message was handled or false otherwise. It is safe to keep a reference to |message| outside of this callback. Class used to implement a custom resource bundle interface. See CefSettings for additional options related to resource bundle loading. The methods of this class may be called on multiple threads. Called to retrieve a localized translation for the specified |string_id|. To provide the translation set |string| to the translation string and return true. To use the default translation return false. Include cef_pack_strings.h for a listing of valid string ID values. Called to retrieve data for the specified scale independent |resource_id|. To provide the resource data set |data| and |data_size| to the data pointer and size respectively and return true. To use the default resource data return false. The resource data will not be copied and must remain resident in memory. Include cef_pack_resources.h for a listing of valid resource ID values. Called to retrieve data for the specified |resource_id| nearest the scale factor |scale_factor|. To provide the resource data set |data| and |data_size| to the data pointer and size respectively and return true. To use the default resource data return false. The resource data will not be copied and must remain resident in memory. Include cef_pack_resources.h for a listing of valid resource ID values. Register a scheme handler factory with the global request context. An empty |domain_name| value for a standard scheme will cause the factory to match all domain names. The |domain_name| value will be ignored for non-standard schemes. If |scheme_name| is a built-in scheme and no handler is returned by |factory| then the built-in scheme handler factory will be called. If |scheme_name| is a custom scheme then you must also implement the CefApp::OnRegisterCustomSchemes() method in all processes. This function may be called multiple times to change or remove the factory that matches the specified |scheme_name| and optional |domain_name|. Returns false if an error occurs. This function may be called on any thread in the browser process. Using this function is equivalent to calling CefRequestContext::GetGlobalContext()->RegisterSchemeHandlerFactory(). Clear all scheme handler factories registered with the global request context. Returns false on error. This function may be called on any thread in the browser process. Using this function is equivalent to calling CefRequestContext::GetGlobalContext()->ClearSchemeHandlerFactories(). Class that manages custom scheme registrations. Register a custom scheme. This method should not be called for the built-in HTTP, HTTPS, FILE, FTP, ABOUT and DATA schemes. See cef_scheme_options_t for possible values for |options|. This function may be called on any thread. It should only be called once per unique |scheme_name| value. If |scheme_name| is already registered or if an error occurs this method will return false. Class that creates CefResourceHandler instances for handling scheme requests. The methods of this class will always be called on the IO thread. Return a new resource handler instance to handle the request or an empty reference to allow default handling of the request. |browser| and |frame| will be the browser window and frame respectively that originated the request or NULL if the request did not originate from a browser window (for example, if the request came from CefURLRequest). The |request| object passed to this method cannot be modified. This function should be called from the application entry point function to execute a secondary process. It can be used to run secondary processes from the browser client executable (default behavior) or from a separate executable specified by the cef_settings_t.browser_subprocess_path value. If called for the browser process (identified by no "type" command-line value) it will return immediately with a value of -1. If called for a recognized secondary process it will block until the process should exit and then return the process exit code. The |application| parameter may be empty. The |windows_sandbox_info| parameter is only used on Windows and may be NULL (see cef_sandbox_win.h for details). This function should be called on the main application thread to initialize the CEF browser process. The |application| parameter may be empty. Returns true if initialization succeeds. Returns false if initialization fails or if early exit is desired (for example, due to process singleton relaunch behavior). If this function returns false then the application should exit immediately without calling any other CEF functions except, optionally, CefGetErrorCode. The |windows_sandbox_info| parameter is only used on Windows and may be NULL (see cef_sandbox_win.h for details). This function can optionally be called on the main application thread after CefInitialize to retrieve the initialization exit code. When CefInitialize returns true the exit code will be 0 (CEF_RESULT_CODE_NORMAL_EXIT). Otherwise, see cef_resultcode_t for possible exit code values including browser process initialization errors and normal early exit conditions (such as CEF_RESULT_CODE_NORMAL_EXIT_PROCESS_NOTIFIED for process singleton relaunch behavior). This function should be called on the main application thread to shut down the CEF browser process before the application exits. Do not call any other CEF functions after calling this function. Perform a single iteration of CEF message loop processing. This function is provided for cases where the CEF message loop must be integrated into an existing application message loop. Use of this function is not recommended for most users; use either the CefRunMessageLoop() function or cef_settings_t.multi_threaded_message_loop if possible. When using this function care must be taken to balance performance against excessive CPU usage. It is recommended to enable the cef_settings_t.external_message_pump option when using this function so that CefBrowserProcessHandler::OnScheduleMessagePumpWork() callbacks can facilitate the scheduling process. This function should only be called on the main application thread and only if CefInitialize() is called with a cef_settings_t.multi_threaded_message_loop value of false. This function will not block. Run the CEF message loop. Use this function instead of an application- provided message loop to get the best balance between performance and CPU usage. This function should only be called on the main application thread and only if CefInitialize() is called with a cef_settings_t.multi_threaded_message_loop value of false. This function will block until a quit message is received by the system. Quit the CEF message loop that was started by calling CefRunMessageLoop(). This function should only be called on the main application thread and only if CefRunMessageLoop() was used. Implement this interface to provide handler implementations. Methods will be called by the process and/or thread indicated. Provides an opportunity to view and/or modify command-line arguments before processing by CEF and Chromium. The |process_type| value will be empty for the browser process. Do not keep a reference to the CefCommandLine object passed to this method. The cef_settings_t.command_line_args_disabled value can be used to start with an empty command-line object. Any values specified in CefSettings that equate to command-line arguments will be set before this method is called. Be cautious when using this method to modify command-line arguments for non-browser processes as this may result in undefined behavior including crashes. Provides an opportunity to register custom schemes. Do not keep a reference to the |registrar| object. This method is called on the main thread for each process and the registered schemes should be the same across all processes. Return the handler for resource bundle events. If cef_settings_t.pack_loading_disabled is true a handler must be returned. If no handler is returned resources will be loaded from pack files. This method is called by the browser and render processes on multiple threads. Return the handler for functionality specific to the browser process. This method is called on multiple threads in the browser process. Return the handler for functionality specific to the render process. This method is called on the render process main thread.

Browser initialization settings. Specify NULL or 0 to get the recommended default values. The consequences of using custom values may not be well tested. Many of these and other settings can also configured using command- line switches.

Internal Constructor

Default Constructor

Finalizer.

Destructor.

StandardFontFamily

FixedFontFamily

SerifFontFamily

SansSerifFontFamily

CursiveFontFamily

FantasyFontFamily

DefaultFontSize

DefaultFixedFontSize

MinimumFontSize

MinimumLogicalFontSize

Default encoding for Web content. If empty "ISO-8859-1" will be used. Also configurable using the "default-encoding" command-line switch.

Controls the loading of fonts from remote sources. Also configurable using the "disable-remote-fonts" command-line switch.

Controls whether JavaScript can be executed. (Used to Enable/Disable javascript) Also configurable using the "disable-javascript" command-line switch.

Controls whether JavaScript can be used to close windows that were not opened via JavaScript. JavaScript can still be used to close windows that were opened via JavaScript. Also configurable using the "disable-javascript-close-windows" command-line switch.

Controls whether JavaScript can access the clipboard. Also configurable using the "disable-javascript-access-clipboard" command-line switch.

Controls whether DOM pasting is supported in the editor via execCommand("paste"). The |javascript_access_clipboard| setting must also be enabled. Also configurable using the "disable-javascript-dom-paste" command-line switch.

Controls whether image URLs will be loaded from the network. A cached image will still be rendered if requested. Also configurable using the "disable-image-loading" command-line switch.

Controls whether standalone images will be shrunk to fit the page. Also configurable using the "image-shrink-standalone-to-fit" command-line switch.

Controls whether text areas can be resized. Also configurable using the "disable-text-area-resize" command-line switch.

Controls whether the tab key can advance focus to links. Also configurable using the "disable-tab-to-links" command-line switch.

Controls whether local storage can be used. Also configurable using the "disable-local-storage" command-line switch.

Controls whether databases can be used. Also configurable using the "disable-databases" command-line switch.

Controls whether WebGL can be used. Note that WebGL requires hardware support and may not work on all systems even when enabled. Also configurable using the "disable-webgl" command-line switch.

Background color used for the browser before a document is loaded and when no document color is specified. The alpha component must be either fully opaque (0xFF) or fully transparent (0x00). If the alpha component is fully opaque then the RGB components will be used as the background color. If the alpha component is fully transparent for a WinForms browser then the CefSettings.BackgroundColor value will be used. If the alpha component is fully transparent for a windowless (WPF/OffScreen) browser then transparent painting will be enabled.

The maximum rate in frames per second (fps) that CefRenderHandler::OnPaint will be called for a windowless browser. The actual fps may be lower if the browser cannot generate frames at the requested rate. The minimum value is 1 and the maximum value is 60 (default 30). This value can also be changed dynamically via IBrowserHost.SetWindowlessFrameRate.

Gets a value indicating if the browser settings has been disposed.

True if dispose should be called after this object is used

RequestContextSettings

Initializes a new instance of the RequestContextSettings class.

To persist session cookies (cookies without an expiry date or validity interval) by default when using the global cookie manager set this value to true. Session cookies are generally intended to be transient and most Web browsers do not persist them. Can be set globally using the CefSettings.PersistSessionCookies value. This value will be ignored if CachePath is empty or if it matches the CefSettings.CachePath value.

To persist user preferences as a JSON file in the cache path directory set this value to true. Can be set globally using the CefSettings.PersistUserPreferences value. This value will be ignored if CachePath is empty or if it matches the CefSettings.CachePath value.

The location where cache data for this request context will be stored on disk. If this value is non-empty then it must be an absolute path that is either equal to or a child directory of CefSettings.RootCachePath. If the value is empty then browsers will be created in "incognito mode" where in-memory caches are used for storage and no data is persisted to disk. HTML5 databases such as localStorage will only persist across sessions if a cache path is specified. To share the global browser cache and related configuration set this value to match the CefSettings.CachePath value.

Comma delimited ordered list of language codes without any whitespace that will be used in the "Accept-Language" HTTP header. Can be set globally using the CefSettings.accept_language_list value or overridden on a per- browser basis using the BrowserSettings.AcceptLanguageList value. If all values are empty then "en-US,en" will be used. This value will be ignored if CachePath matches the CefSettings.CachePath value.

Comma delimited list of schemes supported by the associated ICookieManager. If CookieableSchemesExcludeDefaults is false the default schemes ("http", "https", "ws" and "wss") will also be supported. Specifying a CookieableSchemesList value and setting CookieableSchemesExcludeDefaults to true will disable all loading and saving of cookies for this manager. This value will be ignored if matches the value.

If CookieableSchemesExcludeDefaults is false the default schemes ("http", "https", "ws" and "wss") will also be supported. Specifying a CookieableSchemesList value and setting CookieableSchemesExcludeDefaults to true will disable all loading and saving of cookies for this manager. This value will be ignored if matches the value.

A request context provides request handling for a set of related browser objects. A request context is specified when creating a new browser object via the CefBrowserHost static factory methods. Browser objects with different request contexts will never be hosted in the same render process. Browser objects with the same request context may or may not be hosted in the same render process depending on the process model. Browser objects created indirectly via the JavaScript window.open function or targeted links will share the same render process and the same request context as the source browser. When running in single-process mode there is only a single render process (the main process) and so all browsers created in single-process mode will share the same request context. This will be the first request context passed into a CefBrowserHost static factory method and all other request context objects will be ignored.

Creates a new context object that shares storage with | other | and uses an optional | handler | .

Creates a new context object that shares storage with other and uses an optional handler.

shares storage with this RequestContext optional requestContext handler Returns a new RequestContext

Returns true if this object is pointing to the same context object.

context to compare Returns true if the same

Returns true if this object is sharing the same storage as the specified context.

context to compare Returns true if same storage

Returns the default cookie manager for this object. This will be the global cookie manager if this object is the global request context.

If callback is non-NULL it will be executed asnychronously on the CEF IO thread after the manager's storage has been initialized. Returns the default cookie manager for this object

Returns true if this object is the global context. The global context is used by default when creating a browser or URL request with a NULL context argument.

Register a scheme handler factory for the specified schemeName and optional domainName. An empty domainName value for a standard scheme will cause the factory to match all domain names. The domainName value will be ignored for non-standard schemes. If schemeName is a built-in scheme and no handler is returned by factory then the built-in scheme handler factory will be called. If schemeName is a custom scheme then you must also implement the IApp.OnRegisterCustomSchemes() method in all processes. This function may be called multiple times to change or remove the factory that matches the specified schemeName and optional domainName.

Scheme Name Optional domain name Scheme handler factory Returns false if an error occurs.

Clear all registered scheme handler factories.

Returns false on error.

Returns the cache path for this object. If empty an "incognito mode" in-memory cache is being used.

Returns true if a preference with the specified name exists. This method must be called on the CEF UI thread.

name of preference bool if the preference exists Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Returns the value for the preference with the specified name. Returns NULL if the preference does not exist. The returned object contains a copy of the underlying preference value and modifications to the returned object will not modify the underlying preference value. This method must be called on the CEF UI thread.

preference name Returns the value for the preference with the specified name Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Returns all preferences as a dictionary. The returned object contains a copy of the underlying preference values and modifications to the returned object will not modify the underlying preference values. This method must be called on the browser process UI thread.

If true then preferences currently at their default value will be included. Preferences (dictionary can have sub dictionaries)

Returns true if the preference with the specified name can be modified using SetPreference. As one example preferences set via the command-line usually cannot be modified. This method must be called on the CEF UI thread.

preference key Returns true if the preference with the specified name can be modified using SetPreference Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Set the value associated with preference name. If value is null the preference will be restored to its default value. If setting the preference fails then error will be populated with a detailed description of the problem. This method must be called on the CEF UI thread. Preferences set via the command-line usually cannot be modified.

preference key preference value out error Returns true if the value is set successfully and false otherwise. Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Clears all certificate exceptions that were added as part of handling . If you call this it is recommended that you also call or you risk not being prompted again for server certificates if you reconnect quickly.

If is non-NULL it will be executed on the CEF UI thread after completion. This param is optional

Clears all HTTP authentication credentials that were added as part of handling .

If is non-NULL it will be executed on the CEF UI thread after completion. This param is optional

Clears all active and idle connections that Chromium currently has. This is only recommended if you have released all other CEF objects but don't yet want to call Cef.Shutdown().

If is non-NULL it will be executed on the CEF UI thread after completion. This param is optional

Attempts to resolve origin to a list of associated IP addresses.

host name to resolve A task that represents the Resoolve Host operation. The value of the TResult parameter contains ResolveCallbackResult.

Returns true if this context was used to load the extension identified by extensionId. Other contexts sharing the same storage will also have access to the extension (see HasExtension). This method must be called on the CEF UI thread.

Returns true if this context was used to load the extension identified by extensionId Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Returns the extension matching extensionId or null if no matching extension is accessible in this context (see HasExtension). This method must be called on the CEF UI thread.

extension Id Returns the extension matching extensionId or null if no matching extension is accessible in this context Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Retrieve the list of all extensions that this context has access to (see HasExtension). will be populated with the list of extension ID values. This method must be called on the CEF UI thread.

output a list of extensions Ids returns true on success otherwise false Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Returns true if this context has access to the extension identified by extensionId. This may not be the context that was used to load the extension (see DidLoadExtension). This method must be called on the CEF UI thread.

extension id Returns true if this context has access to the extension identified by extensionId Use Cef.UIThreadTaskFactory to execute this method if required, and ChromiumWebBrowser.IsBrowserInitializedChanged are both executed on the CEF UI thread, so can be called directly. When CefSettings.MultiThreadedMessageLoop == false (the default is true) then the main application thread will be the CEF UI thread.

Load an extension. If extension resources will be read from disk using the default load implementation then rootDirectoy should be the absolute path to the extension resources directory and manifestJson should be null. If extension resources will be provided by the client (e.g. via IRequestHandler and/or IExtensionHandler) then rootDirectory should be a path component unique to the extension (if not absolute this will be internally prefixed with the PK_DIR_RESOURCES path) and manifestJson should contain the contents that would otherwise be read from the "manifest.json" file on disk. The loaded extension will be accessible in all contexts sharing the same storage (HasExtension returns true). However, only the context on which this method was called is considered the loader (DidLoadExtension returns true) and only the loader will receive IRequestContextHandler callbacks for the extension. will be called on load success or will be called on load failure. If the extension specifies a background script via the "background" manifest key then will be called to create the background browser. See that method for additional information about background scripts. For visible extension views the client application should evaluate the manifest to determine the correct extension URL to load and then pass that URL to the IBrowserHost.CreateBrowser* function after the extension has loaded. For example, the client can look for the "browser_action" manifest key as documented at https://developer.chrome.com/extensions/browserAction. Extension URLs take the form "chrome-extension:///". Browsers that host extensions differ from normal browsers as follows: - Can access chrome.* JavaScript APIs if allowed by the manifest. Visit chrome://extensions-support for the list of extension APIs currently supported by CEF. - Main frame navigation to non-extension content is blocked. - Pinch-zooming is disabled. - returns the hosted extension. - CefBrowserHost::IsBackgroundHost returns true for background hosts. See https://developer.chrome.com/extensions for extension implementation and usage documentation.

If extension resources will be read from disk using the default load implementation then rootDirectoy should be the absolute path to the extension resources directory and manifestJson should be null If extension resources will be provided by the client then rootDirectory should be a path component unique to the extension and manifestJson should contain the contents that would otherwise be read from the manifest.json file on disk handle events related to browser extensions

Gets the inner most instance

current instance

Returns the bitmap representation that most closely matches scaleFactor.

scale factor color type alpha type pixel width pixel height A stream represending the bitmap or null.

Returns the JPEG representation that most closely matches scaleFactor.

scale factor image quality pixel width pixel height A stream representing the JPEG or null.

Returns the PNG representation that most closely matches scaleFactor.

scale factor is the PNG transparent pixel width pixel height A stream represending the PNG or null.

Returns information for the representation that most closely matches scaleFactor.

scale factor actual scale factor pixel width pixel height return if information found for scale factor

Returns the image height in density independent pixel(DIP) units.

Returns true if this image contains a representation for scaleFactor.

Returns true if this Image is empty.

Returns true if this Image and that Image share the same underlying storage.

image to compare returns true if share same underlying storage

Removes the representation for scaleFactor.

true for success

Returns the image width in density independent pixel(DIP) units.

Get the image representation of drag data. May return NULL if no image representation is available.

Get the image hotspot (drag start location relative to image dimensions).