From ba77439507f8462cbd14a07b657033c2e6c62bce Mon Sep 17 00:00:00 2001 From: "Adam D. Ruppe" Date: Tue, 15 Nov 2022 09:53:29 -0500 Subject: [PATCH] update cef to latest again --- minigui_addons/webview.d | 56 +- webview.d | 11083 +++++++++++++++++++------------------ 2 files changed, 5877 insertions(+), 5262 deletions(-) diff --git a/minigui_addons/webview.d b/minigui_addons/webview.d index 61e3464..011cb84 100644 --- a/minigui_addons/webview.d +++ b/minigui_addons/webview.d @@ -457,12 +457,16 @@ class WebViewWidget_CEF : WebViewWidgetBase { this.parentWindow.addEventListener((scope ClosingEvent ce) { if(devTools) devTools.close(); - if(!closeAttempted && browserHandle) { - browserHandle.get_host.close_browser(true); - ce.preventDefault(); - // sdpyPrintDebugString("closing"); + if(browserHandle) { + if(!closeAttempted) { + closeAttempted = true; + browserHandle.get_host.close_browser(false); + ce.preventDefault(); + } else { + browserHandle.get_host.close_browser(true); + } + sdpyPrintDebugString("closing"); } - closeAttempted = true; }); } @@ -491,7 +495,6 @@ class WebViewWidget_CEF : WebViewWidgetBase { private static WebViewWidget[NativeWindowHandle] browserMapping; private { - int findingIdent; string findingText; bool findingCase; } @@ -501,11 +504,9 @@ class WebViewWidget_CEF : WebViewWidgetBase { if(browserHandle) { auto host = browserHandle.get_host(); - static ident = 0; auto txt = cef_string_t(text); - host.find(++ident, &txt, forward, matchCase, findNext); + host.find(&txt, forward, matchCase, findNext); - findingIdent = ident; findingText = text; findingCase = matchCase; } @@ -513,36 +514,28 @@ class WebViewWidget_CEF : WebViewWidgetBase { // ditto void findPrevious() { - if(findingIdent == 0) - return; if(!browserHandle) return; auto host = browserHandle.get_host(); auto txt = cef_string_t(findingText); - host.find(findingIdent, &txt, 0, findingCase, 1); + host.find(&txt, 0, findingCase, 1); } // ditto void findNext() { - if(findingIdent == 0) - return; if(!browserHandle) return; auto host = browserHandle.get_host(); auto txt = cef_string_t(findingText); - host.find(findingIdent, &txt, 1, findingCase, 1); + host.find(&txt, 1, findingCase, 1); } // ditto void stopFind() { - if(findingIdent == 0) - return; if(!browserHandle) return; auto host = browserHandle.get_host(); host.stop_finding(1); - - findingIdent = 0; } override void refresh() { if(browserHandle) browserHandle.reload(); } @@ -773,8 +766,7 @@ version(cef) { } class MiniguiDialogHandler : CEF!cef_dialog_handler_t { - - override int on_file_dialog(RC!(cef_browser_t) browser, cef_file_dialog_mode_t mode, const(cef_string_utf16_t)* title, const(cef_string_utf16_t)* default_file_path, cef_string_list_t accept_filters, int selected_accept_filter, RC!(cef_file_dialog_callback_t) callback) { + override int on_file_dialog(RC!(cef_browser_t) browser, cef_file_dialog_mode_t mode, const(cef_string_utf16_t)* title, const(cef_string_utf16_t)* default_file_path, cef_string_list_t accept_filters, RC!(cef_file_dialog_callback_t) callback) { try { auto ptr = callback.passable(); browser.runOnWebView((wv) { @@ -783,11 +775,11 @@ version(cef) { auto list = libcef.string_list_alloc(); auto item = cef_string_t(name); libcef.string_list_append(list, &item); - callback.cont(selected_accept_filter, list); + callback.cont(list); }, null, null, () { auto callback = RC!cef_file_dialog_callback_t(ptr); callback.cancel(); - }); + }, "/home/me/"); }); } catch(Exception e) {} @@ -818,6 +810,10 @@ version(cef) { sdpyPrintDebugString(download_item.get_percent_complete()); // FIXME } + + override int can_download(RC!(cef_browser_t), const(cef_string_utf16_t)*, const(cef_string_utf16_t)*) { + return 1; + } } class MiniguiKeyboardHandler : CEF!cef_keyboard_handler_t { @@ -951,6 +947,9 @@ version(cef) { override int on_cursor_change(RC!(cef_browser_t), cef_cursor_handle_t, cef_cursor_type_t, const(cef_cursor_info_t)*) { return 0; } + override void on_media_access_change(RC!(cef_browser_t), int, int) { + + } } class MiniguiRequestHandler : CEF!cef_request_handler_t { @@ -975,9 +974,6 @@ version(cef) { } override int on_select_client_certificate(RC!(cef_browser_t), int, const(cef_string_utf16_t)*, int, ulong, cef_x509certificate_t**, RC!(cef_select_client_certificate_callback_t)) nothrow { return 0; - } - override void on_plugin_crashed(RC!(cef_browser_t), const(cef_string_utf16_t)*) nothrow { - } override void on_render_view_ready(RC!(cef_browser_t) p) nothrow { @@ -1116,6 +1112,14 @@ version(cef) { return null; } + override cef_command_handler_t* get_command_handler() { + return null; + } + + override cef_permission_handler_t* get_permission_handler() { + return null; + } + } } diff --git a/webview.d b/webview.d index 36602f2..71289a7 100644 --- a/webview.d +++ b/webview.d @@ -10,8 +10,13 @@ I currently built against 95.7.17+g4208276+chromium-95.0.4638.69 and it uses UTF-16 strings. - Then to install the cef put in the Resources in the RElease directory and - copy the locales to /opt/cef/Resources/Locales + cef_binary_107.1.9+g1f0a21a+chromium-107.0.5304.110_linux64_minimal.tar.bz2 + + Note my ceftranslate.d for instructions to start the update process. + + Then to install the cef put in the Resources in the Release directory (*.pak and *.dat + out of Resources, failure to do this will cause an abort on ICU file descriptor things) + and copy the locales to /opt/cef/Resources/Locales You can download compatible builds from https://cef-builds.spotifycdn.com/index.html just make sure to put in the version filter and check "all builds" to match it. @@ -531,7 +536,7 @@ struct libcef { alias mem = __traits(getMember, libcef, memberName); mem = cast(typeof(mem)) loadsym("cef_" ~ memberName); if(mem is null) { - // writeln(memberName); + // import std.stdio; writeln(memberName); // throw new Exception("cef_" ~ memberName ~ " failed to load"); return false; } @@ -1334,6 +1339,9 @@ struct cef_string_utf8_t { void* dtor;// void (*dtor)(char* str); } +struct cef_basetime_t { + long val; +} struct cef_string_utf16_t { @@ -1468,7 +1476,7 @@ version=embedded_cef_bindings; // everything inside these brackets are the bindings you can replace if update needed version(embedded_cef_bindings) { -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -1504,18 +1512,18 @@ version(embedded_cef_bindings) { extern (C): -enum CEF_VERSION = "95.7.17+g4208276+chromium-95.0.4638.69"; -enum CEF_VERSION_MAJOR = 95; -enum CEF_VERSION_MINOR = 7; -enum CEF_VERSION_PATCH = 17; -enum CEF_COMMIT_NUMBER = 2459; -enum CEF_COMMIT_HASH = "4208276762b1f52ed444debd7caa84fc3332e6a9"; -enum COPYRIGHT_YEAR = 2021; +enum CEF_VERSION = "107.1.9+g1f0a21a+chromium-107.0.5304.110"; +enum CEF_VERSION_MAJOR = 107; +enum CEF_VERSION_MINOR = 1; +enum CEF_VERSION_PATCH = 9; +enum CEF_COMMIT_NUMBER = 2687; +enum CEF_COMMIT_HASH = "1f0a21a25e61786ef3e8b3a20908e7631ad29c71"; +enum COPYRIGHT_YEAR = 2022; -enum CHROME_VERSION_MAJOR = 95; +enum CHROME_VERSION_MAJOR = 107; enum CHROME_VERSION_MINOR = 0; -enum CHROME_VERSION_BUILD = 4638; -enum CHROME_VERSION_PATCH = 69; +enum CHROME_VERSION_BUILD = 5304; +enum CHROME_VERSION_PATCH = 110; @@ -1535,7 +1543,7 @@ int cef_version_info (int entry); // APSTUDIO_HIDDEN_SYMBOLS // CEF_INCLUDE_CEF_VERSION_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -1576,9 +1584,9 @@ extern (C): // way that may cause binary incompatibility with other builds. The universal // hash value will change if any platform is affected whereas the platform hash // values will change only if that particular platform is affected. -enum CEF_API_HASH_UNIVERSAL = "21ac25aebdb49a8e8088c6fbee802b04fd07b501"; +enum CEF_API_HASH_UNIVERSAL = "a63640eaa583092b069ec9895526b3e9e4932f6a"; -enum CEF_API_HASH_PLATFORM = "0b5227787444955a548b7544b2cdcda95a354506"; +enum CEF_API_HASH_PLATFORM = "d9657b0023ae05b5b92787b5e7da70893caf15af"; /// // Returns CEF API hashes for the libcef library. The returned string is owned @@ -1623,7 +1631,7 @@ const(char)* cef_api_hash (int entry); extern (C): /// -// Structure representing a point. +/// Structure representing a point. /// struct cef_point_t { @@ -1634,7 +1642,7 @@ struct cef_point_t /// -// Structure representing a rectangle. +/// Structure representing a rectangle. /// struct cef_rect_t { @@ -1647,7 +1655,7 @@ struct cef_rect_t /// -// Structure representing a size. +/// Structure representing a size. /// struct cef_size_t { @@ -1658,7 +1666,7 @@ struct cef_size_t /// -// Structure representing insets. +/// Structure representing insets. /// struct cef_insets_t { @@ -1735,423 +1743,420 @@ alias cef_color_t = uint; /// -// Log severity levels. +/// Log severity levels. /// enum cef_log_severity_t { /// - // Default logging (currently INFO logging). + /// Default logging (currently INFO logging). /// LOGSEVERITY_DEFAULT = 0, /// - // Verbose logging. + /// Verbose logging. /// LOGSEVERITY_VERBOSE = 1, /// - // DEBUG logging. + /// DEBUG logging. /// LOGSEVERITY_DEBUG = LOGSEVERITY_VERBOSE, /// - // INFO logging. + /// INFO logging. /// LOGSEVERITY_INFO = 2, /// - // WARNING logging. + /// WARNING logging. /// LOGSEVERITY_WARNING = 3, /// - // ERROR logging. + /// ERROR logging. /// LOGSEVERITY_ERROR = 4, /// - // FATAL logging. + /// FATAL logging. /// LOGSEVERITY_FATAL = 5, /// - // Disable logging to file for all messages, and to stderr for messages with - // severity less than FATAL. + /// Disable logging to file for all messages, and to stderr for messages with + /// severity less than FATAL. /// LOGSEVERITY_DISABLE = 99 } /// -// Represents the state of a setting. +/// Represents the state of a setting. /// enum cef_state_t { /// - // Use the default state for the setting. + /// Use the default state for the setting. /// STATE_DEFAULT = 0, /// - // Enable or allow the setting. + /// Enable or allow the setting. /// STATE_ENABLED = 1, /// - // Disable or disallow the setting. + /// Disable or disallow the setting. /// STATE_DISABLED = 2 } /// -// Initialization settings. Specify NULL or 0 to get the recommended default -// values. Many of these and other settings can also configured using command- -// line switches. +/// Initialization settings. Specify NULL or 0 to get the recommended default +/// values. Many of these and other settings can also configured using command- +/// line switches. /// struct cef_settings_t { /// - // Size of this structure. + /// Size of this structure. /// size_t size; /// - // Set to true (1) to disable the sandbox for sub-processes. See - // cef_sandbox_win.h for requirements to enable the sandbox on Windows. Also - // configurable using the "no-sandbox" command-line switch. + /// Set to true (1) to disable the sandbox for sub-processes. See + /// cef_sandbox_win.h for requirements to enable the sandbox on Windows. Also + /// configurable using the "no-sandbox" command-line switch. /// int no_sandbox; /// - // The path to a separate executable that will be launched for sub-processes. - // If this value is empty on Windows or Linux then the main process executable - // will be used. If this value is empty on macOS then a helper executable must - // exist at "Contents/Frameworks/ Helper.app/Contents/MacOS/ Helper" - // in the top-level app bundle. See the comments on CefExecuteProcess() for - // details. If this value is non-empty then it must be an absolute path. Also - // configurable using the "browser-subprocess-path" command-line switch. + /// The path to a separate executable that will be launched for sub-processes. + /// If this value is empty on Windows or Linux then the main process + /// executable will be used. If this value is empty on macOS then a helper + /// executable must exist at "Contents/Frameworks/ + /// Helper.app/Contents/MacOS/ Helper" in the top-level app bundle. See + /// the comments on CefExecuteProcess() for details. If this value is + /// non-empty then it must be an absolute path. Also configurable using the + /// "browser-subprocess-path" command-line switch. /// cef_string_t browser_subprocess_path; /// - // The path to the CEF framework directory on macOS. If this value is empty - // then the framework must exist at "Contents/Frameworks/Chromium Embedded - // Framework.framework" in the top-level app bundle. If this value is - // non-empty then it must be an absolute path. Also configurable using the - // "framework-dir-path" command-line switch. + /// The path to the CEF framework directory on macOS. If this value is empty + /// then the framework must exist at "Contents/Frameworks/Chromium Embedded + /// Framework.framework" in the top-level app bundle. If this value is + /// non-empty then it must be an absolute path. Also configurable using the + /// "framework-dir-path" command-line switch. /// cef_string_t framework_dir_path; /// - // The path to the main bundle on macOS. If this value is empty then it - // defaults to the top-level app bundle. If this value is non-empty then it - // must be an absolute path. Also configurable using the "main-bundle-path" - // command-line switch. + /// The path to the main bundle on macOS. If this value is empty then it + /// defaults to the top-level app bundle. If this value is non-empty then it + /// must be an absolute path. Also configurable using the "main-bundle-path" + /// command-line switch. /// cef_string_t main_bundle_path; /// - // Set to true (1) to enable use of the Chrome runtime in CEF. This feature is - // considered experimental and is not recommended for most users at this time. - // See issue #2969 for details. + /// Set to true (1) to enable use of the Chrome runtime in CEF. This feature + /// is considered experimental and is not recommended for most users at this + /// time. See issue #2969 for details. /// int chrome_runtime; /// - // Set to true (1) to have the browser process message loop run in a separate - // thread. If false (0) than the CefDoMessageLoopWork() function must be - // called from your application message loop. This option is only supported on - // Windows and Linux. + /// Set to true (1) to have the browser process message loop run in a separate + /// thread. If false (0) then the CefDoMessageLoopWork() function must be + /// called from your application message loop. This option is only supported + /// on Windows and Linux. /// int multi_threaded_message_loop; /// - // Set to true (1) to control browser process main (UI) thread message pump - // scheduling via the CefBrowserProcessHandler::OnScheduleMessagePumpWork() - // callback. This option is recommended for use in combination with the - // CefDoMessageLoopWork() function in cases where the CEF message loop must be - // integrated into an existing application message loop (see additional - // comments and warnings on CefDoMessageLoopWork). Enabling this option is not - // recommended for most users; leave this option disabled and use either the - // CefRunMessageLoop() function or multi_threaded_message_loop if possible. + /// Set to true (1) to control browser process main (UI) thread message pump + /// scheduling via the CefBrowserProcessHandler::OnScheduleMessagePumpWork() + /// callback. This option is recommended for use in combination with the + /// CefDoMessageLoopWork() function in cases where the CEF message loop must + /// be integrated into an existing application message loop (see additional + /// comments and warnings on CefDoMessageLoopWork). Enabling this option is + /// not recommended for most users; leave this option disabled and use either + /// the CefRunMessageLoop() function or multi_threaded_message_loop if + /// possible. /// int external_message_pump; /// - // Set to true (1) to enable windowless (off-screen) rendering support. Do not - // enable this value if the application does not use windowless rendering as - // it may reduce rendering performance on some systems. + /// Set to true (1) to enable windowless (off-screen) rendering support. Do + /// not enable this value if the application does not use windowless rendering + /// as it may reduce rendering performance on some systems. /// int windowless_rendering_enabled; /// - // Set to true (1) to disable configuration of browser process features using - // standard CEF and Chromium command-line arguments. Configuration can still - // be specified using CEF data structures or via the - // CefApp::OnBeforeCommandLineProcessing() method. + /// Set to true (1) to disable configuration of browser process features using + /// standard CEF and Chromium command-line arguments. Configuration can still + /// be specified using CEF data structures or via the + /// CefApp::OnBeforeCommandLineProcessing() method. /// int command_line_args_disabled; /// - // The location where data for the global browser cache 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.root_cache_path. If - // this 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. Can be overridden for individual CefRequestContext - // instances via the CefRequestContextSettings.cache_path value. When using - // the Chrome runtime the "default" profile will be used if |cache_path| and - // |root_cache_path| have the same value. + /// The location where data for the global browser cache 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.root_cache_path. If + /// this 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. Can be overridden for individual + /// CefRequestContext instances via the CefRequestContextSettings.cache_path + /// value. When using the Chrome runtime the "default" profile will be used if + /// |cache_path| and |root_cache_path| have the same value. /// cef_string_t cache_path; /// - // The root directory that all CefSettings.cache_path and - // CefRequestContextSettings.cache_path values must have in common. If this - // value is empty and CefSettings.cache_path is non-empty then it will - // default to the CefSettings.cache_path value. If this value is non-empty - // then it must be an absolute path. Failure to set this value correctly may - // result in the sandbox blocking read/write access to the cache_path - // directory. + /// The root directory that all CefSettings.cache_path and + /// CefRequestContextSettings.cache_path values must have in common. If this + /// value is empty and CefSettings.cache_path is non-empty then it will + /// default to the CefSettings.cache_path value. If this value is non-empty + /// then it must be an absolute path. Failure to set this value correctly may + /// result in the sandbox blocking read/write access to the cache_path + /// directory. /// cef_string_t root_cache_path; /// - // The location where user data such as the Widevine CDM module and spell - // checking dictionary files will be stored on disk. If this value is empty - // then the default platform-specific user data directory will be used - // ("~/.config/cef_user_data" directory on Linux, "~/Library/Application - // Support/CEF/User Data" directory on MacOS, "AppData\Local\CEF\User Data" - // directory under the user profile directory on Windows). If this value is - // non-empty then it must be an absolute path. When using the Chrome runtime - // this value will be ignored in favor of the |root_cache_path| value. + /// The location where user data such as the Widevine CDM module and spell + /// checking dictionary files will be stored on disk. If this value is empty + /// then the default platform-specific user data directory will be used + /// ("~/.config/cef_user_data" directory on Linux, "~/Library/Application + /// Support/CEF/User Data" directory on MacOS, "AppData\Local\CEF\User Data" + /// directory under the user profile directory on Windows). If this value is + /// non-empty then it must be an absolute path. When using the Chrome runtime + /// this value will be ignored in favor of the |root_cache_path| value. /// cef_string_t user_data_path; /// - // 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 (1). Session cookies are generally intended to be transient and most - // Web browsers do not persist them. A |cache_path| value must also be - // specified to enable this feature. Also configurable using the - // "persist-session-cookies" command-line switch. Can be overridden for - // individual CefRequestContext instances via the - // CefRequestContextSettings.persist_session_cookies value. + /// 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 (1). Session cookies are generally intended to be transient and + /// most Web browsers do not persist them. A |cache_path| value must also be + /// specified to enable this feature. Also configurable using the + /// "persist-session-cookies" command-line switch. Can be overridden for + /// individual CefRequestContext instances via the + /// CefRequestContextSettings.persist_session_cookies value. /// int persist_session_cookies; /// - // To persist user preferences as a JSON file in the cache path directory set - // this value to true (1). A |cache_path| value must also be specified - // to enable this feature. Also configurable using the - // "persist-user-preferences" command-line switch. Can be overridden for - // individual CefRequestContext instances via the - // CefRequestContextSettings.persist_user_preferences value. + /// To persist user preferences as a JSON file in the cache path directory set + /// this value to true (1). A |cache_path| value must also be specified + /// to enable this feature. Also configurable using the + /// "persist-user-preferences" command-line switch. Can be overridden for + /// individual CefRequestContext instances via the + /// CefRequestContextSettings.persist_user_preferences value. /// int persist_user_preferences; /// - // Value that will be returned as the User-Agent HTTP header. If empty the - // default User-Agent string will be used. Also configurable using the - // "user-agent" command-line switch. + /// Value that will be returned as the User-Agent HTTP header. If empty the + /// default User-Agent string will be used. Also configurable using the + /// "user-agent" command-line switch. /// cef_string_t user_agent; /// - // Value that will be inserted as the product portion of the default - // User-Agent string. If empty the Chromium product version will be used. If - // |userAgent| is specified this value will be ignored. Also configurable - // using the "user-agent-product" command-line switch. + /// Value that will be inserted as the product portion of the default + /// User-Agent string. If empty the Chromium product version will be used. If + /// |userAgent| is specified this value will be ignored. Also configurable + /// using the "user-agent-product" command-line switch. /// cef_string_t user_agent_product; /// - // The locale string that will be passed to WebKit. If empty the default - // locale of "en-US" will be used. This value is ignored on Linux where locale - // is determined using environment variable parsing with the precedence order: - // LANGUAGE, LC_ALL, LC_MESSAGES and LANG. Also configurable using the "lang" - // command-line switch. + /// The locale string that will be passed to WebKit. If empty the default + /// locale of "en-US" will be used. This value is ignored on Linux where + /// locale is determined using environment variable parsing with the + /// precedence order: LANGUAGE, LC_ALL, LC_MESSAGES and LANG. Also + /// configurable using the "lang" command-line switch. /// cef_string_t locale; /// - // The directory and file name to use for the debug log. If empty a default - // log file name and location will be used. On Windows and Linux a "debug.log" - // file will be written in the main executable directory. On MacOS a - // "~/Library/Logs/_debug.log" file will be written where - // is the name of the main app executable. Also configurable using the - // "log-file" command-line switch. + /// The directory and file name to use for the debug log. If empty a default + /// log file name and location will be used. On Windows and Linux a + /// "debug.log" file will be written in the main executable directory. On + /// MacOS a "~/Library/Logs/[app name]_debug.log" file will be written where + /// [app name] is the name of the main app executable. Also configurable using + /// the "log-file" command-line switch. /// cef_string_t log_file; /// - // The log severity. Only messages of this severity level or higher will be - // logged. When set to DISABLE no messages will be written to the log file, - // but FATAL messages will still be output to stderr. Also configurable using - // the "log-severity" command-line switch with a value of "verbose", "info", - // "warning", "error", "fatal" or "disable". + /// The log severity. Only messages of this severity level or higher will be + /// logged. When set to DISABLE no messages will be written to the log file, + /// but FATAL messages will still be output to stderr. Also configurable using + /// the "log-severity" command-line switch with a value of "verbose", "info", + /// "warning", "error", "fatal" or "disable". /// cef_log_severity_t log_severity; /// - // Custom flags that will be used when initializing the V8 JavaScript engine. - // The consequences of using custom flags may not be well tested. Also - // configurable using the "js-flags" command-line switch. + /// Custom flags that will be used when initializing the V8 JavaScript engine. + /// The consequences of using custom flags may not be well tested. Also + /// configurable using the "js-flags" command-line switch. /// cef_string_t javascript_flags; /// - // The fully qualified path for the resources directory. If this value is - // empty the *.pak files must be located in the module directory on - // Windows/Linux or the app bundle Resources directory on MacOS. If this - // value is non-empty then it must be an absolute path. Also configurable - // using the "resources-dir-path" command-line switch. + /// The fully qualified path for the resources directory. If this value is + /// empty the *.pak files must be located in the module directory on + /// Windows/Linux or the app bundle Resources directory on MacOS. If this + /// value is non-empty then it must be an absolute path. Also configurable + /// using the "resources-dir-path" command-line switch. /// cef_string_t resources_dir_path; /// - // The fully qualified path for the locales directory. If this value is empty - // the locales directory must be located in the module directory. If this - // value is non-empty then it must be an absolute path. This value is ignored - // on MacOS where pack files are always loaded from the app bundle Resources - // directory. Also configurable using the "locales-dir-path" command-line - // switch. + /// The fully qualified path for the locales directory. If this value is empty + /// the locales directory must be located in the module directory. If this + /// value is non-empty then it must be an absolute path. This value is ignored + /// on MacOS where pack files are always loaded from the app bundle Resources + /// directory. Also configurable using the "locales-dir-path" command-line + /// switch. /// cef_string_t locales_dir_path; /// - // Set to true (1) to disable loading of pack files for resources and locales. - // A resource bundle handler must be provided for the browser and render - // processes via CefApp::GetResourceBundleHandler() if loading of pack files - // is disabled. Also configurable using the "disable-pack-loading" command- - // line switch. + /// Set to true (1) to disable loading of pack files for resources and + /// locales. A resource bundle handler must be provided for the browser and + /// render processes via CefApp::GetResourceBundleHandler() if loading of pack + /// files is disabled. Also configurable using the "disable-pack-loading" + /// command- line switch. /// int pack_loading_disabled; /// - // Set to a value between 1024 and 65535 to enable remote debugging on the - // specified port. For example, if 8080 is specified the remote debugging URL - // will be http://localhost:8080. CEF can be remotely debugged from any CEF or - // Chrome browser window. Also configurable using the "remote-debugging-port" - // command-line switch. + /// Set to a value between 1024 and 65535 to enable remote debugging on the + /// specified port. Also configurable using the "remote-debugging-port" + /// command-line switch. Remote debugging can be accessed by loading the + /// chrome://inspect page in Google Chrome. Port numbers 9222 and 9229 are + /// discoverable by default. Other port numbers may need to be configured via + /// "Discover network targets" on the Devices tab. /// int remote_debugging_port; /// - // The number of stack trace frames to capture for uncaught exceptions. - // Specify a positive value to enable the CefRenderProcessHandler:: - // OnUncaughtException() callback. Specify 0 (default value) and - // OnUncaughtException() will not be called. Also configurable using the - // "uncaught-exception-stack-size" command-line switch. + /// The number of stack trace frames to capture for uncaught exceptions. + /// Specify a positive value to enable the + /// CefRenderProcessHandler::OnUncaughtException() callback. Specify 0 + /// (default value) and OnUncaughtException() will not be called. Also + /// configurable using the "uncaught-exception-stack-size" command-line + /// switch. /// int uncaught_exception_stack_size; /// - // 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 windowed browser then the - // default value of opaque white be used. If the alpha component is fully - // transparent for a windowless (off-screen) browser then transparent painting - // will be enabled. + /// 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 windowed browser then the + /// default value of opaque white be used. If the alpha component is fully + /// transparent for a windowless (off-screen) browser then transparent + /// painting will be enabled. /// cef_color_t background_color; /// - // Comma delimited ordered list of language codes without any whitespace that - // will be used in the "Accept-Language" HTTP header. May be overridden on a - // per-browser basis using the CefBrowserSettings.accept_language_list value. - // If both values are empty then "en-US,en" will be used. Can be overridden - // for individual CefRequestContext instances via the - // CefRequestContextSettings.accept_language_list value. + /// Comma delimited ordered list of language codes without any whitespace that + /// will be used in the "Accept-Language" HTTP header. May be overridden on a + /// per-browser basis using the CefBrowserSettings.accept_language_list value. + /// If both values are empty then "en-US,en" will be used. Can be overridden + /// for individual CefRequestContext instances via the + /// CefRequestContextSettings.accept_language_list value. /// cef_string_t accept_language_list; /// - // Comma delimited list of schemes supported by the associated - // CefCookieManager. If |cookieable_schemes_exclude_defaults| is false (0) the - // default schemes ("http", "https", "ws" and "wss") will also be supported. - // Specifying a |cookieable_schemes_list| value and setting - // |cookieable_schemes_exclude_defaults| to true (1) will disable all loading - // and saving of cookies for this manager. Can be overridden - // for individual CefRequestContext instances via the - // CefRequestContextSettings.cookieable_schemes_list and - // CefRequestContextSettings.cookieable_schemes_exclude_defaults values. + /// Comma delimited list of schemes supported by the associated + /// CefCookieManager. If |cookieable_schemes_exclude_defaults| is false (0) + /// the default schemes ("http", "https", "ws" and "wss") will also be + /// supported. Specifying a |cookieable_schemes_list| value and setting + /// |cookieable_schemes_exclude_defaults| to true (1) will disable all loading + /// and saving of cookies for this manager. Can be overridden + /// for individual CefRequestContext instances via the + /// CefRequestContextSettings.cookieable_schemes_list and + /// CefRequestContextSettings.cookieable_schemes_exclude_defaults values. /// cef_string_t cookieable_schemes_list; int cookieable_schemes_exclude_defaults; - - /// - // GUID string used for identifying the application. This is passed to the - // system AV function for scanning downloaded files. By default, the GUID - // will be an empty string and the file will be treated as an untrusted - // file when the GUID is empty. - /// - cef_string_t application_client_id_for_file_scanning; } /// -// Request context initialization settings. Specify NULL or 0 to get the -// recommended default values. +/// Request context initialization settings. Specify NULL or 0 to get the +/// recommended default values. /// struct cef_request_context_settings_t { /// - // Size of this structure. + /// Size of this structure. /// size_t size; /// - // 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.root_cache_path. If - // this 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.cache_path 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.root_cache_path. If + /// this 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.cache_path value. /// cef_string_t cache_path; /// - // 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 (1). Session cookies are generally intended to be transient and most - // Web browsers do not persist them. Can be set globally using the - // CefSettings.persist_session_cookies value. This value will be ignored if - // |cache_path| is empty or if it matches the CefSettings.cache_path value. + /// 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 (1). Session cookies are generally intended to be transient and + /// most Web browsers do not persist them. Can be set globally using the + /// CefSettings.persist_session_cookies value. This value will be ignored if + /// |cache_path| is empty or if it matches the CefSettings.cache_path value. /// int persist_session_cookies; /// - // To persist user preferences as a JSON file in the cache path directory set - // this value to true (1). Can be set globally using the - // CefSettings.persist_user_preferences value. This value will be ignored if - // |cache_path| is empty or if it matches the CefSettings.cache_path value. + /// To persist user preferences as a JSON file in the cache path directory set + /// this value to true (1). Can be set globally using the + /// CefSettings.persist_user_preferences value. This value will be ignored if + /// |cache_path| is empty or if it matches the CefSettings.cache_path value. /// int persist_user_preferences; /// - // 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 CefBrowserSettings.accept_language_list value. If - // all values are empty then "en-US,en" will be used. This value will be - // ignored if |cache_path| matches the CefSettings.cache_path 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 CefBrowserSettings.accept_language_list value. If + /// all values are empty then "en-US,en" will be used. This value will be + /// ignored if |cache_path| matches the CefSettings.cache_path value. /// cef_string_t accept_language_list; /// - // Comma delimited list of schemes supported by the associated - // CefCookieManager. If |cookieable_schemes_exclude_defaults| is false (0) the - // default schemes ("http", "https", "ws" and "wss") will also be supported. - // Specifying a |cookieable_schemes_list| value and setting - // |cookieable_schemes_exclude_defaults| to true (1) will disable all loading - // and saving of cookies for this manager. These values will be ignored if - // |cache_path| matches the CefSettings.cache_path value. + /// Comma delimited list of schemes supported by the associated + /// CefCookieManager. If |cookieable_schemes_exclude_defaults| is false (0) + /// the default schemes ("http", "https", "ws" and "wss") will also be + /// supported. Specifying a |cookieable_schemes_list| value and setting + /// |cookieable_schemes_exclude_defaults| to true (1) will disable all loading + /// and saving of cookies for this manager. These values will be ignored if + /// |cache_path| matches the CefSettings.cache_path value. /// cef_string_t cookieable_schemes_list; int cookieable_schemes_exclude_defaults; @@ -2160,31 +2165,31 @@ struct cef_request_context_settings_t /// -// 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. +/// 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. /// struct cef_browser_settings_t { /// - // Size of this structure. + /// Size of this structure. /// size_t size; /// - // 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 CefBrowserHost::SetWindowlessFrameRate. + /// 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 CefBrowserHost::SetWindowlessFrameRate. /// int windowless_frame_rate; - // The below values map to WebPreferences settings. + /// BEGIN values that map to WebPreferences settings. /// - // Font settings. + /// Font settings. /// cef_string_t standard_font_family; cef_string_t fixed_font_family; @@ -2198,197 +2203,200 @@ struct cef_browser_settings_t int minimum_logical_font_size; /// - // Default encoding for Web content. If empty "ISO-8859-1" will be used. Also - // configurable using the "default-encoding" command-line switch. + /// Default encoding for Web content. If empty "ISO-8859-1" will be used. Also + /// configurable using the "default-encoding" command-line switch. /// cef_string_t default_encoding; /// - // Controls the loading of fonts from remote sources. Also configurable using - // the "disable-remote-fonts" command-line switch. + /// Controls the loading of fonts from remote sources. Also configurable using + /// the "disable-remote-fonts" command-line switch. /// cef_state_t remote_fonts; /// - // Controls whether JavaScript can be executed. Also configurable using the - // "disable-javascript" command-line switch. + /// Controls whether JavaScript can be executed. Also configurable using the + /// "disable-javascript" command-line switch. /// cef_state_t javascript; /// - // 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 or that have no back/forward history. Also - // configurable using the "disable-javascript-close-windows" 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 or that have no back/forward history. Also + /// configurable using the "disable-javascript-close-windows" command-line + /// switch. /// cef_state_t javascript_close_windows; /// - // Controls whether JavaScript can access the clipboard. Also configurable - // using the "disable-javascript-access-clipboard" command-line switch. + /// Controls whether JavaScript can access the clipboard. Also configurable + /// using the "disable-javascript-access-clipboard" command-line switch. /// cef_state_t javascript_access_clipboard; /// - // 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 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. /// cef_state_t javascript_dom_paste; /// - // Controls whether any plugins will be loaded. Also configurable using the - // "disable-plugins" command-line switch. - /// - cef_state_t plugins; - - /// - // 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 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. /// cef_state_t image_loading; /// - // 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 standalone images will be shrunk to fit the page. Also + /// configurable using the "image-shrink-standalone-to-fit" command-line + /// switch. /// cef_state_t image_shrink_standalone_to_fit; /// - // Controls whether text areas can be resized. Also configurable using the - // "disable-text-area-resize" command-line switch. + /// Controls whether text areas can be resized. Also configurable using the + /// "disable-text-area-resize" command-line switch. /// cef_state_t text_area_resize; /// - // Controls whether the tab key can advance focus to links. Also configurable - // using the "disable-tab-to-links" command-line switch. + /// Controls whether the tab key can advance focus to links. Also configurable + /// using the "disable-tab-to-links" command-line switch. /// cef_state_t tab_to_links; /// - // Controls whether local storage can be used. Also configurable using the - // "disable-local-storage" command-line switch. + /// Controls whether local storage can be used. Also configurable using the + /// "disable-local-storage" command-line switch. /// cef_state_t local_storage; /// - // Controls whether databases can be used. Also configurable using the - // "disable-databases" command-line switch. + /// Controls whether databases can be used. Also configurable using the + /// "disable-databases" command-line switch. /// cef_state_t databases; /// - // 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. + /// 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. /// cef_state_t webgl; + /// END values that map to WebPreferences settings. + /// - // 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 windowed browser then the - // CefSettings.background_color value will be used. If the alpha component is - // fully transparent for a windowless (off-screen) browser then transparent - // painting will be enabled. + /// 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 windowed browser then the + /// CefSettings.background_color value will be used. If the alpha component is + /// fully transparent for a windowless (off-screen) browser then transparent + /// painting will be enabled. /// cef_color_t background_color; /// - // Comma delimited ordered list of language codes without any whitespace that - // will be used in the "Accept-Language" HTTP header. May be set globally - // using the CefSettings.accept_language_list value. If both values are - // empty then "en-US,en" will be used. + /// Comma delimited ordered list of language codes without any whitespace that + /// will be used in the "Accept-Language" HTTP header. May be set globally + /// using the CefSettings.accept_language_list value. If both values are + /// empty then "en-US,en" will be used. /// cef_string_t accept_language_list; + + /// + /// Controls whether the Chrome status bubble will be used. Only supported + /// with the Chrome runtime. For details about the status bubble see + /// https://www.chromium.org/user-experience/status-bubble/ + /// + cef_state_t chrome_status_bubble; } /// -// Return value types. +/// Return value types. /// enum cef_return_value_t { /// - // Cancel immediately. + /// Cancel immediately. /// RV_CANCEL = 0, /// - // Continue immediately. + /// Continue immediately. /// RV_CONTINUE = 1, /// - // Continue asynchronously (usually via a callback). + /// Continue asynchronously (usually via a callback). /// RV_CONTINUE_ASYNC = 2 } /// -// URL component parts. +/// URL component parts. /// struct cef_urlparts_t { /// - // The complete URL specification. + /// The complete URL specification. /// cef_string_t spec; /// - // Scheme component not including the colon (e.g., "http"). + /// Scheme component not including the colon (e.g., "http"). /// cef_string_t scheme; /// - // User name component. + /// User name component. /// cef_string_t username; /// - // Password component. + /// Password component. /// cef_string_t password; /// - // Host component. This may be a hostname, an IPv4 address or an IPv6 literal - // surrounded by square brackets (e.g., "[2001:db8::1]"). + /// Host component. This may be a hostname, an IPv4 address or an IPv6 literal + /// surrounded by square brackets (e.g., "[2001:db8::1]"). /// cef_string_t host; /// - // Port number component. + /// Port number component. /// cef_string_t port; /// - // Origin contains just the scheme, host, and port from a URL. Equivalent to - // clearing any username and password, replacing the path with a slash, and - // clearing everything after that. This value will be empty for non-standard - // URLs. + /// Origin contains just the scheme, host, and port from a URL. Equivalent to + /// clearing any username and password, replacing the path with a slash, and + /// clearing everything after that. This value will be empty for non-standard + /// URLs. /// cef_string_t origin; /// - // Path component including the first slash following the host. + /// Path component including the first slash following the host. /// cef_string_t path; /// - // Query string component (i.e., everything following the '?'). + /// Query string component (i.e., everything following the '?'). /// cef_string_t query; /// - // Fragment (hash) identifier component (i.e., the string following the '#'). + /// Fragment (hash) identifier component (i.e., the string following the '#'). /// cef_string_t fragment; } @@ -2396,7 +2404,7 @@ struct cef_urlparts_t /// -// Cookie priority values. +/// Cookie priority values. /// enum cef_cookie_priority_t { @@ -2406,7 +2414,7 @@ enum cef_cookie_priority_t } /// -// Cookie same site values. +/// Cookie same site values. /// enum cef_cookie_same_site_t { @@ -2417,68 +2425,68 @@ enum cef_cookie_same_site_t } /// -// Cookie information. +/// Cookie information. /// struct cef_cookie_t { /// - // The cookie name. + /// The cookie name. /// cef_string_t name; /// - // The cookie value. + /// The cookie value. /// cef_string_t value; /// - // If |domain| is empty a host cookie will be created instead of a domain - // cookie. Domain cookies are stored with a leading "." and are visible to - // sub-domains whereas host cookies are not. + /// If |domain| is empty a host cookie will be created instead of a domain + /// cookie. Domain cookies are stored with a leading "." and are visible to + /// sub-domains whereas host cookies are not. /// cef_string_t domain; /// - // If |path| is non-empty only URLs at or below the path will get the cookie - // value. + /// If |path| is non-empty only URLs at or below the path will get the cookie + /// value. /// cef_string_t path; /// - // If |secure| is true the cookie will only be sent for HTTPS requests. + /// If |secure| is true the cookie will only be sent for HTTPS requests. /// int secure; /// - // If |httponly| is true the cookie will only be sent for HTTP requests. + /// If |httponly| is true the cookie will only be sent for HTTP requests. /// int httponly; /// - // The cookie creation date. This is automatically populated by the system on - // cookie creation. + /// The cookie creation date. This is automatically populated by the system on + /// cookie creation. /// - cef_time_t creation; + cef_basetime_t creation; /// - // The cookie last access date. This is automatically populated by the system - // on access. + /// The cookie last access date. This is automatically populated by the system + /// on access. /// - cef_time_t last_access; + cef_basetime_t last_access; /// - // The cookie expiration date is only valid if |has_expires| is true. + /// The cookie expiration date is only valid if |has_expires| is true. /// int has_expires; - cef_time_t expires; + cef_basetime_t expires; /// - // Same site. + /// Same site. /// cef_cookie_same_site_t same_site; /// - // Priority. + /// Priority. /// cef_cookie_priority_t priority; } @@ -2486,88 +2494,88 @@ struct cef_cookie_t /// -// Process termination status values. +/// Process termination status values. /// enum cef_termination_status_t { /// - // Non-zero exit status. + /// Non-zero exit status. /// TS_ABNORMAL_TERMINATION = 0, /// - // SIGKILL or task manager kill. + /// SIGKILL or task manager kill. /// TS_PROCESS_WAS_KILLED = 1, /// - // Segmentation fault. + /// Segmentation fault. /// TS_PROCESS_CRASHED = 2, /// - // Out of memory. Some platforms may use TS_PROCESS_CRASHED instead. + /// Out of memory. Some platforms may use TS_PROCESS_CRASHED instead. /// TS_PROCESS_OOM = 3 } /// -// Path key values. +/// Path key values. /// enum cef_path_key_t { /// - // Current directory. + /// Current directory. /// PK_DIR_CURRENT = 0, /// - // Directory containing PK_FILE_EXE. + /// Directory containing PK_FILE_EXE. /// PK_DIR_EXE = 1, /// - // Directory containing PK_FILE_MODULE. + /// Directory containing PK_FILE_MODULE. /// PK_DIR_MODULE = 2, /// - // Temporary directory. + /// Temporary directory. /// PK_DIR_TEMP = 3, /// - // Path and filename of the current executable. + /// Path and filename of the current executable. /// PK_FILE_EXE = 4, /// - // Path and filename of the module containing the CEF code (usually the libcef - // module). + /// Path and filename of the module containing the CEF code (usually the + /// libcef module). /// PK_FILE_MODULE = 5, /// - // "Local Settings\Application Data" directory under the user profile - // directory on Windows. + /// "Local Settings\Application Data" directory under the user profile + /// directory on Windows. /// PK_LOCAL_APP_DATA = 6, /// - // "Application Data" directory under the user profile directory on Windows - // and "~/Library/Application Support" directory on MacOS. + /// "Application Data" directory under the user profile directory on Windows + /// and "~/Library/Application Support" directory on MacOS. /// PK_USER_DATA = 7, /// - // Directory containing application resources. Can be configured via - // CefSettings.resources_dir_path. + /// Directory containing application resources. Can be configured via + /// CefSettings.resources_dir_path. /// PK_DIR_RESOURCES = 8 } /// -// Storage types. +/// Storage types. /// enum cef_storage_type_t { @@ -2576,7 +2584,8 @@ enum cef_storage_type_t } /// -// Supported error code values. +/// Supported error code values. For the complete list of error values see +/// "include/base/internal/cef_net_error_list.h". /// enum cef_errorcode_t { @@ -2628,7 +2637,6 @@ enum cef_errorcode_t ERR_SSL_VERSION_OR_CIPHER_MISMATCH = -113, ERR_SSL_RENEGOTIATION_REQUESTED = -114, ERR_PROXY_AUTH_UNSUPPORTED = -115, - ERR_CERT_ERROR_IN_SSL_RENEGOTIATION = -116, ERR_BAD_SSL_CLIENT_AUTH_CERT = -117, ERR_CONNECTION_TIMED_OUT = -118, ERR_HOST_RESOLVER_QUEUE_TOO_LARGE = -119, @@ -2682,6 +2690,9 @@ enum cef_errorcode_t ERR_WRONG_VERSION_ON_EARLY_DATA = -179, ERR_TLS13_DOWNGRADE_DETECTED = -180, ERR_SSL_KEY_USAGE_INCOMPATIBLE = -181, + ERR_INVALID_ECH_CONFIG_LIST = -182, + ERR_ECH_NOT_NEGOTIATED = -183, + ERR_ECH_FALLBACK_CERTIFICATE_INVALID = -184, ERR_CERT_COMMON_NAME_INVALID = -200, ERR_CERT_DATE_INVALID = -201, ERR_CERT_AUTHORITY_INVALID = -202, @@ -2698,7 +2709,6 @@ enum cef_errorcode_t ERR_CERTIFICATE_TRANSPARENCY_REQUIRED = -214, ERR_CERT_SYMANTEC_LEGACY = -215, ERR_CERT_KNOWN_INTERCEPTION_BLOCKED = -217, - ERR_SSL_OBSOLETE_VERSION = -218, ERR_CERT_END = -219, ERR_INVALID_URL = -300, ERR_DISALLOWED_URL_SCHEME = -301, @@ -2763,234 +2773,286 @@ enum cef_errorcode_t ERR_HTTP_RESPONSE_CODE_FAILURE = -379, ERR_QUIC_CERT_ROOT_NOT_KNOWN = -380, ERR_QUIC_GOAWAY_REQUEST_CAN_BE_RETRIED = -381, + ERR_TOO_MANY_ACCEPT_CH_RESTARTS = -382, + ERR_INCONSISTENT_IP_ADDRESS_SPACE = -383, + ERR_CACHED_IP_ADDRESS_SPACE_BLOCKED_BY_PRIVATE_NETWORK_ACCESS_POLICY = -384, ERR_CACHE_MISS = -400, ERR_CACHE_READ_FAILURE = -401, ERR_CACHE_WRITE_FAILURE = -402, - ERR_CACHE_OPERATION_NOT_SUPPORTED = -403, - ERR_CACHE_OPEN_FAILURE = -404, - ERR_CACHE_CREATE_FAILURE = -405, /// - // Supported certificate status code values. See net\cert\cert_status_flags.h - ERR_CACHE_RACE = -406, - // for more information. CERT_STATUS_NONE is new in CEF because we use an - // enum while cert_status_flags.h uses a typedef and static const variables. + /// Supported certificate status code values. See net\cert\cert_status_flags.h + ERR_CACHE_OPERATION_NOT_SUPPORTED = -403, + /// for more information. CERT_STATUS_NONE is new in CEF because we use an + ERR_CACHE_OPEN_FAILURE = -404, + /// enum while cert_status_flags.h uses a typedef and static const variables. + ERR_CACHE_CREATE_FAILURE = -405, /// - ERR_CACHE_CHECKSUM_READ_FAILURE = -407, // 1 << 3 is reserved for ERR_CERT_CONTAINS_ERRORS (not useful with WinHTTP). - ERR_CACHE_CHECKSUM_MISMATCH = -408, + ERR_CACHE_RACE = -406, // 1 << 9 was used for CERT_STATUS_NOT_IN_DNS - ERR_CACHE_LOCK_TIMEOUT = -409, + ERR_CACHE_CHECKSUM_READ_FAILURE = -407, // 1 << 12 was used for CERT_STATUS_WEAK_DH_KEY - ERR_CACHE_AUTH_FAILURE_AFTER_READ = -410, // Bits 16 to 31 are for non-error statuses. + ERR_CACHE_CHECKSUM_MISMATCH = -408, // Bit 18 was CERT_STATUS_IS_DNSSEC + ERR_CACHE_LOCK_TIMEOUT = -409, + + /// + /// The manner in which a link click should be opened. These constants match + ERR_CACHE_AUTH_FAILURE_AFTER_READ = -410, + /// their equivalents in Chromium's window_open_disposition.h and should not be + /// renumbered. + /// + + /// + /// Current tab. This is the default in most cases. + /// + + /// + /// Indicates that only one tab with the url should exist in the same window. ERR_CACHE_ENTRY_NOT_SUITABLE = -411, + /// ERR_CACHE_DOOM_FAILURE = -412, /// - // The manner in which a link click should be opened. These constants match - // their equivalents in Chromium's window_open_disposition.h and should not be + /// Shift key + Middle mouse button or meta/ctrl key while clicking. + /// ERR_CACHE_OPEN_OR_CREATE_FAILURE = -413, - // renumbered. + + /// + /// Middle mouse button or meta/ctrl key while clicking. /// ERR_INSECURE_RESPONSE = -501, + + /// + /// New popup window. + /// + + /// + /// Shift key while clicking. + /// + + /// + /// Alt key while clicking. ERR_NO_PRIVATE_KEY_FOR_CERT = -502, + /// /// - // "Verb" of a drag-and-drop operation as negotiated between the source and + /// New off-the-record (incognito) window. + /// ERR_ADD_USER_CERT_FAILED = -503, - // destination. These constants match their equivalents in WebCore's + + /// + /// Special case error condition from the renderer. + /// + + /// ERR_INVALID_SIGNED_EXCHANGE = -504, - // DragActions.h and should not be renumbered. - /// + /// Activates an existing tab containing the url, rather than navigating. + /// This is similar to SINGLETON_TAB, but searches across all windows from ERR_INVALID_WEB_BUNDLE = -505, + /// the current profile and anonymity (instead of just the current one); + /// closes the current tab on switching if the current tab was the NTP with ERR_TRUST_TOKEN_OPERATION_FAILED = -506, + /// no session history; and behaves like CURRENT_TAB instead of + /// NEW_FOREGROUND_TAB when no existing tab is found. + /// /// - // Input mode of a virtual keyboard. These constants match their equivalents - // in Chromium's text_input_mode.h and should not be renumbered. - // See https://html.spec.whatwg.org/#input-modalities:-the-inputmode-attribute + /// Creates a new document picture-in-picture window showing a child WebView. /// + + /// + /// "Verb" of a drag-and-drop operation as negotiated between the source and + /// destination. These constants match their equivalents in WebCore's ERR_TRUST_TOKEN_OPERATION_SUCCESS_WITHOUT_SENDING_REQUEST = -507, - + /// DragActions.h and should not be renumbered. /// - // V8 access control values. ERR_FTP_FAILED = -601, + /// + /// Input mode of a virtual keyboard. These constants match their equivalents ERR_FTP_SERVICE_UNAVAILABLE = -602, - - /// - // V8 property attribute values. + /// in Chromium's text_input_mode.h and should not be renumbered. ERR_FTP_TRANSFER_ABORTED = -603, + /// See https://html.spec.whatwg.org/#input-modalities:-the-inputmode-attribute /// - - // Writeable, Enumerable, - // Configurable ERR_FTP_FILE_BUSY = -604, - // Not writeable - // Not enumerable ERR_FTP_SYNTAX_ERROR = -605, - // Not configurable - - /// - // Post data elements may represent either bytes or files. ERR_FTP_COMMAND_NOT_SUPPORTED = -606, - /// + /// + /// V8 access control values. /// ERR_FTP_BAD_COMMAND_SEQUENCE = -607, - // Resource type for a request. - /// - - /// - // Top level page. - /// ERR_PKCS12_IMPORT_BAD_PASSWORD = -701, /// - // Frame or iframe. - /// - - /// - // CSS stylesheet. + /// V8 property attribute values. ERR_PKCS12_IMPORT_FAILED = -702, /// /// - // External script. - /// - - /// + /// Writeable, Enumerable, Configurable ERR_IMPORT_CA_CERT_NOT_CA = -703, - // Image (jpg/gif/png/etc). /// /// - // Font. + /// Not writeable /// /// - // Some other subresource. This is the default type if the actual type is - // unknown. + /// Not enumerable /// /// + /// Not configurable ERR_IMPORT_CERT_ALREADY_EXISTS = -704, - // Object (or embed) tag for a plugin, or a resource that a plugin requested. + /// + /// ERR_IMPORT_CA_CERT_FAILED = -705, - + /// Post data elements may represent either bytes or files. /// - // Media resource. - /// - - /// - // Main resource of a dedicated worker. ERR_IMPORT_SERVER_CERT_FAILED = -706, - /// /// - // Main resource of a shared worker. - /// + /// Resource type for a request. These constants match their equivalents in ERR_PKCS12_IMPORT_INVALID_MAC = -707, - - /// - // Explicitly requested prefetch. - /// - - /// - // Favicon. - /// + /// Chromium's ResourceType and should not be renumbered. ERR_PKCS12_IMPORT_INVALID_FILE = -708, - - /// - // XMLHttpRequest. /// /// - // A request for a + /// Top level page. /// + + /// + /// Frame or iframe. ERR_PKCS12_IMPORT_UNSUPPORTED = -709, + /// /// - // Main resource of a service worker. - /// + /// CSS stylesheet. ERR_KEY_GENERATION_FAILED = -710, - - /// - // A report of Content Security Policy violations. /// /// - // A resource that a plugin requested. + /// External script. + /// + + /// + /// Image (jpg/gif/png/etc). + /// + + /// + /// Font. ERR_PRIVATE_KEY_EXPORT_FAILED = -712, /// /// - // A main-frame service worker navigation preload request. + /// Some other subresource. This is the default type if the actual type is ERR_SELF_SIGNED_CERT_GENERATION_FAILED = -713, + /// unknown. /// /// - // A sub-frame service worker navigation preload request. + /// Object (or embed) tag for a plugin, or a resource that a plugin requested. ERR_CERT_DATABASE_CHANGED = -714, /// /// - // Transition type for a request. Made up of one source value and 0 or more - // qualifiers. + /// Media resource. + /// + + /// + /// Main resource of a dedicated worker. ERR_DNS_MALFORMED_RESPONSE = -800, /// /// - // Source is a link click or the JavaScript window.open function. This is + /// Main resource of a shared worker. ERR_DNS_SERVER_REQUIRES_TCP = -801, - // also the default value for requests like sub-resource loads that are not - // navigations. /// /// - // Source is some other "explicit" navigation. This is the default value for - // navigations where the actual type is unknown. See also TT_DIRECT_LOAD_FLAG. + /// Explicitly requested prefetch. /// /// - // Source is a subframe navigation. This is any content that is automatically - // loaded in a non-toplevel frame. For example, if a page consists of several + /// Favicon. + /// + + /// + /// XMLHttpRequest. + /// + + /// + /// A request for a "". + /// + + /// + /// Main resource of a service worker. + /// + + /// + /// A report of Content Security Policy violations. + /// + + /// + /// A resource that a plugin requested. + /// + + /// + /// A main-frame service worker navigation preload request. ERR_DNS_SERVER_FAILED = -802, - // frames containing ads, those ad URLs will have this transition type. + /// ERR_DNS_TIMED_OUT = -803, - // The user may not even realize the content in these pages is a separate - // frame, so may not care about the URL. + + /// + /// A sub-frame service worker navigation preload request. /// /// - // Source is a subframe navigation explicitly requested by the user that will - // generate new navigation entries in the back/forward list. These are + /// Transition type for a request. Made up of one source value and 0 or more + /// qualifiers. + /// + + /// + /// Source is a link click or the JavaScript window.open function. This is ERR_DNS_CACHE_MISS = -804, - // probably more important than frames that were automatically loaded in + /// also the default value for requests like sub-resource loads that are not ERR_DNS_SEARCH_EMPTY = -805, - // the background because the user probably cares about the fact that this + /// navigations. + /// + + /// + /// Source is some other "explicit" navigation. This is the default value for ERR_DNS_SORT_ERROR = -806, - // link was loaded. - /// - - /// - // Source is a form submission by the user. NOTE: In some situations - // submitting a form does not result in this transition type. This can happen + /// navigations where the actual type is unknown. See also ERR_DNS_SECURE_RESOLVER_HOSTNAME_RESOLUTION_FAILED = -808, - // if the form uses a script to submit the contents. + /// TT_DIRECT_LOAD_FLAG. /// /// - // Source is a "reload" of the page via the Reload function or by re-visiting - ERR_DNS_NAME_HTTPS_ONLY = -809 + /// User got to this page through a suggestion in the UI (for example, via the + /// destinations page). Chrome runtime only. + /// + + /// + /// Source is a subframe navigation. This is any content that is automatically + ERR_DNS_NAME_HTTPS_ONLY = -809, + /// loaded in a non-toplevel frame. For example, if a page consists of several + ERR_DNS_REQUEST_CANCELLED = -810, + /// frames containing ads, those ad URLs will have this transition type. + /// The user may not even realize the content in these pages is a separate + ERR_DNS_NO_MACHING_SUPPORTED_ALPN = -811 } enum cef_cert_status_t @@ -3026,7 +3088,9 @@ enum cef_window_open_disposition_t WOD_NEW_WINDOW = 6, WOD_SAVE_TO_DISK = 7, WOD_OFF_THE_RECORD = 8, - WOD_IGNORE_ACTION = 9 + WOD_IGNORE_ACTION = 9, + WOD_SWITCH_TO_TAB = 10, + WOD_NEW_PICTURE_IN_PICTURE = 11 } enum cef_drag_operations_mask_t @@ -3106,178 +3170,248 @@ enum cef_transition_type_t { TT_LINK = 0, TT_EXPLICIT = 1, + TT_AUTO_BOOKMARK = 2, + /// frame, so may not care about the URL. + /// TT_AUTO_SUBFRAME = 3, + + /// + /// Source is a subframe navigation explicitly requested by the user that will + /// generate new navigation entries in the back/forward list. These are + /// probably more important than frames that were automatically loaded in + /// the background because the user probably cares about the fact that this + /// link was loaded. + /// TT_MANUAL_SUBFRAME = 4, + + /// + /// User got to this page by typing in the URL bar and selecting an entry + /// that did not look like a URL. For example, a match might have the URL + /// of a Google search result page, but appear like "Search Google for ...". + /// These are not quite the same as EXPLICIT navigations because the user + /// didn't type or see the destination URL. Chrome runtime only. + /// See also TT_KEYWORD. + /// + TT_GENERATED = 5, + + /// + /// This is a toplevel navigation. This is any content that is automatically + /// loaded in a toplevel frame. For example, opening a tab to show the ASH + /// screen saver, opening the devtools window, opening the NTP after the safe + /// browsing warning, opening web-based dialog boxes are examples of + /// AUTO_TOPLEVEL navigations. Chrome runtime only. + /// + TT_AUTO_TOPLEVEL = 6, + + /// + /// Source is a form submission by the user. NOTE: In some situations + /// submitting a form does not result in this transition type. This can happen + /// if the form uses a script to submit the contents. + /// TT_FORM_SUBMIT = 7, - // the same URL. NOTE: This is distinct from the concept of whether a - // particular load uses "reload semantics" (i.e. bypasses cached data). + + /// + /// Source is a "reload" of the page via the Reload function or by re-visiting + /// the same URL. NOTE: This is distinct from the concept of whether a + /// particular load uses "reload semantics" (i.e. bypasses cached data). /// TT_RELOAD = 8, /// - // General mask defining the bits used for the source values. + /// The url was generated from a replaceable keyword other than the default + /// search provider. If the user types a keyword (which also applies to + /// tab-to-search) in the omnibox this qualifier is applied to the transition + /// type of the generated url. TemplateURLModel then may generate an + /// additional visit with a transition type of TT_KEYWORD_GENERATED against + /// the url 'http://' + keyword. For example, if you do a tab-to-search + /// against wikipedia the generated url has a transition qualifer of + /// TT_KEYWORD, and TemplateURLModel generates a visit for 'wikipedia.org' + /// with a transition type of TT_KEYWORD_GENERATED. Chrome runtime only. + /// + TT_KEYWORD = 9, + + /// + /// Corresponds to a visit generated for a keyword. See description of + /// TT_KEYWORD for more details. Chrome runtime only. + /// + TT_KEYWORD_GENERATED = 10, + + /// + /// General mask defining the bits used for the source values. /// TT_SOURCE_MASK = 0xFF, - // Qualifiers. - // Any of the core values above can be augmented by one or more qualifiers. - // These qualifiers further define the transition. + /// Qualifiers. + /// Any of the core values above can be augmented by one or more qualifiers. + /// These qualifiers further define the transition. /// - // Attempted to visit a URL but was blocked. + /// Attempted to visit a URL but was blocked. /// TT_BLOCKED_FLAG = 0x00800000, /// - // Used the Forward or Back function to navigate among browsing history. - // Will be ORed to the transition type for the original load. + /// Used the Forward or Back function to navigate among browsing history. + /// Will be ORed to the transition type for the original load. /// TT_FORWARD_BACK_FLAG = 0x01000000, /// - // Loaded a URL directly via CreateBrowser, LoadURL or LoadRequest. + /// Loaded a URL directly via CreateBrowser, LoadURL or LoadRequest. /// TT_DIRECT_LOAD_FLAG = 0x02000000, /// - // The beginning of a navigation chain. + /// User is navigating to the home page. Chrome runtime only. + /// + TT_HOME_PAGE_FLAG = 0x04000000, + + /// + /// The transition originated from an external application; the exact + /// definition of this is embedder dependent. Chrome runtime and + /// extension system only. + /// + TT_FROM_API_FLAG = 0x08000000, + + /// + /// The beginning of a navigation chain. /// TT_CHAIN_START_FLAG = 0x10000000, /// - // The last transition in a redirect chain. + /// The last transition in a redirect chain. /// TT_CHAIN_END_FLAG = 0x20000000, /// - // Redirects caused by JavaScript or a meta refresh tag on the page. + /// Redirects caused by JavaScript or a meta refresh tag on the page. /// TT_CLIENT_REDIRECT_FLAG = 0x40000000, /// - // Redirects sent from the server by HTTP headers. + /// Redirects sent from the server by HTTP headers. /// TT_SERVER_REDIRECT_FLAG = 0x80000000, /// - // Used to test whether a transition involves a redirect. + /// Used to test whether a transition involves a redirect. /// TT_IS_REDIRECT_MASK = 0xC0000000, /// - // General mask defining the bits used for the qualifiers. + /// General mask defining the bits used for the qualifiers. /// TT_QUALIFIER_MASK = 0xFFFFFF00 } /// -// Flags used to customize the behavior of CefURLRequest. +/// Flags used to customize the behavior of CefURLRequest. /// enum cef_urlrequest_flags_t { /// - // Default behavior. + /// Default behavior. /// UR_FLAG_NONE = 0, /// - // If set the cache will be skipped when handling the request. Setting this - // value is equivalent to specifying the "Cache-Control: no-cache" request - // header. Setting this value in combination with UR_FLAG_ONLY_FROM_CACHE will - // cause the request to fail. + /// If set the cache will be skipped when handling the request. Setting this + /// value is equivalent to specifying the "Cache-Control: no-cache" request + /// header. Setting this value in combination with UR_FLAG_ONLY_FROM_CACHE + /// will cause the request to fail. /// UR_FLAG_SKIP_CACHE = 1 << 0, /// - // If set the request will fail if it cannot be served from the cache (or some - // equivalent local store). Setting this value is equivalent to specifying the - // "Cache-Control: only-if-cached" request header. Setting this value in - // combination with UR_FLAG_SKIP_CACHE or UR_FLAG_DISABLE_CACHE will cause the - // request to fail. + /// If set the request will fail if it cannot be served from the cache (or + /// some equivalent local store). Setting this value is equivalent to + /// specifying the "Cache-Control: only-if-cached" request header. Setting + /// this value in combination with UR_FLAG_SKIP_CACHE or UR_FLAG_DISABLE_CACHE + /// will cause the request to fail. /// UR_FLAG_ONLY_FROM_CACHE = 1 << 1, /// - // If set the cache will not be used at all. Setting this value is equivalent - // to specifying the "Cache-Control: no-store" request header. Setting this - // value in combination with UR_FLAG_ONLY_FROM_CACHE will cause the request to - // fail. + /// If set the cache will not be used at all. Setting this value is equivalent + /// to specifying the "Cache-Control: no-store" request header. Setting this + /// value in combination with UR_FLAG_ONLY_FROM_CACHE will cause the request + /// to fail. /// UR_FLAG_DISABLE_CACHE = 1 << 2, /// - // If set user name, password, and cookies may be sent with the request, and - // cookies may be saved from the response. + /// If set user name, password, and cookies may be sent with the request, and + /// cookies may be saved from the response. /// UR_FLAG_ALLOW_STORED_CREDENTIALS = 1 << 3, /// - // If set upload progress events will be generated when a request has a body. + /// If set upload progress events will be generated when a request has a body. /// UR_FLAG_REPORT_UPLOAD_PROGRESS = 1 << 4, /// - // If set the CefURLRequestClient::OnDownloadData method will not be called. + /// If set the CefURLRequestClient::OnDownloadData method will not be called. /// UR_FLAG_NO_DOWNLOAD_DATA = 1 << 5, /// - // If set 5XX redirect errors will be propagated to the observer instead of - // automatically re-tried. This currently only applies for requests - // originated in the browser process. + /// If set 5XX redirect errors will be propagated to the observer instead of + /// automatically re-tried. This currently only applies for requests + /// originated in the browser process. /// UR_FLAG_NO_RETRY_ON_5XX = 1 << 6, /// - // If set 3XX responses will cause the fetch to halt immediately rather than - // continue through the redirect. + /// If set 3XX responses will cause the fetch to halt immediately rather than + /// continue through the redirect. /// UR_FLAG_STOP_ON_REDIRECT = 1 << 7 } /// -// Flags that represent CefURLRequest status. +/// Flags that represent CefURLRequest status. /// enum cef_urlrequest_status_t { /// - // Unknown status. + /// Unknown status. /// UR_UNKNOWN = 0, /// - // Request succeeded. + /// Request succeeded. /// UR_SUCCESS = 1, /// - // An IO request is pending, and the caller will be informed when it is - // completed. + /// An IO request is pending, and the caller will be informed when it is + /// completed. /// UR_IO_PENDING = 2, /// - // Request was canceled programatically. + /// Request was canceled programatically. /// UR_CANCELED = 3, /// - // Request failed for some reason. + /// Request failed for some reason. /// UR_FAILED = 4 } -// Structure representing a draggable region. +/// Structure representing a draggable region. /// struct cef_draggable_region_t { /// - // Bounds of the region. + /// Bounds of the region. /// cef_rect_t bounds; /// - // True (1) this this region is draggable and false (0) otherwise. + /// True (1) this this region is draggable and false (0) otherwise. /// int draggable; } @@ -3285,164 +3419,164 @@ struct cef_draggable_region_t /// -// Existing process IDs. +/// Existing process IDs. /// enum cef_process_id_t { /// - // Browser process. + /// Browser process. /// PID_BROWSER = 0, /// - // Renderer process. + /// Renderer process. /// PID_RENDERER = 1 } /// -// Existing thread IDs. +/// Existing thread IDs. /// enum cef_thread_id_t { // BROWSER PROCESS THREADS -- Only available in the browser process. /// - // The main thread in the browser. This will be the same as the main - // application thread if CefInitialize() is called with a - // CefSettings.multi_threaded_message_loop value of false. Do not perform - // blocking tasks on this thread. All tasks posted after - // CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() - // are guaranteed to run. This thread will outlive all other CEF threads. + /// The main thread in the browser. This will be the same as the main + /// application thread if CefInitialize() is called with a + /// CefSettings.multi_threaded_message_loop value of false. Do not perform + /// blocking tasks on this thread. All tasks posted after + /// CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() + /// are guaranteed to run. This thread will outlive all other CEF threads. /// TID_UI = 0, /// - // Used for blocking tasks (e.g. file system access) where the user won't - // notice if the task takes an arbitrarily long time to complete. All tasks - // posted after CefBrowserProcessHandler::OnContextInitialized() and before - // CefShutdown() are guaranteed to run. + /// Used for blocking tasks like file system access where the user won't + /// notice if the task takes an arbitrarily long time to complete. All tasks + /// posted after CefBrowserProcessHandler::OnContextInitialized() and before + /// CefShutdown() are guaranteed to run. /// TID_FILE_BACKGROUND = 1, /// - // Used for blocking tasks (e.g. file system access) that affect UI or - // responsiveness of future user interactions. Do not use if an immediate - // response to a user interaction is expected. All tasks posted after - // CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() - // are guaranteed to run. - // Examples: - // - Updating the UI to reflect progress on a long task. - // - Loading data that might be shown in the UI after a future user - // interaction. + /// Used for blocking tasks like file system access that affect UI or + /// responsiveness of future user interactions. Do not use if an immediate + /// response to a user interaction is expected. All tasks posted after + /// CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() + /// are guaranteed to run. + /// Examples: + /// - Updating the UI to reflect progress on a long task. + /// - Loading data that might be shown in the UI after a future user + /// interaction. /// TID_FILE_USER_VISIBLE = 2, /// - // Used for blocking tasks (e.g. file system access) that affect UI - // immediately after a user interaction. All tasks posted after - // CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() - // are guaranteed to run. - // Example: Generating data shown in the UI immediately after a click. + /// Used for blocking tasks like file system access that affect UI + /// immediately after a user interaction. All tasks posted after + /// CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() + /// are guaranteed to run. + /// Example: Generating data shown in the UI immediately after a click. /// TID_FILE_USER_BLOCKING = 3, /// - // Used to launch and terminate browser processes. + /// Used to launch and terminate browser processes. /// TID_PROCESS_LAUNCHER = 4, /// - // Used to process IPC and network messages. Do not perform blocking tasks on - // this thread. All tasks posted after - // CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() - // are guaranteed to run. + /// Used to process IPC and network messages. Do not perform blocking tasks on + /// this thread. All tasks posted after + /// CefBrowserProcessHandler::OnContextInitialized() and before CefShutdown() + /// are guaranteed to run. /// TID_IO = 5, // RENDER PROCESS THREADS -- Only available in the render process. /// - // The main thread in the renderer. Used for all WebKit and V8 interaction. - // Tasks may be posted to this thread after - // CefRenderProcessHandler::OnWebKitInitialized but are not guaranteed to - // run before sub-process termination (sub-processes may be killed at any time - // without warning). + /// The main thread in the renderer. Used for all WebKit and V8 interaction. + /// Tasks may be posted to this thread after + /// CefRenderProcessHandler::OnWebKitInitialized but are not guaranteed to + /// run before sub-process termination (sub-processes may be killed at any + /// time without warning). /// TID_RENDERER = 6 } /// -// Thread priority values listed in increasing order of importance. +/// Thread priority values listed in increasing order of importance. /// enum cef_thread_priority_t { /// - // Suitable for threads that shouldn't disrupt high priority work. + /// Suitable for threads that shouldn't disrupt high priority work. /// TP_BACKGROUND = 0, /// - // Default priority level. + /// Default priority level. /// TP_NORMAL = 1, /// - // Suitable for threads which generate data for the display (at ~60Hz). + /// Suitable for threads which generate data for the display (at ~60Hz). /// TP_DISPLAY = 2, /// - // Suitable for low-latency, glitch-resistant audio. + /// Suitable for low-latency, glitch-resistant audio. /// TP_REALTIME_AUDIO = 3 } /// -// Message loop types. Indicates the set of asynchronous events that a message -// loop can process. +/// Message loop types. Indicates the set of asynchronous events that a message +/// loop can process. /// enum cef_message_loop_type_t { /// - // Supports tasks and timers. + /// Supports tasks and timers. /// ML_TYPE_DEFAULT = 0, /// - // Supports tasks, timers and native UI events (e.g. Windows messages). + /// Supports tasks, timers and native UI events (e.g. Windows messages). /// ML_TYPE_UI = 1, /// - // Supports tasks, timers and asynchronous IO events. + /// Supports tasks, timers and asynchronous IO events. /// ML_TYPE_IO = 2 } /// -// Windows COM initialization mode. Specifies how COM will be initialized for a -// new thread. +/// Windows COM initialization mode. Specifies how COM will be initialized for a +/// new thread. /// enum cef_com_init_mode_t { /// - // No COM initialization. + /// No COM initialization. /// COM_INIT_MODE_NONE = 0, /// - // Initialize COM using single-threaded apartments. + /// Initialize COM using single-threaded apartments. /// COM_INIT_MODE_STA = 1, /// - // Initialize COM using multi-threaded apartments. + /// Initialize COM using multi-threaded apartments. /// COM_INIT_MODE_MTA = 2 } /// -// Supported value types. +/// Supported value types. /// enum cef_value_type_t { @@ -3458,7 +3592,7 @@ enum cef_value_type_t } /// -// Supported JavaScript dialog types. +/// Supported JavaScript dialog types. /// enum cef_jsdialog_type_t { @@ -3468,58 +3602,58 @@ enum cef_jsdialog_type_t } /// -// Screen information used when window rendering is disabled. This structure is -// passed as a parameter to CefRenderHandler::GetScreenInfo and should be filled -// in by the client. +/// Screen information used when window rendering is disabled. This structure is +/// passed as a parameter to CefRenderHandler::GetScreenInfo and should be +/// filled in by the client. /// struct cef_screen_info_t { /// - // Device scale factor. Specifies the ratio between physical and logical - // pixels. + /// Device scale factor. Specifies the ratio between physical and logical + /// pixels. /// float device_scale_factor; /// - // The screen depth in bits per pixel. + /// The screen depth in bits per pixel. /// int depth; /// - // The bits per color component. This assumes that the colors are balanced - // equally. + /// The bits per color component. This assumes that the colors are balanced + /// equally. /// int depth_per_component; /// - // This can be true for black and white printers. + /// This can be true for black and white printers. /// int is_monochrome; /// - // This is set from the rcMonitor member of MONITORINFOEX, to whit: - // "A RECT structure that specifies the display monitor rectangle, - // expressed in virtual-screen coordinates. Note that if the monitor - // is not the primary display monitor, some of the rectangle's - // coordinates may be negative values." + /// This is set from the rcMonitor member of MONITORINFOEX, to whit: + /// "A RECT structure that specifies the display monitor rectangle, + /// expressed in virtual-screen coordinates. Note that if the monitor + /// is not the primary display monitor, some of the rectangle's + /// coordinates may be negative values." // - // The |rect| and |available_rect| properties are used to determine the - // available surface for rendering popup views. + /// The |rect| and |available_rect| properties are used to determine the + /// available surface for rendering popup views. /// cef_rect_t rect; /// - // This is set from the rcWork member of MONITORINFOEX, to whit: - // "A RECT structure that specifies the work area rectangle of the - // display monitor that can be used by applications, expressed in - // virtual-screen coordinates. Windows uses this rectangle to - // maximize an application on the monitor. The rest of the area in - // rcMonitor contains system windows such as the task bar and side - // bars. Note that if the monitor is not the primary display monitor, - // some of the rectangle's coordinates may be negative values". + /// This is set from the rcWork member of MONITORINFOEX, to whit: + /// "A RECT structure that specifies the work area rectangle of the + /// display monitor that can be used by applications, expressed in + /// virtual-screen coordinates. Windows uses this rectangle to + /// maximize an application on the monitor. The rest of the area in + /// rcMonitor contains system windows such as the task bar and side + /// bars. Note that if the monitor is not the primary display monitor, + /// some of the rectangle's coordinates may be negative values". // - // The |rect| and |available_rect| properties are used to determine the - // available surface for rendering popup views. + /// The |rect| and |available_rect| properties are used to determine the + /// available surface for rendering popup views. /// cef_rect_t available_rect; } @@ -3527,8 +3661,8 @@ struct cef_screen_info_t /// -// Supported menu IDs. Non-English translations can be provided for the -// IDS_MENU_* strings in CefResourceBundleHandler::GetLocalizedString(). +/// Supported menu IDs. Non-English translations can be provided for the +/// IDS_MENU_* strings in CefResourceBundleHandler::GetLocalizedString(). /// enum cef_menu_id_t { @@ -3563,8 +3697,7 @@ enum cef_menu_id_t MENU_ID_NO_SPELLING_SUGGESTIONS = 205, MENU_ID_ADD_TO_DICTIONARY = 206, - // Custom menu items originating from the renderer process. For example, - // plugin placeholder menu items. + // Custom menu items originating from the renderer process. MENU_ID_CUSTOM_FIRST = 220, MENU_ID_CUSTOM_LAST = 250, @@ -3576,7 +3709,7 @@ enum cef_menu_id_t } /// -// Mouse button types. +/// Mouse button types. /// enum cef_mouse_button_type_t { @@ -3586,23 +3719,23 @@ enum cef_mouse_button_type_t } /// -// Structure representing mouse event information. +/// Structure representing mouse event information. /// struct cef_mouse_event_t { /// - // X coordinate relative to the left side of the view. + /// X coordinate relative to the left side of the view. /// int x; /// - // Y coordinate relative to the top side of the view. + /// Y coordinate relative to the top side of the view. /// int y; /// - // Bit flags describing any pressed modifier keys. See - // cef_event_flags_t for values. + /// Bit flags describing any pressed modifier keys. See + /// cef_event_flags_t for values. /// uint32 modifiers; } @@ -3610,7 +3743,7 @@ struct cef_mouse_event_t /// -// Touch points states types. +/// Touch points states types. /// enum cef_touch_event_type_t { @@ -3621,7 +3754,7 @@ enum cef_touch_event_type_t } /// -// The device type that caused the event. +/// The device type that caused the event. /// enum cef_pointer_type_t { @@ -3633,64 +3766,64 @@ enum cef_pointer_type_t } /// -// Structure representing touch event information. +/// Structure representing touch event information. /// struct cef_touch_event_t { /// - // Id of a touch point. Must be unique per touch, can be any number except -1. - // Note that a maximum of 16 concurrent touches will be tracked; touches - // beyond that will be ignored. + /// Id of a touch point. Must be unique per touch, can be any number except + /// -1. Note that a maximum of 16 concurrent touches will be tracked; touches + /// beyond that will be ignored. /// int id; /// - // X coordinate relative to the left side of the view. + /// X coordinate relative to the left side of the view. /// float x; /// - // Y coordinate relative to the top side of the view. + /// Y coordinate relative to the top side of the view. /// float y; /// - // X radius in pixels. Set to 0 if not applicable. + /// X radius in pixels. Set to 0 if not applicable. /// float radius_x; /// - // Y radius in pixels. Set to 0 if not applicable. + /// Y radius in pixels. Set to 0 if not applicable. /// float radius_y; /// - // Rotation angle in radians. Set to 0 if not applicable. + /// Rotation angle in radians. Set to 0 if not applicable. /// float rotation_angle; /// - // The normalized pressure of the pointer input in the range of [0,1]. - // Set to 0 if not applicable. + /// The normalized pressure of the pointer input in the range of [0,1]. + /// Set to 0 if not applicable. /// float pressure; /// - // The state of the touch point. Touches begin with one CEF_TET_PRESSED event - // followed by zero or more CEF_TET_MOVED events and finally one - // CEF_TET_RELEASED or CEF_TET_CANCELLED event. Events not respecting this - // order will be ignored. + /// The state of the touch point. Touches begin with one CEF_TET_PRESSED event + /// followed by zero or more CEF_TET_MOVED events and finally one + /// CEF_TET_RELEASED or CEF_TET_CANCELLED event. Events not respecting this + /// order will be ignored. /// cef_touch_event_type_t type; /// - // Bit flags describing any pressed modifier keys. See - // cef_event_flags_t for values. + /// Bit flags describing any pressed modifier keys. See + /// cef_event_flags_t for values. /// uint32 modifiers; /// - // The device type that caused the event. + /// The device type that caused the event. /// cef_pointer_type_t pointer_type; } @@ -3698,7 +3831,7 @@ struct cef_touch_event_t /// -// Paint element types. +/// Paint element types. /// enum cef_paint_element_type_t { @@ -3707,7 +3840,7 @@ enum cef_paint_element_type_t } /// -// Supported event bit flags. +/// Supported event bit flags. /// enum cef_event_flags_t { @@ -3719,7 +3852,7 @@ enum cef_event_flags_t EVENTFLAG_LEFT_MOUSE_BUTTON = 1 << 4, EVENTFLAG_MIDDLE_MOUSE_BUTTON = 1 << 5, EVENTFLAG_RIGHT_MOUSE_BUTTON = 1 << 6, - // Mac OS-X command key. + /// Mac OS-X command key. EVENTFLAG_COMMAND_DOWN = 1 << 7, EVENTFLAG_NUM_LOCK_ON = 1 << 8, EVENTFLAG_IS_KEY_PAD = 1 << 9, @@ -3730,7 +3863,7 @@ enum cef_event_flags_t } /// -// Supported menu item types. +/// Supported menu item types. /// enum cef_menu_item_type_t { @@ -3743,91 +3876,103 @@ enum cef_menu_item_type_t } /// -// Supported context menu type flags. +/// Supported context menu type flags. /// enum cef_context_menu_type_flags_t { /// - // No node is selected. + /// No node is selected. /// CM_TYPEFLAG_NONE = 0, /// - // The top page is selected. + /// The top page is selected. /// CM_TYPEFLAG_PAGE = 1 << 0, /// - // A subframe page is selected. + /// A subframe page is selected. /// CM_TYPEFLAG_FRAME = 1 << 1, /// - // A link is selected. + /// A link is selected. /// CM_TYPEFLAG_LINK = 1 << 2, /// - // A media node is selected. + /// A media node is selected. /// CM_TYPEFLAG_MEDIA = 1 << 3, /// - // There is a textual or mixed selection that is selected. + /// There is a textual or mixed selection that is selected. /// CM_TYPEFLAG_SELECTION = 1 << 4, /// - // An editable element is selected. + /// An editable element is selected. /// CM_TYPEFLAG_EDITABLE = 1 << 5 } /// -// Supported context menu media types. +/// Supported context menu media types. These constants match their equivalents +/// in Chromium's ContextMenuDataMediaType and should not be renumbered. /// enum cef_context_menu_media_type_t { /// - // No special node is in context. + /// No special node is in context. /// CM_MEDIATYPE_NONE = 0, /// - // An image node is selected. + /// An image node is selected. /// CM_MEDIATYPE_IMAGE = 1, /// - // A video node is selected. + /// A video node is selected. /// CM_MEDIATYPE_VIDEO = 2, /// - // An audio node is selected. + /// An audio node is selected. /// CM_MEDIATYPE_AUDIO = 3, /// - // A file node is selected. + /// An canvas node is selected. /// - CM_MEDIATYPE_FILE = 4, + CM_MEDIATYPE_CANVAS = 4, /// - // A plugin node is selected. + /// A file node is selected. /// - CM_MEDIATYPE_PLUGIN = 5 + CM_MEDIATYPE_FILE = 5, + /// + /// A plugin node is selected. + /// + CM_MEDIATYPE_PLUGIN = 6 } /// -// Supported context menu media state bit flags. +/// Supported context menu media state bit flags. These constants match their +/// equivalents in Chromium's ContextMenuData::MediaFlags and should not be +/// renumbered. /// enum cef_context_menu_media_state_flags_t { CM_MEDIAFLAG_NONE = 0, - CM_MEDIAFLAG_ERROR = 1 << 0, + CM_MEDIAFLAG_IN_ERROR = 1 << 0, CM_MEDIAFLAG_PAUSED = 1 << 1, CM_MEDIAFLAG_MUTED = 1 << 2, CM_MEDIAFLAG_LOOP = 1 << 3, CM_MEDIAFLAG_CAN_SAVE = 1 << 4, CM_MEDIAFLAG_HAS_AUDIO = 1 << 5, - CM_MEDIAFLAG_HAS_VIDEO = 1 << 6, - CM_MEDIAFLAG_CONTROL_ROOT_ELEMENT = 1 << 7, + CM_MEDIAFLAG_CAN_TOGGLE_CONTROLS = 1 << 6, + CM_MEDIAFLAG_CONTROLS = 1 << 7, CM_MEDIAFLAG_CAN_PRINT = 1 << 8, - CM_MEDIAFLAG_CAN_ROTATE = 1 << 9 + CM_MEDIAFLAG_CAN_ROTATE = 1 << 9, + CM_MEDIAFLAG_CAN_PICTURE_IN_PICTURE = 1 << 10, + CM_MEDIAFLAG_PICTURE_IN_PICTURE = 1 << 11, + CM_MEDIAFLAG_CAN_LOOP = 1 << 12 } /// -// Supported context menu edit state bit flags. +/// Supported context menu edit state bit flags. These constants match their +/// equivalents in Chromium's ContextMenuDataEditFlags and should not be +/// renumbered. /// enum cef_context_menu_edit_state_flags_t { @@ -3839,89 +3984,102 @@ enum cef_context_menu_edit_state_flags_t CM_EDITFLAG_CAN_PASTE = 1 << 4, CM_EDITFLAG_CAN_DELETE = 1 << 5, CM_EDITFLAG_CAN_SELECT_ALL = 1 << 6, - CM_EDITFLAG_CAN_TRANSLATE = 1 << 7 + CM_EDITFLAG_CAN_TRANSLATE = 1 << 7, + CM_EDITFLAG_CAN_EDIT_RICHLY = 1 << 8 } /// -// Key event types. +/// Supported quick menu state bit flags. +/// +enum cef_quick_menu_edit_state_flags_t +{ + QM_EDITFLAG_NONE = 0, + QM_EDITFLAG_CAN_ELLIPSIS = 1 << 0, + QM_EDITFLAG_CAN_CUT = 1 << 1, + QM_EDITFLAG_CAN_COPY = 1 << 2, + QM_EDITFLAG_CAN_PASTE = 1 << 3 +} + +/// +/// Key event types. /// enum cef_key_event_type_t { /// - // Notification that a key transitioned from "up" to "down". + /// Notification that a key transitioned from "up" to "down". /// KEYEVENT_RAWKEYDOWN = 0, /// - // Notification that a key was pressed. This does not necessarily correspond - // to a character depending on the key and language. Use KEYEVENT_CHAR for - // character input. + /// Notification that a key was pressed. This does not necessarily correspond + /// to a character depending on the key and language. Use KEYEVENT_CHAR for + /// character input. /// KEYEVENT_KEYDOWN = 1, /// - // Notification that a key was released. + /// Notification that a key was released. /// KEYEVENT_KEYUP = 2, /// - // Notification that a character was typed. Use this for text input. Key - // down events may generate 0, 1, or more than one character event depending - // on the key, locale, and operating system. + /// Notification that a character was typed. Use this for text input. Key + /// down events may generate 0, 1, or more than one character event depending + /// on the key, locale, and operating system. /// KEYEVENT_CHAR = 3 } /// -// Structure representing keyboard event information. +/// Structure representing keyboard event information. /// struct cef_key_event_t { /// - // The type of keyboard event. + /// The type of keyboard event. /// cef_key_event_type_t type; /// - // Bit flags describing any pressed modifier keys. See - // cef_event_flags_t for values. + /// Bit flags describing any pressed modifier keys. See + /// cef_event_flags_t for values. /// uint32 modifiers; /// - // The Windows key code for the key event. This value is used by the DOM - // specification. Sometimes it comes directly from the event (i.e. on - // Windows) and sometimes it's determined using a mapping function. See - // WebCore/platform/chromium/KeyboardCodes.h for the list of values. + /// The Windows key code for the key event. This value is used by the DOM + /// specification. Sometimes it comes directly from the event (i.e. on + /// Windows) and sometimes it's determined using a mapping function. See + /// WebCore/platform/chromium/KeyboardCodes.h for the list of values. /// int windows_key_code; /// - // The actual key code genenerated by the platform. + /// The actual key code genenerated by the platform. /// int native_key_code; /// - // Indicates whether the event is considered a "system key" event (see - // http://msdn.microsoft.com/en-us/library/ms646286(VS.85).aspx for details). - // This value will always be false on non-Windows platforms. + /// Indicates whether the event is considered a "system key" event (see + /// http://msdn.microsoft.com/en-us/library/ms646286(VS.85).aspx for details). + /// This value will always be false on non-Windows platforms. /// int is_system_key; /// - // The character generated by the keystroke. + /// The character generated by the keystroke. /// char16 character; /// - // Same as |character| but unmodified by any concurrently-held modifiers - // (except shift). This is useful for working out shortcut keys. + /// Same as |character| but unmodified by any concurrently-held modifiers + /// (except shift). This is useful for working out shortcut keys. /// char16 unmodified_character; /// - // True if the focus is currently on an editable field on the page. This is - // useful for determining if standard key events should be intercepted. + /// True if the focus is currently on an editable field on the page. This is + /// useful for determining if standard key events should be intercepted. /// int focus_on_editable_field; } @@ -3929,22 +4087,22 @@ struct cef_key_event_t /// -// Focus sources. +/// Focus sources. /// enum cef_focus_source_t { /// - // The source is explicit navigation via the API (LoadURL(), etc). + /// The source is explicit navigation via the API (LoadURL(), etc). /// FOCUS_SOURCE_NAVIGATION = 0, /// - // The source is a system-generated focus event. + /// The source is a system-generated focus event. /// FOCUS_SOURCE_SYSTEM = 1 } /// -// Navigation types. +/// Navigation types. /// enum cef_navigation_type_t { @@ -3957,10 +4115,10 @@ enum cef_navigation_type_t } /// -// Supported XML encoding types. The parser supports ASCII, ISO-8859-1, and -// UTF16 (LE and BE) by default. All other types must be translated to UTF8 -// before being passed to the parser. If a BOM is detected and the correct -// decoder is available then that decoder will be used automatically. +/// Supported XML encoding types. The parser supports ASCII, ISO-8859-1, and +/// UTF16 (LE and BE) by default. All other types must be translated to UTF8 +/// before being passed to the parser. If a BOM is detected and the correct +/// decoder is available then that decoder will be used automatically. /// enum cef_xml_encoding_type_t { @@ -3972,7 +4130,7 @@ enum cef_xml_encoding_type_t } /// -// XML node types. +/// XML node types. /// enum cef_xml_node_type_t { @@ -3990,7 +4148,7 @@ enum cef_xml_node_type_t } /// -// Popup window features. +/// Popup window features. /// struct cef_popup_features_t { @@ -4012,7 +4170,7 @@ struct cef_popup_features_t /// -// DOM document types. +/// DOM document types. /// enum cef_dom_document_type_t { @@ -4023,7 +4181,7 @@ enum cef_dom_document_type_t } /// -// DOM event category flags. +/// DOM event category flags. /// enum cef_dom_event_category_t { @@ -4047,7 +4205,7 @@ enum cef_dom_event_category_t } /// -// DOM event processing phases. +/// DOM event processing phases. /// enum cef_dom_event_phase_t { @@ -4058,7 +4216,7 @@ enum cef_dom_event_phase_t } /// -// DOM node types. +/// DOM node types. /// enum cef_dom_node_type_t { @@ -4075,54 +4233,34 @@ enum cef_dom_node_type_t } /// -// Supported file dialog modes. +/// Supported file dialog modes. /// enum cef_file_dialog_mode_t { /// - // Requires that the file exists before allowing the user to pick it. + /// Requires that the file exists before allowing the user to pick it. /// FILE_DIALOG_OPEN = 0, /// - // Like Open, but allows picking multiple files to open. + /// Like Open, but allows picking multiple files to open. /// FILE_DIALOG_OPEN_MULTIPLE = 1, /// - // Like Open, but selects a folder to open. + /// Like Open, but selects a folder to open. /// FILE_DIALOG_OPEN_FOLDER = 2, /// - // Allows picking a nonexistent file, and prompts to overwrite if the file - // already exists. + /// Allows picking a nonexistent file, and prompts to overwrite if the file + /// already exists. /// - FILE_DIALOG_SAVE = 3, - - /// - // General mask defining the bits used for the type values. - /// - FILE_DIALOG_TYPE_MASK = 0xFF, - - // Qualifiers. - // Any of the type values above can be augmented by one or more qualifiers. - // These qualifiers further define the dialog behavior. - - /// - // Prompt to overwrite if the user selects an existing file with the Save - // dialog. - /// - FILE_DIALOG_OVERWRITEPROMPT_FLAG = 0x01000000, - - /// - // Do not display read-only files. - /// - FILE_DIALOG_HIDEREADONLY_FLAG = 0x02000000 + FILE_DIALOG_SAVE = 3 } /// -// Print job color mode values. +/// Print job color mode values. /// enum cef_color_model_t { @@ -4150,7 +4288,7 @@ enum cef_color_model_t } /// -// Print job duplex mode values. +/// Print job duplex mode values. /// enum cef_duplex_mode_t { @@ -4161,7 +4299,7 @@ enum cef_duplex_mode_t } /// -// Cursor type values. +/// Cursor type values. /// enum cef_cursor_type_t { @@ -4218,9 +4356,9 @@ enum cef_cursor_type_t } /// -// Structure representing cursor information. |buffer| will be -// |size.width|*|size.height|*4 bytes in size and represents a BGRA image with -// an upper-left origin. +/// Structure representing cursor information. |buffer| will be +/// |size.width|*|size.height|*4 bytes in size and represents a BGRA image with +/// an upper-left origin. /// struct cef_cursor_info_t { @@ -4233,167 +4371,168 @@ struct cef_cursor_info_t /// -// URI unescape rules passed to CefURIDecode(). +/// URI unescape rules passed to CefURIDecode(). /// enum cef_uri_unescape_rule_t { /// - // Don't unescape anything at all. + /// Don't unescape anything at all. /// UU_NONE = 0, /// - // Don't unescape anything special, but all normal unescaping will happen. - // This is a placeholder and can't be combined with other flags (since it's - // just the absence of them). All other unescape rules imply "normal" in - // addition to their special meaning. Things like escaped letters, digits, - // and most symbols will get unescaped with this mode. + /// Don't unescape anything special, but all normal unescaping will happen. + /// This is a placeholder and can't be combined with other flags (since it's + /// just the absence of them). All other unescape rules imply "normal" in + /// addition to their special meaning. Things like escaped letters, digits, + /// and most symbols will get unescaped with this mode. /// UU_NORMAL = 1 << 0, /// - // Convert %20 to spaces. In some places where we're showing URLs, we may - // want this. In places where the URL may be copied and pasted out, then - // you wouldn't want this since it might not be interpreted in one piece - // by other applications. + /// Convert %20 to spaces. In some places where we're showing URLs, we may + /// want this. In places where the URL may be copied and pasted out, then + /// you wouldn't want this since it might not be interpreted in one piece + /// by other applications. /// UU_SPACES = 1 << 1, /// - // Unescapes '/' and '\\'. If these characters were unescaped, the resulting - // URL won't be the same as the source one. Moreover, they are dangerous to - // unescape in strings that will be used as file paths or names. This value - // should only be used when slashes don't have special meaning, like data - // URLs. + /// Unescapes '/' and '\\'. If these characters were unescaped, the resulting + /// URL won't be the same as the source one. Moreover, they are dangerous to + /// unescape in strings that will be used as file paths or names. This value + /// should only be used when slashes don't have special meaning, like data + /// URLs. /// UU_PATH_SEPARATORS = 1 << 2, /// - // Unescapes various characters that will change the meaning of URLs, - // including '%', '+', '&', '#'. Does not unescape path separators. - // If these characters were unescaped, the resulting URL won't be the same - // as the source one. This flag is used when generating final output like - // filenames for URLs where we won't be interpreting as a URL and want to do - // as much unescaping as possible. + /// Unescapes various characters that will change the meaning of URLs, + /// including '%', '+', '&', '#'. Does not unescape path separators. + /// If these characters were unescaped, the resulting URL won't be the same + /// as the source one. This flag is used when generating final output like + /// filenames for URLs where we won't be interpreting as a URL and want to do + /// as much unescaping as possible. /// UU_URL_SPECIAL_CHARS_EXCEPT_PATH_SEPARATORS = 1 << 3, /// - // URL queries use "+" for space. This flag controls that replacement. + /// URL queries use "+" for space. This flag controls that replacement. /// UU_REPLACE_PLUS_WITH_SPACE = 1 << 4 } /// -// Options that can be passed to CefParseJSON. +/// Options that can be passed to CefParseJSON. /// enum cef_json_parser_options_t { /// - // Parses the input strictly according to RFC 4627. See comments in Chromium's - // base/json/json_reader.h file for known limitations/deviations from the RFC. + /// Parses the input strictly according to RFC 4627. See comments in + /// Chromium's base/json/json_reader.h file for known limitations/ + /// deviations from the RFC. /// JSON_PARSER_RFC = 0, /// - // Allows commas to exist after the last element in structures. + /// Allows commas to exist after the last element in structures. /// JSON_PARSER_ALLOW_TRAILING_COMMAS = 1 << 0 } /// -// Options that can be passed to CefWriteJSON. +/// Options that can be passed to CefWriteJSON. /// enum cef_json_writer_options_t { /// - // Default behavior. + /// Default behavior. /// JSON_WRITER_DEFAULT = 0, /// - // This option instructs the writer that if a Binary value is encountered, - // the value (and key if within a dictionary) will be omitted from the - // output, and success will be returned. Otherwise, if a binary value is - // encountered, failure will be returned. + /// This option instructs the writer that if a Binary value is encountered, + /// the value (and key if within a dictionary) will be omitted from the + /// output, and success will be returned. Otherwise, if a binary value is + /// encountered, failure will be returned. /// JSON_WRITER_OMIT_BINARY_VALUES = 1 << 0, /// - // This option instructs the writer to write doubles that have no fractional - // part as a normal integer (i.e., without using exponential notation - // or appending a '.0') as long as the value is within the range of a - // 64-bit int. + /// This option instructs the writer to write doubles that have no fractional + /// part as a normal integer (i.e., without using exponential notation + /// or appending a '.0') as long as the value is within the range of a + /// 64-bit int. /// JSON_WRITER_OMIT_DOUBLE_TYPE_PRESERVATION = 1 << 1, /// - // Return a slightly nicer formatted json string (pads with whitespace to - // help with readability). + /// Return a slightly nicer formatted json string (pads with whitespace to + /// help with readability). /// JSON_WRITER_PRETTY_PRINT = 1 << 2 } /// -// Margin type for PDF printing. +/// Margin type for PDF printing. /// enum cef_pdf_print_margin_type_t { /// - // Default margins. + /// Default margins. /// PDF_PRINT_MARGIN_DEFAULT = 0, /// - // No margins. + /// No margins. /// PDF_PRINT_MARGIN_NONE = 1, /// - // Minimum margins. + /// Minimum margins. /// PDF_PRINT_MARGIN_MINIMUM = 2, /// - // Custom margins using the |margin_*| values from cef_pdf_print_settings_t. + /// Custom margins using the |margin_*| values from cef_pdf_print_settings_t. /// PDF_PRINT_MARGIN_CUSTOM = 3 } /// -// Structure representing PDF print settings. +/// Structure representing PDF print settings. /// struct cef_pdf_print_settings_t { /// - // Page title to display in the header. Only used if |header_footer_enabled| - // is set to true (1). + /// Page title to display in the header. Only used if |header_footer_enabled| + /// is set to true (1). /// cef_string_t header_footer_title; /// - // URL to display in the footer. Only used if |header_footer_enabled| is set - // to true (1). + /// URL to display in the footer. Only used if |header_footer_enabled| is set + /// to true (1). /// cef_string_t header_footer_url; /// - // Output page size in microns. If either of these values is less than or - // equal to zero then the default paper size (A4) will be used. + /// Output page size in microns. If either of these values is less than or + /// equal to zero then the default paper size (A4) will be used. /// int page_width; int page_height; /// - // The percentage to scale the PDF by before printing (e.g. 50 is 50%). - // If this value is less than or equal to zero the default value of 100 - // will be used. + /// The percentage to scale the PDF by before printing (e.g. 50 is 50%). + /// If this value is less than or equal to zero the default value of 100 + /// will be used. /// int scale_factor; /// - // Margins in points. Only used if |margin_type| is set to - // PDF_PRINT_MARGIN_CUSTOM. + /// Margins in points. Only used if |margin_type| is set to + /// PDF_PRINT_MARGIN_CUSTOM. /// int margin_top; int margin_right; @@ -4401,29 +4540,29 @@ struct cef_pdf_print_settings_t int margin_left; /// - // Margin type. + /// Margin type. /// cef_pdf_print_margin_type_t margin_type; /// - // Set to true (1) to print headers and footers or false (0) to not print - // headers and footers. + /// Set to true (1) to print headers and footers or false (0) to not print + /// headers and footers. /// int header_footer_enabled; /// - // Set to true (1) to print the selection only or false (0) to print all. + /// Set to true (1) to print the selection only or false (0) to print all. /// int selection_only; /// - // Set to true (1) for landscape mode or false (0) for portrait mode. + /// Set to true (1) for landscape mode or false (0) for portrait mode. /// int landscape; /// - // Set to true (1) to print background graphics or false (0) to not print - // background graphics. + /// Set to true (1) to print background graphics or false (0) to not print + /// background graphics. /// int backgrounds_enabled; } @@ -4431,9 +4570,9 @@ struct cef_pdf_print_settings_t /// -// Supported UI scale factors for the platform. SCALE_FACTOR_NONE is used for -// density independent resources such as string, html/js files or an image that -// can be used for any scale factors (such as wallpapers). +/// Supported UI scale factors for the platform. SCALE_FACTOR_NONE is used for +/// density independent resources such as string, html/js files or an image that +/// can be used for any scale factors (such as wallpapers). /// enum cef_scale_factor_t { @@ -4450,155 +4589,128 @@ enum cef_scale_factor_t } /// -// Plugin policies supported by CefRequestContextHandler::OnBeforePluginLoad. -/// -enum cef_plugin_policy_t -{ - /// - // Allow the content. - /// - PLUGIN_POLICY_ALLOW = 0, - - /// - // Allow important content and block unimportant content based on heuristics. - // The user can manually load blocked content. - /// - PLUGIN_POLICY_DETECT_IMPORTANT = 1, - - /// - // Block the content. The user can manually load blocked content. - /// - PLUGIN_POLICY_BLOCK = 2, - - /// - // Disable the content. The user cannot load disabled content. - /// - PLUGIN_POLICY_DISABLE = 3 -} - -/// -// Policy for how the Referrer HTTP header value will be sent during navigation. -// If the `--no-referrers` command-line flag is specified then the policy value -// will be ignored and the Referrer value will never be sent. -// Must be kept synchronized with net::URLRequest::ReferrerPolicy from Chromium. +/// Policy for how the Referrer HTTP header value will be sent during +/// navigation. If the `--no-referrers` command-line flag is specified then the +/// policy value will be ignored and the Referrer value will never be sent. Must +/// be kept synchronized with net::URLRequest::ReferrerPolicy from Chromium. /// enum cef_referrer_policy_t { /// - // Clear the referrer header if the header value is HTTPS but the request - // destination is HTTP. This is the default behavior. + /// Clear the referrer header if the header value is HTTPS but the request + /// destination is HTTP. This is the default behavior. /// REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE = 0, REFERRER_POLICY_DEFAULT = REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE, /// - // A slight variant on CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE: - // If the request destination is HTTP, an HTTPS referrer will be cleared. If - // the request's destination is cross-origin with the referrer (but does not - // downgrade), the referrer's granularity will be stripped down to an origin - // rather than a full URL. Same-origin requests will send the full referrer. + /// A slight variant on CLEAR_REFERRER_ON_TRANSITION_FROM_SECURE_TO_INSECURE: + /// If the request destination is HTTP, an HTTPS referrer will be cleared. If + /// the request's destination is cross-origin with the referrer (but does not + /// downgrade), the referrer's granularity will be stripped down to an origin + /// rather than a full URL. Same-origin requests will send the full referrer. /// REFERRER_POLICY_REDUCE_REFERRER_GRANULARITY_ON_TRANSITION_CROSS_ORIGIN = 1, /// - // Strip the referrer down to an origin when the origin of the referrer is - // different from the destination's origin. + /// Strip the referrer down to an origin when the origin of the referrer is + /// different from the destination's origin. /// REFERRER_POLICY_ORIGIN_ONLY_ON_TRANSITION_CROSS_ORIGIN = 2, /// - // Never change the referrer. + /// Never change the referrer. /// REFERRER_POLICY_NEVER_CLEAR_REFERRER = 3, /// - // Strip the referrer down to the origin regardless of the redirect location. + /// Strip the referrer down to the origin regardless of the redirect location. /// REFERRER_POLICY_ORIGIN = 4, /// - // Clear the referrer when the request's referrer is cross-origin with the - // request's destination. + /// Clear the referrer when the request's referrer is cross-origin with the + /// request's destination. /// REFERRER_POLICY_CLEAR_REFERRER_ON_TRANSITION_CROSS_ORIGIN = 5, /// - // Strip the referrer down to the origin, but clear it entirely if the - // referrer value is HTTPS and the destination is HTTP. + /// Strip the referrer down to the origin, but clear it entirely if the + /// referrer value is HTTPS and the destination is HTTP. /// REFERRER_POLICY_ORIGIN_CLEAR_ON_TRANSITION_FROM_SECURE_TO_INSECURE = 6, /// - // Always clear the referrer regardless of the request destination. + /// Always clear the referrer regardless of the request destination. /// REFERRER_POLICY_NO_REFERRER = 7, - // Always the last value in this enumeration. + /// Always the last value in this enumeration. REFERRER_POLICY_LAST_VALUE = REFERRER_POLICY_NO_REFERRER } /// -// Return values for CefResponseFilter::Filter(). +/// Return values for CefResponseFilter::Filter(). /// enum cef_response_filter_status_t { /// - // Some or all of the pre-filter data was read successfully but more data is - // needed in order to continue filtering (filtered output is pending). + /// Some or all of the pre-filter data was read successfully but more data is + /// needed in order to continue filtering (filtered output is pending). /// RESPONSE_FILTER_NEED_MORE_DATA = 0, /// - // Some or all of the pre-filter data was read successfully and all available - // filtered output has been written. + /// Some or all of the pre-filter data was read successfully and all available + /// filtered output has been written. /// RESPONSE_FILTER_DONE = 1, /// - // An error occurred during filtering. + /// An error occurred during filtering. /// RESPONSE_FILTER_ERROR = 2 } /// -// Describes how to interpret the components of a pixel. +/// Describes how to interpret the components of a pixel. /// enum cef_color_type_t { /// - // RGBA with 8 bits per pixel (32bits total). + /// RGBA with 8 bits per pixel (32bits total). /// CEF_COLOR_TYPE_RGBA_8888 = 0, /// - // BGRA with 8 bits per pixel (32bits total). + /// BGRA with 8 bits per pixel (32bits total). /// CEF_COLOR_TYPE_BGRA_8888 = 1 } /// -// Describes how to interpret the alpha component of a pixel. +/// Describes how to interpret the alpha component of a pixel. /// enum cef_alpha_type_t { /// - // No transparency. The alpha component is ignored. + /// No transparency. The alpha component is ignored. /// CEF_ALPHA_TYPE_OPAQUE = 0, /// - // Transparency with pre-multiplied alpha component. + /// Transparency with pre-multiplied alpha component. /// CEF_ALPHA_TYPE_PREMULTIPLIED = 1, /// - // Transparency with post-multiplied alpha component. + /// Transparency with post-multiplied alpha component. /// CEF_ALPHA_TYPE_POSTMULTIPLIED = 2 } /// -// Text style types. Should be kepy in sync with gfx::TextStyle. +/// Text style types. Should be kepy in sync with gfx::TextStyle. /// enum cef_text_style_t { @@ -4610,108 +4722,109 @@ enum cef_text_style_t } /// -// Specifies where along the main axis the CefBoxLayout child views should be -// laid out. +/// Specifies where along the main axis the CefBoxLayout child views should be +/// laid out. /// enum cef_main_axis_alignment_t { /// - // Child views will be left-aligned. + /// Child views will be left-aligned. /// CEF_MAIN_AXIS_ALIGNMENT_START = 0, /// - // Child views will be center-aligned. + /// Child views will be center-aligned. /// CEF_MAIN_AXIS_ALIGNMENT_CENTER = 1, /// - // Child views will be right-aligned. + /// Child views will be right-aligned. /// CEF_MAIN_AXIS_ALIGNMENT_END = 2 } /// -// Specifies where along the cross axis the CefBoxLayout child views should be -// laid out. +/// Specifies where along the cross axis the CefBoxLayout child views should be +/// laid out. /// enum cef_cross_axis_alignment_t { /// - // Child views will be stretched to fit. + /// Child views will be stretched to fit. /// CEF_CROSS_AXIS_ALIGNMENT_STRETCH = 0, /// - // Child views will be left-aligned. + /// Child views will be left-aligned. /// CEF_CROSS_AXIS_ALIGNMENT_START = 1, /// - // Child views will be center-aligned. + /// Child views will be center-aligned. /// CEF_CROSS_AXIS_ALIGNMENT_CENTER = 2, /// - // Child views will be right-aligned. + /// Child views will be right-aligned. /// CEF_CROSS_AXIS_ALIGNMENT_END = 3 } /// -// Settings used when initializing a CefBoxLayout. +/// Settings used when initializing a CefBoxLayout. /// struct cef_box_layout_settings_t { /// - // If true (1) the layout will be horizontal, otherwise the layout will be - // vertical. + /// If true (1) the layout will be horizontal, otherwise the layout will be + /// vertical. /// int horizontal; /// - // Adds additional horizontal space between the child view area and the host - // view border. + /// Adds additional horizontal space between the child view area and the host + /// view border. /// int inside_border_horizontal_spacing; /// - // Adds additional vertical space between the child view area and the host - // view border. + /// Adds additional vertical space between the child view area and the host + /// view border. /// int inside_border_vertical_spacing; /// - // Adds additional space around the child view area. + /// Adds additional space around the child view area. /// cef_insets_t inside_border_insets; /// - // Adds additional space between child views. + /// Adds additional space between child views. /// int between_child_spacing; /// - // Specifies where along the main axis the child views should be laid out. + /// Specifies where along the main axis the child views should be laid out. /// cef_main_axis_alignment_t main_axis_alignment; /// - // Specifies where along the cross axis the child views should be laid out. + /// Specifies where along the cross axis the child views should be laid out. /// cef_cross_axis_alignment_t cross_axis_alignment; /// - // Minimum cross axis size. + /// Minimum cross axis size. /// int minimum_cross_axis_size; /// - // Default flex for views when none is specified via CefBoxLayout methods. - // Using the preferred size as the basis, free space along the main axis is - // distributed to views in the ratio of their flex weights. Similarly, if the - // views will overflow the parent, space is subtracted in these ratios. A flex - // of 0 means this view is not resized. Flex values must not be negative. + /// Default flex for views when none is specified via CefBoxLayout methods. + /// Using the preferred size as the basis, free space along the main axis is + /// distributed to views in the ratio of their flex weights. Similarly, if the + /// views will overflow the parent, space is subtracted in these ratios. A + /// flex of 0 means this view is not resized. Flex values must not be + /// negative. /// int default_flex; } @@ -4719,7 +4832,7 @@ struct cef_box_layout_settings_t /// -// Specifies the button display state. +/// Specifies the button display state. /// enum cef_button_state_t { @@ -4730,29 +4843,29 @@ enum cef_button_state_t } /// -// Specifies the horizontal text alignment mode. +/// Specifies the horizontal text alignment mode. /// enum cef_horizontal_alignment_t { /// - // Align the text's left edge with that of its display area. + /// Align the text's left edge with that of its display area. /// CEF_HORIZONTAL_ALIGNMENT_LEFT = 0, /// - // Align the text's center with that of its display area. + /// Align the text's center with that of its display area. /// CEF_HORIZONTAL_ALIGNMENT_CENTER = 1, /// - // Align the text's right edge with that of its display area. + /// Align the text's right edge with that of its display area. /// CEF_HORIZONTAL_ALIGNMENT_RIGHT = 2 } /// -// Specifies how a menu will be anchored for non-RTL languages. The opposite -// position will be used for RTL languages. +/// Specifies how a menu will be anchored for non-RTL languages. The opposite +/// position will be used for RTL languages. /// enum cef_menu_anchor_position_t { @@ -4762,7 +4875,7 @@ enum cef_menu_anchor_position_t } /// -// Supported color types for menu items. +/// Supported color types for menu items. /// enum cef_menu_color_type_t { @@ -4775,8 +4888,8 @@ enum cef_menu_color_type_t CEF_MENU_COLOR_COUNT = 6 } -// Supported SSL version values. See net/ssl/ssl_connection_status_flags.h -// for more information. +/// Supported SSL version values. See net/ssl/ssl_connection_status_flags.h +/// for more information. enum cef_ssl_version_t { SSL_CONNECTION_VERSION_UNKNOWN = 0, // Unknown SSL version. @@ -4789,8 +4902,8 @@ enum cef_ssl_version_t SSL_CONNECTION_VERSION_QUIC = 7 } -// Supported SSL content status flags. See content/public/common/ssl_status.h -// for more information. +/// Supported SSL content status flags. See content/public/common/ssl_status.h +/// for more information. enum cef_ssl_content_status_t { SSL_CONTENT_NORMAL_CONTENT = 0, @@ -4799,92 +4912,93 @@ enum cef_ssl_content_status_t } // -// Configuration options for registering a custom scheme. -// These values are used when calling AddCustomScheme. +/// Configuration options for registering a custom scheme. +/// These values are used when calling AddCustomScheme. // enum cef_scheme_options_t { CEF_SCHEME_OPTION_NONE = 0, /// - // If CEF_SCHEME_OPTION_STANDARD is set the scheme will be treated as a - // standard scheme. Standard schemes are subject to URL canonicalization and - // parsing rules as defined in the Common Internet Scheme Syntax RFC 1738 - // Section 3.1 available at http://www.ietf.org/rfc/rfc1738.txt + /// If CEF_SCHEME_OPTION_STANDARD is set the scheme will be treated as a + /// standard scheme. Standard schemes are subject to URL canonicalization and + /// parsing rules as defined in the Common Internet Scheme Syntax RFC 1738 + /// Section 3.1 available at http://www.ietf.org/rfc/rfc1738.txt // - // In particular, the syntax for standard scheme URLs must be of the form: - // 
-    //  [scheme]://[username]:[password]@[host]:[port]/[url-path]
-    //
Standard scheme URLs must have a host component that is a fully - // qualified domain name as defined in Section 3.5 of RFC 1034 [13] and - // Section 2.1 of RFC 1123. These URLs will be canonicalized to - // "scheme://host/path" in the simplest case and - // "scheme://username:password@host:port/path" in the most explicit case. For - // example, "scheme:host/path" and "scheme:///host/path" will both be - // canonicalized to "scheme://host/path". The origin of a standard scheme URL - // is the combination of scheme, host and port (i.e., "scheme://host:port" in - // the most explicit case). + /// In particular, the syntax for standard scheme URLs must be of the form: + /// 
+    ///  [scheme]://[username]:[password]@[host]:[port]/[url-path]
+    ///
Standard scheme URLs must have a host component that is a fully + /// qualified domain name as defined in Section 3.5 of RFC 1034 [13] and + /// Section 2.1 of RFC 1123. These URLs will be canonicalized to + /// "scheme://host/path" in the simplest case and + /// "scheme://username:password@host:port/path" in the most explicit case. For + /// example, "scheme:host/path" and "scheme:///host/path" will both be + /// canonicalized to "scheme://host/path". The origin of a standard scheme URL + /// is the combination of scheme, host and port (i.e., "scheme://host:port" in + /// the most explicit case). // - // For non-standard scheme URLs only the "scheme:" component is parsed and - // canonicalized. The remainder of the URL will be passed to the handler as- - // is. For example, "scheme:///some%20text" will remain the same. Non-standard - // scheme URLs cannot be used as a target for form submission. + /// For non-standard scheme URLs only the "scheme:" component is parsed and + /// canonicalized. The remainder of the URL will be passed to the handler as- + /// is. For example, "scheme:///some%20text" will remain the same. + /// Non-standard scheme URLs cannot be used as a target for form submission. /// CEF_SCHEME_OPTION_STANDARD = 1 << 0, /// - // If CEF_SCHEME_OPTION_LOCAL is set the scheme will be treated with the same - // security rules as those applied to "file" URLs. Normal pages cannot link to - // or access local URLs. Also, by default, local URLs can only perform - // XMLHttpRequest calls to the same URL (origin + path) that originated the - // request. To allow XMLHttpRequest calls from a local URL to other URLs with - // the same origin set the CefSettings.file_access_from_file_urls_allowed - // value to true (1). To allow XMLHttpRequest calls from a local URL to all - // origins set the CefSettings.universal_access_from_file_urls_allowed value - // to true (1). + /// If CEF_SCHEME_OPTION_LOCAL is set the scheme will be treated with the same + /// security rules as those applied to "file" URLs. Normal pages cannot link + /// to or access local URLs. Also, by default, local URLs can only perform + /// XMLHttpRequest calls to the same URL (origin + path) that originated the + /// request. To allow XMLHttpRequest calls from a local URL to other URLs with + /// the same origin set the CefSettings.file_access_from_file_urls_allowed + /// value to true (1). To allow XMLHttpRequest calls from a local URL to all + /// origins set the CefSettings.universal_access_from_file_urls_allowed value + /// to true (1). /// CEF_SCHEME_OPTION_LOCAL = 1 << 1, /// - // If CEF_SCHEME_OPTION_DISPLAY_ISOLATED is set the scheme can only be - // displayed from other content hosted with the same scheme. For example, - // pages in other origins cannot create iframes or hyperlinks to URLs with the - // scheme. For schemes that must be accessible from other schemes don't set - // this, set CEF_SCHEME_OPTION_CORS_ENABLED, and use CORS - // "Access-Control-Allow-Origin" headers to further restrict access. + /// If CEF_SCHEME_OPTION_DISPLAY_ISOLATED is set the scheme can only be + /// displayed from other content hosted with the same scheme. For example, + /// pages in other origins cannot create iframes or hyperlinks to URLs with + /// the scheme. For schemes that must be accessible from other schemes don't + /// set this, set CEF_SCHEME_OPTION_CORS_ENABLED, and use CORS + /// "Access-Control-Allow-Origin" headers to further restrict access. /// CEF_SCHEME_OPTION_DISPLAY_ISOLATED = 1 << 2, /// - // If CEF_SCHEME_OPTION_SECURE is set the scheme will be treated with the same - // security rules as those applied to "https" URLs. For example, loading this - // scheme from other secure schemes will not trigger mixed content warnings. + /// If CEF_SCHEME_OPTION_SECURE is set the scheme will be treated with the + /// same security rules as those applied to "https" URLs. For example, loading + /// this scheme from other secure schemes will not trigger mixed content + /// warnings. /// CEF_SCHEME_OPTION_SECURE = 1 << 3, /// - // If CEF_SCHEME_OPTION_CORS_ENABLED is set the scheme can be sent CORS - // requests. This value should be set in most cases where - // CEF_SCHEME_OPTION_STANDARD is set. + /// If CEF_SCHEME_OPTION_CORS_ENABLED is set the scheme can be sent CORS + /// requests. This value should be set in most cases where + /// CEF_SCHEME_OPTION_STANDARD is set. /// CEF_SCHEME_OPTION_CORS_ENABLED = 1 << 4, /// - // If CEF_SCHEME_OPTION_CSP_BYPASSING is set the scheme can bypass Content- - // Security-Policy (CSP) checks. This value should not be set in most cases - // where CEF_SCHEME_OPTION_STANDARD is set. + /// If CEF_SCHEME_OPTION_CSP_BYPASSING is set the scheme can bypass Content- + /// Security-Policy (CSP) checks. This value should not be set in most cases + /// where CEF_SCHEME_OPTION_STANDARD is set. /// CEF_SCHEME_OPTION_CSP_BYPASSING = 1 << 5, /// - // If CEF_SCHEME_OPTION_FETCH_ENABLED is set the scheme can perform Fetch API - // requests. + /// If CEF_SCHEME_OPTION_FETCH_ENABLED is set the scheme can perform Fetch API + /// requests. /// CEF_SCHEME_OPTION_FETCH_ENABLED = 1 << 6 } /// -// Structure representing a range. +/// Structure representing a range. /// struct cef_range_t { @@ -4895,7 +5009,7 @@ struct cef_range_t /// -// Composition underline style. +/// Composition underline style. /// enum cef_composition_underline_style_t { @@ -4906,34 +5020,34 @@ enum cef_composition_underline_style_t } /// -// Structure representing IME composition underline information. This is a thin -// wrapper around Blink's WebCompositionUnderline class and should be kept in -// sync with that. +/// Structure representing IME composition underline information. This is a thin +/// wrapper around Blink's WebCompositionUnderline class and should be kept in +/// sync with that. /// struct cef_composition_underline_t { /// - // Underline character range. + /// Underline character range. /// cef_range_t range; /// - // Text color. + /// Text color. /// cef_color_t color; /// - // Background color. + /// Background color. /// cef_color_t background_color; /// - // Set to true (1) for thick underline. + /// Set to true (1) for thick underline. /// int thick; /// - // Style. + /// Style. /// cef_composition_underline_style_t style; } @@ -4941,134 +5055,141 @@ struct cef_composition_underline_t /// -// Enumerates the various representations of the ordering of audio channels. -// Must be kept synchronized with media::ChannelLayout from Chromium. -// See media\base\channel_layout.h +/// Enumerates the various representations of the ordering of audio channels. +/// Must be kept synchronized with media::ChannelLayout from Chromium. +/// See media\base\channel_layout.h /// enum cef_channel_layout_t { CEF_CHANNEL_LAYOUT_NONE = 0, CEF_CHANNEL_LAYOUT_UNSUPPORTED = 1, - // Front C + /// Front C CEF_CHANNEL_LAYOUT_MONO = 2, - // Front L, Front R + /// Front L, Front R CEF_CHANNEL_LAYOUT_STEREO = 3, - // Front L, Front R, Back C + /// Front L, Front R, Back C CEF_CHANNEL_LAYOUT_2_1 = 4, - // Front L, Front R, Front C + /// Front L, Front R, Front C CEF_CHANNEL_LAYOUT_SURROUND = 5, - // Front L, Front R, Front C, Back C + /// Front L, Front R, Front C, Back C CEF_CHANNEL_LAYOUT_4_0 = 6, - // Front L, Front R, Side L, Side R + /// Front L, Front R, Side L, Side R CEF_CHANNEL_LAYOUT_2_2 = 7, - // Front L, Front R, Back L, Back R + /// Front L, Front R, Back L, Back R CEF_CHANNEL_LAYOUT_QUAD = 8, - // Front L, Front R, Front C, Side L, Side R + /// Front L, Front R, Front C, Side L, Side R CEF_CHANNEL_LAYOUT_5_0 = 9, - // Front L, Front R, Front C, LFE, Side L, Side R + /// Front L, Front R, Front C, LFE, Side L, Side R CEF_CHANNEL_LAYOUT_5_1 = 10, - // Front L, Front R, Front C, Back L, Back R + /// Front L, Front R, Front C, Back L, Back R CEF_CHANNEL_LAYOUT_5_0_BACK = 11, - // Front L, Front R, Front C, LFE, Back L, Back R + /// Front L, Front R, Front C, LFE, Back L, Back R CEF_CHANNEL_LAYOUT_5_1_BACK = 12, - // Front L, Front R, Front C, Side L, Side R, Back L, Back R + /// Front L, Front R, Front C, Side L, Side R, Back L, Back R CEF_CHANNEL_LAYOUT_7_0 = 13, - // Front L, Front R, Front C, LFE, Side L, Side R, Back L, Back R + /// Front L, Front R, Front C, LFE, Side L, Side R, Back L, Back R CEF_CHANNEL_LAYOUT_7_1 = 14, - // Front L, Front R, Front C, LFE, Side L, Side R, Front LofC, Front RofC + /// Front L, Front R, Front C, LFE, Side L, Side R, Front LofC, Front RofC CEF_CHANNEL_LAYOUT_7_1_WIDE = 15, - // Stereo L, Stereo R + /// Stereo L, Stereo R CEF_CHANNEL_LAYOUT_STEREO_DOWNMIX = 16, - // Stereo L, Stereo R, LFE + /// Stereo L, Stereo R, LFE CEF_CHANNEL_LAYOUT_2POINT1 = 17, - // Stereo L, Stereo R, Front C, LFE + /// Stereo L, Stereo R, Front C, LFE CEF_CHANNEL_LAYOUT_3_1 = 18, - // Stereo L, Stereo R, Front C, Rear C, LFE + /// Stereo L, Stereo R, Front C, Rear C, LFE CEF_CHANNEL_LAYOUT_4_1 = 19, - // Stereo L, Stereo R, Front C, Side L, Side R, Back C + /// Stereo L, Stereo R, Front C, Side L, Side R, Back C CEF_CHANNEL_LAYOUT_6_0 = 20, - // Stereo L, Stereo R, Side L, Side R, Front LofC, Front RofC + /// Stereo L, Stereo R, Side L, Side R, Front LofC, Front RofC CEF_CHANNEL_LAYOUT_6_0_FRONT = 21, - // Stereo L, Stereo R, Front C, Rear L, Rear R, Rear C + /// Stereo L, Stereo R, Front C, Rear L, Rear R, Rear C CEF_CHANNEL_LAYOUT_HEXAGONAL = 22, - // Stereo L, Stereo R, Front C, LFE, Side L, Side R, Rear Center + /// Stereo L, Stereo R, Front C, LFE, Side L, Side R, Rear Center CEF_CHANNEL_LAYOUT_6_1 = 23, - // Stereo L, Stereo R, Front C, LFE, Back L, Back R, Rear Center + /// Stereo L, Stereo R, Front C, LFE, Back L, Back R, Rear Center CEF_CHANNEL_LAYOUT_6_1_BACK = 24, - // Stereo L, Stereo R, Side L, Side R, Front LofC, Front RofC, LFE + /// Stereo L, Stereo R, Side L, Side R, Front LofC, Front RofC, LFE CEF_CHANNEL_LAYOUT_6_1_FRONT = 25, - // Front L, Front R, Front C, Side L, Side R, Front LofC, Front RofC + /// Front L, Front R, Front C, Side L, Side R, Front LofC, Front RofC CEF_CHANNEL_LAYOUT_7_0_FRONT = 26, - // Front L, Front R, Front C, LFE, Back L, Back R, Front LofC, Front RofC + /// Front L, Front R, Front C, LFE, Back L, Back R, Front LofC, Front RofC CEF_CHANNEL_LAYOUT_7_1_WIDE_BACK = 27, - // Front L, Front R, Front C, Side L, Side R, Rear L, Back R, Back C. + /// Front L, Front R, Front C, Side L, Side R, Rear L, Back R, Back C. CEF_CHANNEL_LAYOUT_OCTAGONAL = 28, - // Channels are not explicitly mapped to speakers. + /// Channels are not explicitly mapped to speakers. CEF_CHANNEL_LAYOUT_DISCRETE = 29, - // Front L, Front R, Front C. Front C contains the keyboard mic audio. This - // layout is only intended for input for WebRTC. The Front C channel - // is stripped away in the WebRTC audio input pipeline and never seen outside - // of that. + /// Front L, Front R, Front C. Front C contains the keyboard mic audio. This + /// layout is only intended for input for WebRTC. The Front C channel + /// is stripped away in the WebRTC audio input pipeline and never seen outside + /// of that. CEF_CHANNEL_LAYOUT_STEREO_AND_KEYBOARD_MIC = 30, - // Front L, Front R, Side L, Side R, LFE + /// Front L, Front R, Side L, Side R, LFE CEF_CHANNEL_LAYOUT_4_1_QUAD_SIDE = 31, - // Actual channel layout is specified in the bitstream and the actual channel - // count is unknown at Chromium media pipeline level (useful for audio - // pass-through mode). + /// Actual channel layout is specified in the bitstream and the actual channel + /// count is unknown at Chromium media pipeline level (useful for audio + /// pass-through mode). CEF_CHANNEL_LAYOUT_BITSTREAM = 32, - // Max value, must always equal the largest entry ever logged. - CEF_CHANNEL_LAYOUT_MAX = CEF_CHANNEL_LAYOUT_BITSTREAM + /// Front L, Front R, Front C, LFE, Side L, Side R, + /// Front Height L, Front Height R, Rear Height L, Rear Height R + /// Will be represented as six channels (5.1) due to eight channel limit + /// kMaxConcurrentChannels + CEF_CHANNEL_LAYOUT_5_1_4_DOWNMIX = 33, + + /// Max value, must always equal the largest entry ever logged. + CEF_CHANNEL_LAYOUT_MAX = CEF_CHANNEL_LAYOUT_5_1_4_DOWNMIX } /// -// Structure representing the audio parameters for setting up the audio handler. +/// Structure representing the audio parameters for setting up the audio +/// handler. /// struct cef_audio_parameters_t { /// - // Layout of the audio channels + /// Layout of the audio channels /// cef_channel_layout_t channel_layout; /// - // Sample rate + /// Sample rate // int sample_rate; /// - // Number of frames per buffer + /// Number of frames per buffer /// int frames_per_buffer; } @@ -5076,8 +5197,8 @@ struct cef_audio_parameters_t /// -// Result codes for CefMediaRouter::CreateRoute. Should be kept in sync with -// Chromium's media_router::RouteRequestResult::ResultCode type. +/// Result codes for CefMediaRouter::CreateRoute. Should be kept in sync with +/// Chromium's media_router::mojom::RouteRequestResultCode type. /// enum cef_media_route_create_result_t { @@ -5090,13 +5211,11 @@ enum cef_media_route_create_result_t CEF_MRCR_NO_SUPPORTED_PROVIDER = 7, CEF_MRCR_CANCELLED = 8, CEF_MRCR_ROUTE_ALREADY_EXISTS = 9, - CEF_MRCR_ROUTE_ALREADY_TERMINATED = 11, - - CEF_MRCR_TOTAL_COUNT = 12 // The total number of values. + CEF_MRCR_ROUTE_ALREADY_TERMINATED = 11 } /// -// Connection state for a MediaRoute object. +/// Connection state for a MediaRoute object. /// enum cef_media_route_connection_state_t { @@ -5108,8 +5227,8 @@ enum cef_media_route_connection_state_t } /// -// Icon types for a MediaSink object. Should be kept in sync with Chromium's -// media_router::SinkIconType type. +/// Icon types for a MediaSink object. Should be kept in sync with Chromium's +/// media_router::SinkIconType type. /// enum cef_media_sink_icon_type_t { @@ -5126,7 +5245,7 @@ enum cef_media_sink_icon_type_t } /// -// Device information for a MediaSink object. +/// Device information for a MediaSink object. /// struct cef_media_sink_device_info_t { @@ -5138,7 +5257,7 @@ struct cef_media_sink_device_info_t /// -// Represents commands available to TextField. +/// Represents commands available to TextField. /// enum cef_text_field_commands_t { @@ -5151,7 +5270,7 @@ enum cef_text_field_commands_t } /// -// Supported Chrome toolbar types. +/// Supported Chrome toolbar types. /// enum cef_chrome_toolbar_type_t { @@ -5161,7 +5280,7 @@ enum cef_chrome_toolbar_type_t } /// -// Docking modes supported by CefWindow::AddOverlay. +/// Docking modes supported by CefWindow::AddOverlay. /// enum cef_docking_mode_t { @@ -5173,7 +5292,7 @@ enum cef_docking_mode_t } /// -// Show states supported by CefWindowDelegate::GetInitialShowState. +/// Show states supported by CefWindowDelegate::GetInitialShowState. /// enum cef_show_state_t { @@ -5183,8 +5302,165 @@ enum cef_show_state_t CEF_SHOW_STATE_FULLSCREEN = 4 } +/// +/// Values indicating what state of the touch handle is set. +/// +enum cef_touch_handle_state_flags_t +{ + CEF_THS_FLAG_NONE = 0, + CEF_THS_FLAG_ENABLED = 1 << 0, + CEF_THS_FLAG_ORIENTATION = 1 << 1, + CEF_THS_FLAG_ORIGIN = 1 << 2, + CEF_THS_FLAG_ALPHA = 1 << 3 +} + +struct cef_touch_handle_state_t +{ + /// + /// Touch handle id. Increments for each new touch handle. + /// + int touch_handle_id; + + /// + /// Combination of cef_touch_handle_state_flags_t values indicating what state + /// is set. + /// + uint32 flags; + + /// + /// Enabled state. Only set if |flags| contains CEF_THS_FLAG_ENABLED. + /// + int enabled; + + /// + /// Orientation state. Only set if |flags| contains CEF_THS_FLAG_ORIENTATION. + /// + cef_horizontal_alignment_t orientation; + int mirror_vertical; + int mirror_horizontal; + + /// + /// Origin state. Only set if |flags| contains CEF_THS_FLAG_ORIGIN. + /// + cef_point_t origin; + + /// + /// Alpha state. Only set if |flags| contains CEF_THS_FLAG_ALPHA. + /// + float alpha; +} + + + +/// +/// Media access permissions used by OnRequestMediaAccessPermission. +/// +enum cef_media_access_permission_types_t +{ + /// + /// No permission. + /// + CEF_MEDIA_PERMISSION_NONE = 0, + + /// + /// Device audio capture permission. + /// + CEF_MEDIA_PERMISSION_DEVICE_AUDIO_CAPTURE = 1 << 0, + + /// + /// Device video capture permission. + /// + CEF_MEDIA_PERMISSION_DEVICE_VIDEO_CAPTURE = 1 << 1, + + /// + /// Desktop audio capture permission. + /// + CEF_MEDIA_PERMISSION_DESKTOP_AUDIO_CAPTURE = 1 << 2, + + /// + /// Desktop video capture permission. + /// + CEF_MEDIA_PERMISSION_DESKTOP_VIDEO_CAPTURE = 1 << 3 +} + +/// +/// Permission types used with OnShowPermissionPrompt. Some types are +/// platform-specific or only supported with the Chrome runtime. Should be kept +/// in sync with Chromium's permissions::RequestType type. +/// +enum cef_permission_request_types_t +{ + CEF_PERMISSION_TYPE_NONE = 0, + CEF_PERMISSION_TYPE_ACCESSIBILITY_EVENTS = 1 << 0, + CEF_PERMISSION_TYPE_AR_SESSION = 1 << 1, + CEF_PERMISSION_TYPE_CAMERA_PAN_TILT_ZOOM = 1 << 2, + CEF_PERMISSION_TYPE_CAMERA_STREAM = 1 << 3, + CEF_PERMISSION_TYPE_CLIPBOARD = 1 << 4, + CEF_PERMISSION_TYPE_DISK_QUOTA = 1 << 5, + CEF_PERMISSION_TYPE_LOCAL_FONTS = 1 << 6, + CEF_PERMISSION_TYPE_GEOLOCATION = 1 << 7, + CEF_PERMISSION_TYPE_IDLE_DETECTION = 1 << 8, + CEF_PERMISSION_TYPE_MIC_STREAM = 1 << 9, + CEF_PERMISSION_TYPE_MIDI_SYSEX = 1 << 10, + CEF_PERMISSION_TYPE_MULTIPLE_DOWNLOADS = 1 << 11, + CEF_PERMISSION_TYPE_NOTIFICATIONS = 1 << 12, + CEF_PERMISSION_TYPE_PROTECTED_MEDIA_IDENTIFIER = 1 << 13, + CEF_PERMISSION_TYPE_REGISTER_PROTOCOL_HANDLER = 1 << 14, + CEF_PERMISSION_TYPE_SECURITY_ATTESTATION = 1 << 15, + CEF_PERMISSION_TYPE_STORAGE_ACCESS = 1 << 16, + CEF_PERMISSION_TYPE_U2F_API_REQUEST = 1 << 17, + CEF_PERMISSION_TYPE_VR_SESSION = 1 << 18, + CEF_PERMISSION_TYPE_WINDOW_PLACEMENT = 1 << 19 +} + +/// +/// Permission request results. +/// +enum cef_permission_request_result_t +{ + /// + /// Accept the permission request as an explicit user action. + /// + CEF_PERMISSION_RESULT_ACCEPT = 0, + + /// + /// Deny the permission request as an explicit user action. + /// + CEF_PERMISSION_RESULT_DENY = 1, + + /// + /// Dismiss the permission request as an explicit user action. + /// + CEF_PERMISSION_RESULT_DISMISS = 2, + + /// + /// Ignore the permission request. If the prompt remains unhandled (e.g. + /// OnShowPermissionPrompt returns false and there is no default permissions + /// UI) then any related promises may remain unresolved. + /// + CEF_PERMISSION_RESULT_IGNORE = 3 +} + +/// +/// Certificate types supported by CefTestServer::CreateAndStart. The matching +/// certificate file must exist in the "net/data/ssl/certificates" directory. +/// See CefSetDataDirectoryForTests() for related configuration. +/// +enum cef_test_cert_type_t +{ + /// Valid certificate using the IP (127.0.0.1). Loads the "ok_cert.pem" file. + CEF_TEST_CERT_OK_IP = 0, + + /// Valid certificate using the domain ("localhost"). Loads the + /// "localhost_cert.pem" file. + CEF_TEST_CERT_OK_DOMAIN = 1, + + /// Expired certificate. Loads the "expired_cert.pem" file. + CEF_TEST_CERT_EXPIRED = 2 +} + // CEF_INCLUDE_INTERNAL_CEF_TYPES_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -5219,34 +5495,34 @@ enum cef_show_state_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=c487e5fd787b1be8224a8981839e0cfdd0ed74f3$ +// $hash=6bdc0ce413420b45510fcc7f415c6a6fb05f0112$ // extern (C): /// -// Implement this structure to receive accessibility notification when -// accessibility events have been registered. The functions of this structure -// will be called on the UI thread. +/// Implement this structure to receive accessibility notification when +/// accessibility events have been registered. The functions of this structure +/// will be called on the UI thread. /// struct cef_accessibility_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Called after renderer process sends accessibility tree changes to the - // browser process. + /// Called after renderer process sends accessibility tree changes to the + /// browser process. /// extern(System) void function ( cef_accessibility_handler_t* self, cef_value_t* value) nothrow on_accessibility_tree_change; /// - // Called after renderer process sends accessibility location changes to the - // browser process. + /// Called after renderer process sends accessibility location changes to the + /// browser process. /// extern(System) void function ( cef_accessibility_handler_t* self, @@ -5256,7 +5532,7 @@ struct cef_accessibility_handler_t // CEF_INCLUDE_CAPI_CEF_ACCESSIBILITY_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -5291,32 +5567,33 @@ struct cef_accessibility_handler_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=a4b63e6e7942e3a3961b4f7141a963980178ae6f$ +// $hash=7c6894aae3e508aaa42a376532328316d9bd509c$ // extern (C): /// -// Implement this structure to provide handler implementations. Methods will be -// called by the process and/or thread indicated. +/// Implement this structure to provide handler implementations. Methods will be +/// called by the process and/or thread indicated. /// struct cef_app_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Provides an opportunity to view and/or modify command-line arguments before - // processing by CEF and Chromium. The |process_type| value will be NULL for - // the browser process. Do not keep a reference to the cef_command_line_t - // object passed to this function. The CefSettings.command_line_args_disabled - // value can be used to start with an NULL command-line object. Any values - // specified in CefSettings that equate to command-line arguments will be set - // before this function is called. Be cautious when using this function to - // modify command-line arguments for non-browser processes as this may result - // in undefined behavior including crashes. + /// Provides an opportunity to view and/or modify command-line arguments + /// before processing by CEF and Chromium. The |process_type| value will be + /// NULL for the browser process. Do not keep a reference to the + /// cef_command_line_t object passed to this function. The + /// cef_settings_t.command_line_args_disabled value can be used to start with + /// an NULL command-line object. Any values specified in CefSettings that + /// equate to command-line arguments will be set before this function is + /// called. Be cautious when using this function to modify command-line + /// arguments for non-browser processes as this may result in undefined + /// behavior including crashes. /// extern(System) void function ( cef_app_t* self, @@ -5324,34 +5601,35 @@ struct cef_app_t cef_command_line_t* command_line) nothrow on_before_command_line_processing; /// - // Provides an opportunity to register custom schemes. Do not keep a reference - // to the |registrar| object. This function is called on the main thread for - // each process and the registered schemes should be the same across all - // processes. + /// Provides an opportunity to register custom schemes. Do not keep a + /// reference to the |registrar| object. This function is called on the main + /// thread for each process and the registered schemes should be the same + /// across all processes. /// extern(System) void function ( cef_app_t* self, cef_scheme_registrar_t* registrar) nothrow on_register_custom_schemes; /// - // Return the handler for resource bundle events. If - // CefSettings.pack_loading_disabled is true (1) a handler must be returned. - // If no handler is returned resources will be loaded from pack files. This - // function is called by the browser and render processes on multiple threads. + /// Return the handler for resource bundle events. If + /// cef_settings_t.pack_loading_disabled is true (1) a handler must be + /// returned. If no handler is returned resources will be loaded from pack + /// files. This function is called by the browser and render processes on + /// multiple threads. /// extern(System) cef_resource_bundle_handler_t* function ( cef_app_t* self) nothrow get_resource_bundle_handler; /// - // Return the handler for functionality specific to the browser process. This - // function is called on multiple threads in the browser process. + /// Return the handler for functionality specific to the browser process. This + /// function is called on multiple threads in the browser process. /// extern(System) cef_browser_process_handler_t* function ( cef_app_t* self) nothrow get_browser_process_handler; /// - // Return the handler for functionality specific to the render process. This - // function is called on the render process main thread. + /// Return the handler for functionality specific to the render process. This + /// function is called on the render process main thread. /// extern(System) cef_render_process_handler_t* function ( cef_app_t* self) nothrow get_render_process_handler; @@ -5360,16 +5638,16 @@ struct cef_app_t /// -// 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 CefSettings.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 NULL. 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 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 NULL. The +/// |windows_sandbox_info| parameter is only used on Windows and may be NULL +/// (see cef_sandbox_win.h for details). /// int cef_execute_process ( const(cef_main_args_t)* args, @@ -5377,11 +5655,11 @@ int cef_execute_process ( void* windows_sandbox_info); /// -// This function should be called on the main application thread to initialize -// the CEF browser process. The |application| parameter may be NULL. A return -// value of true (1) indicates that it succeeded and false (0) indicates that it -// failed. 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 NULL. A return +/// value of true (1) indicates that it succeeded and false (0) indicates that +/// it failed. The |windows_sandbox_info| parameter is only used on Windows and +/// may be NULL (see cef_sandbox_win.h for details). /// int cef_initialize ( const(cef_main_args_t)* args, @@ -5390,60 +5668,60 @@ int cef_initialize ( void* windows_sandbox_info); /// -// This function should be called on the main application thread to shut down -// the CEF browser process before the application exits. +/// This function should be called on the main application thread to shut down +/// the CEF browser process before the application exits. /// void cef_shutdown (); /// -// 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 cef_run_message_loop() function or -// CefSettings.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 CefSettings.external_message_pump option when using -// this function so that -// cef_browser_process_handler_t::on_schedule_message_pump_work() callbacks can -// facilitate the scheduling process. This function should only be called on the -// main application thread and only if cef_initialize() is called with a -// CefSettings.multi_threaded_message_loop value of false (0). This function -// will not block. +/// 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 cef_run_message_loop() 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 +/// cef_browser_process_handler_t::on_schedule_message_pump_work() callbacks can +/// facilitate the scheduling process. This function should only be called on +/// the main application thread and only if cef_initialize() is called with a +/// cef_settings_t.multi_threaded_message_loop value of false (0). This function +/// will not block. /// void cef_do_message_loop_work (); /// -// 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 cef_initialize() is called with a -// CefSettings.multi_threaded_message_loop value of false (0). This function -// will block until a quit message is received by the system. +/// 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 cef_initialize() is called with a +/// cef_settings_t.multi_threaded_message_loop value of false (0). This function +/// will block until a quit message is received by the system. /// void cef_run_message_loop (); /// -// Quit the CEF message loop that was started by calling cef_run_message_loop(). -// This function should only be called on the main application thread and only -// if cef_run_message_loop() was used. +/// Quit the CEF message loop that was started by calling +/// cef_run_message_loop(). This function should only be called on the main +/// application thread and only if cef_run_message_loop() was used. /// void cef_quit_message_loop (); /// -// Set to true (1) before calling Windows APIs like TrackPopupMenu that enter a -// modal message loop. Set to false (0) after exiting the modal message loop. +/// Set to true (1) before calling Windows APIs like TrackPopupMenu that enter a +/// modal message loop. Set to false (0) after exiting the modal message loop. /// void cef_set_osmodal_loop (int osModalLoop); /// -// Call during process startup to enable High-DPI support on Windows 7 or newer. -// Older versions of Windows should be left DPI-unaware because they do not -// support DirectWrite and GDI fonts are kerned very badly. +/// Call during process startup to enable High-DPI support on Windows 7 or +/// newer. Older versions of Windows should be left DPI-unaware because they do +/// not support DirectWrite and GDI fonts are kerned very badly. /// void cef_enable_highdpi_support (); // CEF_INCLUDE_CAPI_CEF_APP_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -5478,26 +5756,26 @@ void cef_enable_highdpi_support (); // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=7a483ed552ecca4f1aaa03800d366beca1ea2dee$ +// $hash=4e243df31e29bc6e473d56e371ed6328d948959c$ // extern (C): /// -// Implement this structure to handle audio events. +/// Implement this structure to handle audio events. /// struct cef_audio_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Called on the UI thread to allow configuration of audio stream parameters. - // Return true (1) to proceed with audio stream capture, or false (0) to - // cancel it. All members of |params| can optionally be configured here, but - // they are also pre-filled with some sensible defaults. + /// Called on the UI thread to allow configuration of audio stream parameters. + /// Return true (1) to proceed with audio stream capture, or false (0) to + /// cancel it. All members of |params| can optionally be configured here, but + /// they are also pre-filled with some sensible defaults. /// extern(System) int function ( cef_audio_handler_t* self, @@ -5505,11 +5783,11 @@ struct cef_audio_handler_t cef_audio_parameters_t* params) nothrow get_audio_parameters; /// - // Called on a browser audio capture thread when the browser starts streaming - // audio. OnAudioSteamStopped will always be called after - // OnAudioStreamStarted; both functions 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 a browser audio capture thread when the browser starts streaming + /// audio. OnAudioStreamStopped will always be called after + /// OnAudioStreamStarted; both functions 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. /// extern(System) void function ( cef_audio_handler_t* self, @@ -5518,14 +5796,14 @@ struct cef_audio_handler_t int channels) nothrow on_audio_stream_started; /// - // 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 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. /// extern(System) void function ( cef_audio_handler_t* self, @@ -5535,19 +5813,19 @@ struct cef_audio_handler_t int64 pts) nothrow on_audio_stream_packet; /// - // Called on the UI thread when the stream has stopped. OnAudioSteamStopped - // will always be called after OnAudioStreamStarted; both functions may be - // called multiple times for the same stream. + /// Called on the UI thread when the stream has stopped. OnAudioSteamStopped + /// will always be called after OnAudioStreamStarted; both functions may be + /// called multiple times for the same stream. /// extern(System) void function ( cef_audio_handler_t* self, cef_browser_t* browser) nothrow on_audio_stream_stopped; /// - // 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. + /// 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. /// extern(System) void function ( cef_audio_handler_t* self, @@ -5558,7 +5836,7 @@ struct cef_audio_handler_t // CEF_INCLUDE_CAPI_CEF_AUDIO_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -5593,24 +5871,24 @@ struct cef_audio_handler_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=2b9508a328ed0218e2c576af455f8d76e5978545$ +// $hash=c0704c0a87e8b57b20887be75700a30e887fee4f$ // extern (C): /// -// Callback structure used for asynchronous continuation of authentication -// requests. +/// Callback structure used for asynchronous continuation of authentication +/// requests. /// struct cef_auth_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Continue the authentication request. + /// Continue the authentication request. /// extern(System) void function ( cef_auth_callback_t* self, @@ -5618,7 +5896,7 @@ struct cef_auth_callback_t const(cef_string_t)* password) nothrow cont; /// - // Cancel the authentication request. + /// Cancel the authentication request. /// extern(System) void function (cef_auth_callback_t* self) nothrow cancel; } @@ -5718,7 +5996,7 @@ struct cef_base_scoped_t // CEF_INCLUDE_CAPI_CEF_BASE_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -5753,7 +6031,7 @@ struct cef_base_scoped_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=b83b96e2b90124bba8084e2df7f66cc6749df872$ +// $hash=f8a604f73a04bec535d72ec7d05906da8c953b6b$ // import core.stdc.config; @@ -5763,129 +6041,129 @@ extern (C): /// -// Structure used to represent a browser. When used in the browser process the -// functions of this structure may be called on any thread unless otherwise -// indicated in the comments. When used in the render process the functions of -// this structure may only be called on the main thread. +/// Structure used to represent a browser. When used in the browser process the +/// functions of this structure may be called on any thread unless otherwise +/// indicated in the comments. When used in the render process the functions of +/// this structure may only be called on the main thread. /// struct cef_browser_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // True if this object is currently valid. This will return false (0) after - // cef_life_span_handler_t::OnBeforeClose is called. + /// True if this object is currently valid. This will return false (0) after + /// cef_life_span_handler_t::OnBeforeClose is called. /// extern(System) int function (cef_browser_t* self) nothrow is_valid; /// - // Returns the browser host object. This function can only be called in the - // browser process. + /// Returns the browser host object. This function can only be called in the + /// browser process. /// extern(System) cef_browser_host_t* function (cef_browser_t* self) nothrow get_host; /// - // Returns true (1) if the browser can navigate backwards. + /// Returns true (1) if the browser can navigate backwards. /// extern(System) int function (cef_browser_t* self) nothrow can_go_back; /// - // Navigate backwards. + /// Navigate backwards. /// extern(System) void function (cef_browser_t* self) nothrow go_back; /// - // Returns true (1) if the browser can navigate forwards. + /// Returns true (1) if the browser can navigate forwards. /// extern(System) int function (cef_browser_t* self) nothrow can_go_forward; /// - // Navigate forwards. + /// Navigate forwards. /// extern(System) void function (cef_browser_t* self) nothrow go_forward; /// - // Returns true (1) if the browser is currently loading. + /// Returns true (1) if the browser is currently loading. /// extern(System) int function (cef_browser_t* self) nothrow is_loading; /// - // Reload the current page. + /// Reload the current page. /// extern(System) void function (cef_browser_t* self) nothrow reload; /// - // Reload the current page ignoring any cached data. + /// Reload the current page ignoring any cached data. /// extern(System) void function (cef_browser_t* self) nothrow reload_ignore_cache; /// - // Stop loading the page. + /// Stop loading the page. /// extern(System) void function (cef_browser_t* self) nothrow stop_load; /// - // Returns the globally unique identifier for this browser. This value is also - // used as the tabId for extension APIs. + /// Returns the globally unique identifier for this browser. This value is + /// also used as the tabId for extension APIs. /// extern(System) int function (cef_browser_t* self) nothrow get_identifier; /// - // Returns true (1) if this object is pointing to the same handle as |that| - // object. + /// Returns true (1) if this object is pointing to the same handle as |that| + /// object. /// extern(System) int function (cef_browser_t* self, cef_browser_t* that) nothrow is_same; /// - // Returns true (1) if the browser is a popup. + /// Returns true (1) if the browser is a popup. /// extern(System) int function (cef_browser_t* self) nothrow is_popup; /// - // Returns true (1) if a document has been loaded in the browser. + /// Returns true (1) if a document has been loaded in the browser. /// extern(System) int function (cef_browser_t* self) nothrow has_document; /// - // Returns the main (top-level) frame for the browser. In the browser process - // this will return a valid object until after - // cef_life_span_handler_t::OnBeforeClose is called. In the renderer process - // this will return NULL if the main frame is hosted in a different renderer - // process (e.g. for cross-origin sub-frames). The main frame object will - // change during cross-origin navigation or re-navigation after renderer - // process termination (due to crashes, etc). + /// Returns the main (top-level) frame for the browser. In the browser process + /// this will return a valid object until after + /// cef_life_span_handler_t::OnBeforeClose is called. In the renderer process + /// this will return NULL if the main frame is hosted in a different renderer + /// process (e.g. for cross-origin sub-frames). The main frame object will + /// change during cross-origin navigation or re-navigation after renderer + /// process termination (due to crashes, etc). /// extern(System) cef_frame_t* function (cef_browser_t* self) nothrow get_main_frame; /// - // Returns the focused frame for the browser. + /// Returns the focused frame for the browser. /// extern(System) cef_frame_t* function (cef_browser_t* self) nothrow get_focused_frame; /// - // Returns the frame with the specified identifier, or NULL if not found. + /// Returns the frame with the specified identifier, or NULL if not found. /// extern(System) cef_frame_t* function ( cef_browser_t* self, int64 identifier) nothrow get_frame_byident; /// - // Returns the frame with the specified name, or NULL if not found. + /// Returns the frame with the specified name, or NULL if not found. /// extern(System) cef_frame_t* function ( cef_browser_t* self, const(cef_string_t)* name) nothrow get_frame; /// - // Returns the number of frames that currently exist. + /// Returns the number of frames that currently exist. /// extern(System) size_t function (cef_browser_t* self) nothrow get_frame_count; /// - // Returns the identifiers of all existing frames. + /// Returns the identifiers of all existing frames. /// extern(System) void function ( cef_browser_t* self, @@ -5893,7 +6171,7 @@ struct cef_browser_t int64* identifiers) nothrow get_frame_identifiers; /// - // Returns the names of all existing frames. + /// Returns the names of all existing frames. /// extern(System) void function ( cef_browser_t* self, @@ -5903,48 +6181,45 @@ struct cef_browser_t /// -// Callback structure for cef_browser_host_t::RunFileDialog. The functions of -// this structure will be called on the browser process UI thread. +/// Callback structure for cef_browser_host_t::RunFileDialog. The functions of +/// this structure will be called on the browser process UI thread. /// struct cef_run_file_dialog_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Called asynchronously after the file dialog is dismissed. - // |selected_accept_filter| is the 0-based index of the value selected from - // the accept filters array passed to cef_browser_host_t::RunFileDialog. - // |file_paths| will be a single value or a list of values depending on the - // dialog mode. If the selection was cancelled |file_paths| will be NULL. + /// Called asynchronously after the file dialog is dismissed. |file_paths| + /// will be a single value or a list of values depending on the dialog mode. + /// If the selection was cancelled |file_paths| will be NULL. /// extern(System) void function ( cef_run_file_dialog_callback_t* self, - int selected_accept_filter, cef_string_list_t file_paths) nothrow on_file_dialog_dismissed; } /// -// Callback structure for cef_browser_host_t::GetNavigationEntries. The -// functions of this structure will be called on the browser process UI thread. +/// Callback structure for cef_browser_host_t::GetNavigationEntries. The +/// functions of this structure will be called on the browser process UI thread. /// struct cef_navigation_entry_visitor_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be executed. Do not keep a reference to |entry| outside of - // this callback. Return true (1) to continue visiting entries or false (0) to - // stop. |current| is true (1) if this entry is the currently loaded - // navigation entry. |index| is the 0-based index of this entry and |total| is - // the total number of entries. + /// Method that will be executed. Do not keep a reference to |entry| outside + /// of this callback. Return true (1) to continue visiting entries or false + /// (0) to stop. |current| is true (1) if this entry is the currently loaded + /// navigation entry. |index| is the 0-based index of this entry and |total| + /// is the total number of entries. /// extern(System) int function ( cef_navigation_entry_visitor_t* self, @@ -5957,20 +6232,20 @@ struct cef_navigation_entry_visitor_t /// -// Callback structure for cef_browser_host_t::PrintToPDF. The functions of this -// structure will be called on the browser process UI thread. +/// Callback structure for cef_browser_host_t::PrintToPDF. The functions of this +/// structure will be called on the browser process UI thread. /// struct cef_pdf_print_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be executed when the PDF printing has completed. |path| is - // the output path. |ok| will be true (1) if the printing completed - // successfully or false (0) otherwise. + /// Method that will be executed when the PDF printing has completed. |path| + /// is the output path. |ok| will be true (1) if the printing completed + /// successfully or false (0) otherwise. /// extern(System) void function ( cef_pdf_print_callback_t* self, @@ -5981,21 +6256,21 @@ struct cef_pdf_print_callback_t /// -// Callback structure for cef_browser_host_t::DownloadImage. The functions of -// this structure will be called on the browser process UI thread. +/// Callback structure for cef_browser_host_t::DownloadImage. The functions of +/// this structure will be called on the browser process UI thread. /// struct cef_download_image_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be executed when the image download has completed. - // |image_url| is the URL that was downloaded and |http_status_code| is the - // resulting HTTP status code. |image| is the resulting image, possibly at - // multiple scale factors, or NULL if the download failed. + /// Method that will be executed when the image download has completed. + /// |image_url| is the URL that was downloaded and |http_status_code| is the + /// resulting HTTP status code. |image| is the resulting image, possibly at + /// multiple scale factors, or NULL if the download failed. /// extern(System) void function ( cef_download_image_callback_t* self, @@ -6007,111 +6282,111 @@ struct cef_download_image_callback_t /// -// Structure used to represent the browser process aspects of a browser. The -// functions of this structure can only be called in the browser process. They -// may be called on any thread in that process unless otherwise indicated in the -// comments. +/// Structure used to represent the browser process aspects of a browser. The +/// functions of this structure can only be called in the browser process. They +/// may be called on any thread in that process unless otherwise indicated in +/// the comments. /// struct cef_browser_host_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns the hosted browser object. + /// Returns the hosted browser object. /// extern(System) cef_browser_t* function (cef_browser_host_t* self) nothrow get_browser; /// - // Request that the browser close. The JavaScript 'onbeforeunload' event will - // be fired. If |force_close| is false (0) the event handler, if any, will be - // allowed to prompt the user and the user can optionally cancel the close. If - // |force_close| is true (1) the prompt will not be displayed and the close - // will proceed. Results in a call to cef_life_span_handler_t::do_close() if - // the event handler allows the close or if |force_close| is true (1). See - // cef_life_span_handler_t::do_close() documentation for additional usage - // information. + /// Request that the browser close. The JavaScript 'onbeforeunload' event will + /// be fired. If |force_close| is false (0) the event handler, if any, will be + /// allowed to prompt the user and the user can optionally cancel the close. + /// If |force_close| is true (1) the prompt will not be displayed and the + /// close will proceed. Results in a call to + /// cef_life_span_handler_t::do_close() if the event handler allows the close + /// or if |force_close| is true (1). See cef_life_span_handler_t::do_close() + /// documentation for additional usage information. /// extern(System) void function (cef_browser_host_t* self, int force_close) nothrow close_browser; /// - // Helper for closing a browser. Call this function from the top-level window - // close handler (if any). Internally this calls CloseBrowser(false (0)) if - // the close has not yet been initiated. This function returns false (0) while - // the close is pending and true (1) after the close has completed. See - // close_browser() and cef_life_span_handler_t::do_close() documentation for - // additional usage information. This function must be called on the browser - // process UI thread. + /// Helper for closing a browser. Call this function from the top-level window + /// close handler (if any). Internally this calls CloseBrowser(false (0)) if + /// the close has not yet been initiated. This function returns false (0) + /// while the close is pending and true (1) after the close has completed. See + /// close_browser() and cef_life_span_handler_t::do_close() documentation for + /// additional usage information. This function must be called on the browser + /// process UI thread. /// extern(System) int function (cef_browser_host_t* self) nothrow try_close_browser; /// - // Set whether the browser is focused. + /// Set whether the browser is focused. /// extern(System) void function (cef_browser_host_t* self, int focus) nothrow set_focus; /// - // Retrieve the window handle (if any) for this browser. If this browser is - // wrapped in a cef_browser_view_t this function should be called on the - // browser process UI thread and it will return the handle for the top-level - // native window. + /// Retrieve the window handle (if any) for this browser. If this browser is + /// wrapped in a cef_browser_view_t this function should be called on the + /// browser process UI thread and it will return the handle for the top-level + /// native window. /// extern(System) c_ulong function (cef_browser_host_t* self) nothrow get_window_handle; /// - // Retrieve the window handle (if any) of the browser that opened this - // browser. Will return NULL for non-popup browsers or if this browser is - // wrapped in a cef_browser_view_t. This function can be used in combination - // with custom handling of modal windows. + /// Retrieve the window handle (if any) of the browser that opened this + /// browser. Will return NULL for non-popup browsers or if this browser is + /// wrapped in a cef_browser_view_t. This function can be used in combination + /// with custom handling of modal windows. /// extern(System) c_ulong function (cef_browser_host_t* self) nothrow get_opener_window_handle; /// - // Returns true (1) if this browser is wrapped in a cef_browser_view_t. + /// Returns true (1) if this browser is wrapped in a cef_browser_view_t. /// extern(System) int function (cef_browser_host_t* self) nothrow has_view; /// - // Returns the client for this browser. + /// Returns the client for this browser. /// extern(System) cef_client_t* function (cef_browser_host_t* self) nothrow get_client; /// - // Returns the request context for this browser. + /// Returns the request context for this browser. /// extern(System) cef_request_context_t* function ( cef_browser_host_t* self) nothrow get_request_context; /// - // Get the current zoom level. The default zoom level is 0.0. This function - // can only be called on the UI thread. + /// Get the current zoom level. The default zoom level is 0.0. This function + /// can only be called on the UI thread. /// extern(System) double function (cef_browser_host_t* self) nothrow get_zoom_level; /// - // Change the zoom level to the specified value. Specify 0.0 to reset the zoom - // level. If called on the UI thread the change will be applied immediately. - // Otherwise, the change will be applied asynchronously on the UI thread. + /// Change the zoom level to the specified value. Specify 0.0 to reset the + /// zoom level. If called on the UI thread the change will be applied + /// immediately. Otherwise, the change will be applied asynchronously on the + /// UI thread. /// extern(System) void function (cef_browser_host_t* self, double zoomLevel) nothrow set_zoom_level; /// - // Call to run a file chooser dialog. Only a single file chooser dialog may be - // pending at any given time. |mode| represents the type of dialog to display. - // |title| to the title to be used for the dialog and may be NULL 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 will be - // initially selected in the dialog. |accept_filters| are used to restrict the - // selectable file types and may any combination of (a) valid lower-cased MIME - // types (e.g. "text/*" or "image/*"), (b) individual file extensions (e.g. - // ".txt" or ".png"), or (c) combined description and file extension delimited - // using "|" and ";" (e.g. "Image Types|.png;.gif;.jpg"). - // |selected_accept_filter| is the 0-based index of the filter that will be - // selected by default. |callback| will be executed after the dialog is - // dismissed or immediately if another dialog is already pending. The dialog - // will be initiated asynchronously on the UI thread. + /// Call to run a file chooser dialog. Only a single file chooser dialog may + /// be pending at any given time. |mode| represents the type of dialog to + /// display. |title| to the title to be used for the dialog and may be NULL 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 will be initially selected in the dialog. |accept_filters| + /// are used to restrict the selectable file types and may any combination of + /// (a) valid lower-cased MIME types (e.g. "text/*" or "image/*"), (b) + /// individual file extensions (e.g. ".txt" or ".png"), or (c) combined + /// description and file extension delimited using "|" and ";" (e.g. "Image + /// Types|.png;.gif;.jpg"). |callback| will be executed after the dialog is + /// dismissed or immediately if another dialog is already pending. The dialog + /// will be initiated asynchronously on the UI thread. /// extern(System) void function ( cef_browser_host_t* self, @@ -6119,27 +6394,26 @@ struct cef_browser_host_t const(cef_string_t)* title, const(cef_string_t)* default_file_path, cef_string_list_t accept_filters, - int selected_accept_filter, cef_run_file_dialog_callback_t* callback) nothrow run_file_dialog; /// - // Download the file at |url| using cef_download_handler_t. + /// Download the file at |url| using cef_download_handler_t. /// extern(System) void function ( cef_browser_host_t* self, const(cef_string_t)* url) nothrow start_download; /// - // Download |image_url| and execute |callback| on completion with the images - // received from the renderer. If |is_favicon| is true (1) then cookies are - // not sent and not accepted during download. Images with density independent - // pixel (DIP) sizes larger than |max_image_size| are filtered out from the - // image results. Versions of the image at different scale factors may be - // downloaded up to the maximum scale factor supported by the system. If there - // are no image results <= |max_image_size| then the smallest image is resized - // to |max_image_size| and is the only result. A |max_image_size| of 0 means - // unlimited. If |bypass_cache| is true (1) then |image_url| is requested from - // the server even if it is present in the browser cache. + /// Download |image_url| and execute |callback| on completion with the images + /// received from the renderer. If |is_favicon| is true (1) then cookies are + /// not sent and not accepted during download. Images with density independent + /// pixel (DIP) sizes larger than |max_image_size| are filtered out from the + /// image results. Versions of the image at different scale factors may be + /// downloaded up to the maximum scale factor supported by the system. If + /// there are no image results <= |max_image_size| then the smallest image is + /// resized to |max_image_size| and is the only result. A |max_image_size| of + /// 0 means unlimited. If |bypass_cache| is true (1) then |image_url| is + /// requested from the server even if it is present in the browser cache. /// extern(System) void function ( cef_browser_host_t* self, @@ -6150,15 +6424,15 @@ struct cef_browser_host_t cef_download_image_callback_t* callback) nothrow download_image; /// - // Print the current browser contents. + /// Print the current browser contents. /// extern(System) void function (cef_browser_host_t* self) nothrow print; /// - // Print the current browser contents to the PDF file specified by |path| and - // execute |callback| on completion. The caller is responsible for deleting - // |path| when done. For PDF printing to work on Linux you must implement the - // cef_print_handler_t::GetPdfPaperSize function. + /// Print the current browser contents to the PDF file specified by |path| and + /// execute |callback| on completion. The caller is responsible for deleting + /// |path| when done. For PDF printing to work on Linux you must implement the + /// cef_print_handler_t::GetPdfPaperSize function. /// extern(System) void function ( cef_browser_host_t* self, @@ -6167,37 +6441,34 @@ struct cef_browser_host_t cef_pdf_print_callback_t* callback) nothrow print_to_pdf; /// - // Search for |searchText|. |identifier| must be a unique ID and these IDs - // must strictly increase so that newer requests always have greater IDs than - // older requests. If |identifier| is zero or less than the previous ID value - // then it will be automatically assigned a new valid ID. |forward| indicates - // whether to search forward or backward within the page. |matchCase| - // indicates whether the search should be case-sensitive. |findNext| indicates - // whether this is the first request or a follow-up. The cef_find_handler_t - // instance, if any, returned via cef_client_t::GetFindHandler will be called - // to report find results. + /// Search for |searchText|. |forward| indicates whether to search forward or + /// backward within the page. |matchCase| indicates whether the search should + /// be case-sensitive. |findNext| indicates whether this is the first request + /// or a follow-up. The search will be restarted if |searchText| or + /// |matchCase| change. The search will be stopped if |searchText| is NULL. + /// The cef_find_handler_t instance, if any, returned via + /// cef_client_t::GetFindHandler will be called to report find results. /// extern(System) void function ( cef_browser_host_t* self, - int identifier, const(cef_string_t)* searchText, int forward, int matchCase, int findNext) nothrow find; /// - // Cancel all searches that are currently going on. + /// Cancel all searches that are currently going on. /// extern(System) void function (cef_browser_host_t* self, int clearSelection) nothrow stop_finding; /// - // Open developer tools (DevTools) in its own browser. The DevTools browser - // will remain associated with this browser. If the DevTools browser is - // already open then it will be focused, in which case the |windowInfo|, - // |client| and |settings| parameters will be ignored. If |inspect_element_at| - // is non-NULL then the element at the specified (x,y) location will be - // inspected. The |windowInfo| parameter will be ignored if this browser is - // wrapped in a cef_browser_view_t. + /// Open developer tools (DevTools) in its own browser. The DevTools browser + /// will remain associated with this browser. If the DevTools browser is + /// already open then it will be focused, in which case the |windowInfo|, + /// |client| and |settings| parameters will be ignored. If + /// |inspect_element_at| is non-NULL then the element at the specified (x,y) + /// location will be inspected. The |windowInfo| parameter will be ignored if + /// this browser is wrapped in a cef_browser_view_t. /// extern(System) void function ( cef_browser_host_t* self, @@ -6207,48 +6478,48 @@ struct cef_browser_host_t const(cef_point_t)* inspect_element_at) nothrow show_dev_tools; /// - // Explicitly close the associated DevTools browser, if any. + /// Explicitly close the associated DevTools browser, if any. /// extern(System) void function (cef_browser_host_t* self) nothrow close_dev_tools; /// - // Returns true (1) if this browser currently has an associated DevTools - // browser. Must be called on the browser process UI thread. + /// Returns true (1) if this browser currently has an associated DevTools + /// browser. Must be called on the browser process UI thread. /// extern(System) int function (cef_browser_host_t* self) nothrow has_dev_tools; /// - // Send a function call message over the DevTools protocol. |message| must be - // a UTF8-encoded JSON dictionary that contains "id" (int), "function" - // (string) and "params" (dictionary, optional) values. See the DevTools - // protocol documentation at https://chromedevtools.github.io/devtools- - // protocol/ for details of supported functions and the expected "params" - // dictionary contents. |message| will be copied if necessary. This function - // will return true (1) if called on the UI thread and the message was - // successfully submitted for validation, otherwise false (0). Validation will - // be applied asynchronously and any messages that fail due to formatting - // errors or missing parameters may be discarded without notification. Prefer - // ExecuteDevToolsMethod if a more structured approach to message formatting - // is desired. - // - // Every valid function call will result in an asynchronous function result or - // error message that references the sent message "id". Event messages are - // received while notifications are enabled (for example, between function - // calls for "Page.enable" and "Page.disable"). All received messages will be - // delivered to the observer(s) registered with AddDevToolsMessageObserver. - // See cef_dev_tools_message_observer_t::OnDevToolsMessage documentation for - // details of received message contents. - // - // Usage of the SendDevToolsMessage, ExecuteDevToolsMethod and - // AddDevToolsMessageObserver functions does not require an active DevTools - // front-end or remote-debugging session. Other active DevTools sessions will - // continue to function independently. However, any modification of global - // browser state by one session may not be reflected in the UI of other - // sessions. - // - // Communication with the DevTools front-end (when displayed) can be logged - // for development purposes by passing the `--devtools-protocol-log- - // file=` command-line flag. + /// Send a function call message over the DevTools protocol. |message| must be + /// a UTF8-encoded JSON dictionary that contains "id" (int), "function" + /// (string) and "params" (dictionary, optional) values. See the DevTools + /// protocol documentation at https://chromedevtools.github.io/devtools- + /// protocol/ for details of supported functions and the expected "params" + /// dictionary contents. |message| will be copied if necessary. This function + /// will return true (1) if called on the UI thread and the message was + /// successfully submitted for validation, otherwise false (0). Validation + /// will be applied asynchronously and any messages that fail due to + /// formatting errors or missing parameters may be discarded without + /// notification. Prefer ExecuteDevToolsMethod if a more structured approach + /// to message formatting is desired. + /// + /// Every valid function call will result in an asynchronous function result + /// or error message that references the sent message "id". Event messages are + /// received while notifications are enabled (for example, between function + /// calls for "Page.enable" and "Page.disable"). All received messages will be + /// delivered to the observer(s) registered with AddDevToolsMessageObserver. + /// See cef_dev_tools_message_observer_t::OnDevToolsMessage documentation for + /// details of received message contents. + /// + /// Usage of the SendDevToolsMessage, ExecuteDevToolsMethod and + /// AddDevToolsMessageObserver functions does not require an active DevTools + /// front-end or remote-debugging session. Other active DevTools sessions will + /// continue to function independently. However, any modification of global + /// browser state by one session may not be reflected in the UI of other + /// sessions. + /// + /// Communication with the DevTools front-end (when displayed) can be logged + /// for development purposes by passing the `--devtools-protocol-log- + /// file=` command-line flag. /// extern(System) int function ( cef_browser_host_t* self, @@ -6256,16 +6527,17 @@ struct cef_browser_host_t size_t message_size) nothrow send_dev_tools_message; /// - // Execute a function call over the DevTools protocol. This is a more - // structured version of SendDevToolsMessage. |message_id| is an incremental - // number that uniquely identifies the message (pass 0 to have the next number - // assigned automatically based on previous values). |function| is the - // function name. |params| are the function parameters, which may be NULL. See - // the DevTools protocol documentation (linked above) for details of supported - // functions and the expected |params| dictionary contents. This function will - // return the assigned message ID if called on the UI thread and the message - // was successfully submitted for validation, otherwise 0. See the - // SendDevToolsMessage documentation for additional usage information. + /// Execute a function call over the DevTools protocol. This is a more + /// structured version of SendDevToolsMessage. |message_id| is an incremental + /// number that uniquely identifies the message (pass 0 to have the next + /// number assigned automatically based on previous values). |function| is the + /// function name. |params| are the function parameters, which may be NULL. + /// See the DevTools protocol documentation (linked above) for details of + /// supported functions and the expected |params| dictionary contents. This + /// function will return the assigned message ID if called on the UI thread + /// and the message was successfully submitted for validation, otherwise 0. + /// See the SendDevToolsMessage documentation for additional usage + /// information. /// extern(System) int function ( cef_browser_host_t* self, @@ -6274,20 +6546,20 @@ struct cef_browser_host_t cef_dictionary_value_t* params) nothrow execute_dev_tools_method; /// - // Add an observer for DevTools protocol messages (function results and - // events). The observer will remain registered until the returned - // Registration object is destroyed. See the SendDevToolsMessage documentation - // for additional usage information. + /// Add an observer for DevTools protocol messages (function results and + /// events). The observer will remain registered until the returned + /// Registration object is destroyed. See the SendDevToolsMessage + /// documentation for additional usage information. /// extern(System) cef_registration_t* function ( cef_browser_host_t* self, cef_dev_tools_message_observer_t* observer) nothrow add_dev_tools_message_observer; /// - // Retrieve a snapshot of current navigation entries as values sent to the - // specified visitor. If |current_only| is true (1) only the current - // navigation entry will be sent, otherwise all navigation entries will be - // sent. + /// Retrieve a snapshot of current navigation entries as values sent to the + /// specified visitor. If |current_only| is true (1) only the current + /// navigation entry will be sent, otherwise all navigation entries will be + /// sent. /// extern(System) void function ( cef_browser_host_t* self, @@ -6295,75 +6567,75 @@ struct cef_browser_host_t int current_only) nothrow get_navigation_entries; /// - // If a misspelled word is currently selected in an editable node calling this - // function will replace it with the specified |word|. + /// If a misspelled word is currently selected in an editable node calling + /// this function will replace it with the specified |word|. /// extern(System) void function ( cef_browser_host_t* self, const(cef_string_t)* word) nothrow replace_misspelling; /// - // Add the specified |word| to the spelling dictionary. + /// Add the specified |word| to the spelling dictionary. /// extern(System) void function ( cef_browser_host_t* self, const(cef_string_t)* word) nothrow add_word_to_dictionary; /// - // Returns true (1) if window rendering is disabled. + /// Returns true (1) if window rendering is disabled. /// extern(System) int function (cef_browser_host_t* self) nothrow is_window_rendering_disabled; /// - // Notify the browser that the widget has been resized. The browser will first - // call cef_render_handler_t::GetViewRect to get the new size and then call - // cef_render_handler_t::OnPaint asynchronously with the updated regions. This - // function is only used when window rendering is disabled. + /// Notify the browser that the widget has been resized. The browser will + /// first call cef_render_handler_t::GetViewRect to get the new size and then + /// call cef_render_handler_t::OnPaint asynchronously with the updated + /// regions. This function is only used when window rendering is disabled. /// extern(System) void function (cef_browser_host_t* self) nothrow was_resized; /// - // Notify the browser that it has been hidden or shown. Layouting and - // cef_render_handler_t::OnPaint notification will stop when the browser is - // hidden. This function is only used when window rendering is disabled. + /// Notify the browser that it has been hidden or shown. Layouting and + /// cef_render_handler_t::OnPaint notification will stop when the browser is + /// hidden. This function is only used when window rendering is disabled. /// extern(System) void function (cef_browser_host_t* self, int hidden) nothrow was_hidden; /// - // Send a notification to the browser that the screen info has changed. The - // browser will then call cef_render_handler_t::GetScreenInfo to update the - // screen information with the new values. This simulates moving the webview - // window from one display to another, or changing the properties of the - // current display. This function is only used when window rendering is - // disabled. + /// Send a notification to the browser that the screen info has changed. The + /// browser will then call cef_render_handler_t::GetScreenInfo to update the + /// screen information with the new values. This simulates moving the webview + /// window from one display to another, or changing the properties of the + /// current display. This function is only used when window rendering is + /// disabled. /// extern(System) void function (cef_browser_host_t* self) nothrow notify_screen_info_changed; /// - // Invalidate the view. The browser will call cef_render_handler_t::OnPaint - // asynchronously. This function is only used when window rendering is - // disabled. + /// Invalidate the view. The browser will call cef_render_handler_t::OnPaint + /// asynchronously. This function is only used when window rendering is + /// disabled. /// extern(System) void function ( cef_browser_host_t* self, cef_paint_element_type_t type) nothrow invalidate; /// - // Issue a BeginFrame request to Chromium. Only valid when - // cef_window_tInfo::external_begin_frame_enabled is set to true (1). + /// Issue a BeginFrame request to Chromium. Only valid when + /// cef_window_tInfo::external_begin_frame_enabled is set to true (1). /// extern(System) void function (cef_browser_host_t* self) nothrow send_external_begin_frame; /// - // Send a key event to the browser. + /// Send a key event to the browser. /// extern(System) void function ( cef_browser_host_t* self, const(cef_key_event_t)* event) nothrow send_key_event; /// - // Send a mouse click event to the browser. The |x| and |y| coordinates are - // relative to the upper-left corner of the view. + /// Send a mouse click event to the browser. The |x| and |y| coordinates are + /// relative to the upper-left corner of the view. /// extern(System) void function ( cef_browser_host_t* self, @@ -6373,8 +6645,8 @@ struct cef_browser_host_t int clickCount) nothrow send_mouse_click_event; /// - // Send a mouse move event to the browser. The |x| and |y| coordinates are - // relative to the upper-left corner of the view. + /// Send a mouse move event to the browser. The |x| and |y| coordinates are + /// relative to the upper-left corner of the view. /// extern(System) void function ( cef_browser_host_t* self, @@ -6382,11 +6654,12 @@ struct cef_browser_host_t int mouseLeave) nothrow send_mouse_move_event; /// - // Send a mouse wheel event to the browser. The |x| and |y| coordinates are - // relative to the upper-left corner of the view. The |deltaX| and |deltaY| - // values represent the movement delta in the X and Y directions respectively. - // In order to scroll inside select popups with window rendering disabled - // cef_render_handler_t::GetScreenPoint should be implemented properly. + /// Send a mouse wheel event to the browser. The |x| and |y| coordinates are + /// relative to the upper-left corner of the view. The |deltaX| and |deltaY| + /// values represent the movement delta in the X and Y directions + /// respectively. In order to scroll inside select popups with window + /// rendering disabled cef_render_handler_t::GetScreenPoint should be + /// implemented properly. /// extern(System) void function ( cef_browser_host_t* self, @@ -6395,65 +6668,68 @@ struct cef_browser_host_t int deltaY) nothrow send_mouse_wheel_event; /// - // Send a touch event to the browser for a windowless browser. + /// Send a touch event to the browser for a windowless browser. /// extern(System) void function ( cef_browser_host_t* self, const(cef_touch_event_t)* event) nothrow send_touch_event; /// - // Send a capture lost event to the browser. + /// Send a capture lost event to the browser. /// extern(System) void function (cef_browser_host_t* self) nothrow send_capture_lost_event; /// - // Notify the browser that the window hosting it is about to be moved or - // resized. This function is only used on Windows and Linux. + /// Notify the browser that the window hosting it is about to be moved or + /// resized. This function is only used on Windows and Linux. /// extern(System) void function (cef_browser_host_t* self) nothrow notify_move_or_resize_started; /// - // Returns the maximum rate in frames per second (fps) that - // cef_render_handler_t:: 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 function can only be called on the UI thread. + /// Returns the maximum rate in frames per second (fps) that + /// cef_render_handler_t::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 function can only be called on the UI thread. /// extern(System) int function (cef_browser_host_t* self) nothrow get_windowless_frame_rate; /// - // Set the maximum rate in frames per second (fps) that cef_render_handler_t:: - // 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). Can also be - // set at browser creation via cef_browser_tSettings.windowless_frame_rate. + /// Set the maximum rate in frames per second (fps) that + /// cef_render_handler_t:: 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). Can also be set at browser creation via + /// cef_browser_tSettings.windowless_frame_rate. /// extern(System) void function ( cef_browser_host_t* self, int frame_rate) nothrow set_windowless_frame_rate; /// - // Begins a new composition or updates the existing composition. Blink has a - // special node (a composition node) that allows the input function to change - // text without affecting other DOM nodes. |text| is the optional text that - // will be inserted into the composition node. |underlines| is an optional set - // of ranges that will be underlined in the resulting text. - // |replacement_range| is an optional range of the existing text that will be - // replaced. |selection_range| is an optional range of the resulting text that - // will be selected after insertion or replacement. The |replacement_range| - // value is only used on OS X. - // - // This function may be called multiple times as the composition changes. When - // the client is done making changes the composition should either be canceled - // or completed. To cancel the composition call ImeCancelComposition. To - // complete the composition call either ImeCommitText or - // ImeFinishComposingText. Completion is usually signaled when: - // A. The client receives a WM_IME_COMPOSITION message with a GCS_RESULTSTR - // flag (on Windows), or; - // B. The client receives a "commit" signal of GtkIMContext (on Linux), or; - // C. insertText of NSTextInput is called (on Mac). - // - // This function is only used when window rendering is disabled. + /// Begins a new composition or updates the existing composition. Blink has a + /// special node (a composition node) that allows the input function to change + /// text without affecting other DOM nodes. |text| is the optional text that + /// will be inserted into the composition node. |underlines| is an optional + /// set of ranges that will be underlined in the resulting text. + /// |replacement_range| is an optional range of the existing text that will be + /// replaced. |selection_range| is an optional range of the resulting text + /// that will be selected after insertion or replacement. The + /// |replacement_range| value is only used on OS X. + /// + /// This function may be called multiple times as the composition changes. + /// When the client is done making changes the composition should either be + /// canceled or completed. To cancel the composition call + /// ImeCancelComposition. To complete the composition call either + /// ImeCommitText or ImeFinishComposingText. Completion is usually signaled + /// when: + /// + /// 1. The client receives a WM_IME_COMPOSITION message with a GCS_RESULTSTR + /// flag (on Windows), or; + /// 2. The client receives a "commit" signal of GtkIMContext (on Linux), or; + /// 3. insertText of NSTextInput is called (on Mac). + /// + /// This function is only used when window rendering is disabled. /// extern(System) void function ( cef_browser_host_t* self, @@ -6464,13 +6740,13 @@ struct cef_browser_host_t const(cef_range_t)* selection_range) nothrow ime_set_composition; /// - // Completes the existing composition by optionally inserting the specified - // |text| into the composition node. |replacement_range| is an optional range - // of the existing text that will be replaced. |relative_cursor_pos| is where - // the cursor will be positioned relative to the current cursor position. See - // comments on ImeSetComposition for usage. The |replacement_range| and - // |relative_cursor_pos| values are only used on OS X. This function is only - // used when window rendering is disabled. + /// Completes the existing composition by optionally inserting the specified + /// |text| into the composition node. |replacement_range| is an optional range + /// of the existing text that will be replaced. |relative_cursor_pos| is where + /// the cursor will be positioned relative to the current cursor position. See + /// comments on ImeSetComposition for usage. The |replacement_range| and + /// |relative_cursor_pos| values are only used on OS X. This function is only + /// used when window rendering is disabled. /// extern(System) void function ( cef_browser_host_t* self, @@ -6479,30 +6755,30 @@ struct cef_browser_host_t int relative_cursor_pos) nothrow ime_commit_text; /// - // Completes the existing composition by applying the current composition node - // contents. If |keep_selection| is false (0) the current selection, if any, - // will be discarded. See comments on ImeSetComposition for usage. This - // function is only used when window rendering is disabled. + /// Completes the existing composition by applying the current composition + /// node contents. If |keep_selection| is false (0) the current selection, if + /// any, will be discarded. See comments on ImeSetComposition for usage. This + /// function is only used when window rendering is disabled. /// extern(System) void function ( cef_browser_host_t* self, int keep_selection) nothrow ime_finish_composing_text; /// - // Cancels the existing composition and discards the composition node contents - // without applying them. See comments on ImeSetComposition for usage. This - // function is only used when window rendering is disabled. + /// Cancels the existing composition and discards the composition node + /// contents without applying them. See comments on ImeSetComposition for + /// usage. This function is only used when window rendering is disabled. /// extern(System) void function (cef_browser_host_t* self) nothrow ime_cancel_composition; /// - // Call this function when the user drags the mouse into the web view (before - // calling DragTargetDragOver/DragTargetLeave/DragTargetDrop). |drag_data| - // should not contain file contents as this type of data is not allowed to be - // dragged into the web view. File contents can be removed using - // cef_drag_data_t::ResetFileContents (for example, if |drag_data| comes from - // cef_render_handler_t::StartDragging). This function is only used when - // window rendering is disabled. + /// Call this function when the user drags the mouse into the web view (before + /// calling DragTargetDragOver/DragTargetLeave/DragTargetDrop). |drag_data| + /// should not contain file contents as this type of data is not allowed to be + /// dragged into the web view. File contents can be removed using + /// cef_drag_data_t::ResetFileContents (for example, if |drag_data| comes from + /// cef_render_handler_t::StartDragging). This function is only used when + /// window rendering is disabled. /// extern(System) void function ( cef_browser_host_t* self, @@ -6511,10 +6787,10 @@ struct cef_browser_host_t cef_drag_operations_mask_t allowed_ops) nothrow drag_target_drag_enter; /// - // Call this function each time the mouse is moved across the web view during - // a drag operation (after calling DragTargetDragEnter and before calling - // DragTargetDragLeave/DragTargetDrop). This function is only used when window - // rendering is disabled. + /// Call this function each time the mouse is moved across the web view during + /// a drag operation (after calling DragTargetDragEnter and before calling + /// DragTargetDragLeave/DragTargetDrop). This function is only used when + /// window rendering is disabled. /// extern(System) void function ( cef_browser_host_t* self, @@ -6522,31 +6798,31 @@ struct cef_browser_host_t cef_drag_operations_mask_t allowed_ops) nothrow drag_target_drag_over; /// - // Call this function when the user drags the mouse out of the web view (after - // calling DragTargetDragEnter). This function is only used when window - // rendering is disabled. + /// Call this function when the user drags the mouse out of the web view + /// (after calling DragTargetDragEnter). This function is only used when + /// window rendering is disabled. /// extern(System) void function (cef_browser_host_t* self) nothrow drag_target_drag_leave; /// - // Call this function when the user completes the drag operation by dropping - // the object onto the web view (after calling DragTargetDragEnter). The - // object being dropped is |drag_data|, given as an argument to the previous - // DragTargetDragEnter call. This function is only used when window rendering - // is disabled. + /// Call this function when the user completes the drag operation by dropping + /// the object onto the web view (after calling DragTargetDragEnter). The + /// object being dropped is |drag_data|, given as an argument to the previous + /// DragTargetDragEnter call. This function is only used when window rendering + /// is disabled. /// extern(System) void function ( cef_browser_host_t* self, const(cef_mouse_event_t)* event) nothrow drag_target_drop; /// - // Call this function when the drag operation started by a - // cef_render_handler_t::StartDragging call has ended either in a drop or by - // being cancelled. |x| and |y| are mouse coordinates relative to the upper- - // left corner of the view. If the web view is both the drag source and the - // drag target then all DragTarget* functions should be called before - // DragSource* mthods. This function is only used when window rendering is - // disabled. + /// Call this function when the drag operation started by a + /// cef_render_handler_t::StartDragging call has ended either in a drop or by + /// being cancelled. |x| and |y| are mouse coordinates relative to the upper- + /// left corner of the view. If the web view is both the drag source and the + /// drag target then all DragTarget* functions should be called before + /// DragSource* mthods. This function is only used when window rendering is + /// disabled. /// extern(System) void function ( cef_browser_host_t* self, @@ -6555,55 +6831,55 @@ struct cef_browser_host_t cef_drag_operations_mask_t op) nothrow drag_source_ended_at; /// - // Call this function when the drag operation started by a - // cef_render_handler_t::StartDragging call has completed. This function may - // be called immediately without first calling DragSourceEndedAt to cancel a - // drag operation. If the web view is both the drag source and the drag target - // then all DragTarget* functions should be called before DragSource* mthods. - // This function is only used when window rendering is disabled. + /// Call this function when the drag operation started by a + /// cef_render_handler_t::StartDragging call has completed. This function may + /// be called immediately without first calling DragSourceEndedAt to cancel a + /// drag operation. If the web view is both the drag source and the drag + /// target then all DragTarget* functions should be called before DragSource* + /// mthods. This function is only used when window rendering is disabled. /// extern(System) void function (cef_browser_host_t* self) nothrow drag_source_system_drag_ended; /// - // Returns the current visible navigation entry for this browser. This - // function can only be called on the UI thread. + /// Returns the current visible navigation entry for this browser. This + /// function can only be called on the UI thread. /// extern(System) cef_navigation_entry_t* function ( cef_browser_host_t* self) nothrow get_visible_navigation_entry; /// - // Set accessibility state for all frames. |accessibility_state| may be - // default, enabled or disabled. If |accessibility_state| is STATE_DEFAULT - // then accessibility will be disabled by default and the state may be further - // controlled with the "force-renderer-accessibility" and "disable-renderer- - // accessibility" command-line switches. If |accessibility_state| is - // STATE_ENABLED then accessibility will be enabled. If |accessibility_state| - // is STATE_DISABLED then accessibility will be completely disabled. - // - // For windowed browsers accessibility will be enabled in Complete mode (which - // corresponds to kAccessibilityModeComplete in Chromium). In this mode all - // platform accessibility objects will be created and managed by Chromium's - // internal implementation. The client needs only to detect the screen reader - // and call this function appropriately. For example, on macOS the client can - // handle the @"AXEnhancedUserStructure" accessibility attribute to detect - // VoiceOver state changes and on Windows the client can handle WM_GETOBJECT - // with OBJID_CLIENT to detect accessibility readers. - // - // For windowless browsers accessibility will be enabled in TreeOnly mode - // (which corresponds to kAccessibilityModeWebContentsOnly in Chromium). In - // this mode renderer accessibility is enabled, the full tree is computed, and - // events are passed to CefAccessibiltyHandler, but platform accessibility - // objects are not created. The client may implement platform accessibility - // objects using CefAccessibiltyHandler callbacks if desired. + /// Set accessibility state for all frames. |accessibility_state| may be + /// default, enabled or disabled. If |accessibility_state| is STATE_DEFAULT + /// then accessibility will be disabled by default and the state may be + /// further controlled with the "force-renderer-accessibility" and "disable- + /// renderer-accessibility" command-line switches. If |accessibility_state| is + /// STATE_ENABLED then accessibility will be enabled. If |accessibility_state| + /// is STATE_DISABLED then accessibility will be completely disabled. + /// + /// For windowed browsers accessibility will be enabled in Complete mode + /// (which corresponds to kAccessibilityModeComplete in Chromium). In this + /// mode all platform accessibility objects will be created and managed by + /// Chromium's internal implementation. The client needs only to detect the + /// screen reader and call this function appropriately. For example, on macOS + /// the client can handle the @"AXEnhancedUserStructure" accessibility + /// attribute to detect VoiceOver state changes and on Windows the client can + /// handle WM_GETOBJECT with OBJID_CLIENT to detect accessibility readers. + /// + /// For windowless browsers accessibility will be enabled in TreeOnly mode + /// (which corresponds to kAccessibilityModeWebContentsOnly in Chromium). In + /// this mode renderer accessibility is enabled, the full tree is computed, + /// and events are passed to CefAccessibiltyHandler, but platform + /// accessibility objects are not created. The client may implement platform + /// accessibility objects using CefAccessibiltyHandler callbacks if desired. /// extern(System) void function ( cef_browser_host_t* self, cef_state_t accessibility_state) nothrow set_accessibility_state; /// - // Enable notifications of auto resize via - // cef_display_handler_t::OnAutoResize. Notifications are disabled by default. - // |min_size| and |max_size| define the range of allowed sizes. + /// Enable notifications of auto resize via + /// cef_display_handler_t::OnAutoResize. Notifications are disabled by + /// default. |min_size| and |max_size| define the range of allowed sizes. /// extern(System) void function ( cef_browser_host_t* self, @@ -6612,26 +6888,26 @@ struct cef_browser_host_t const(cef_size_t)* max_size) nothrow set_auto_resize_enabled; /// - // Returns the extension hosted in this browser or NULL if no extension is - // hosted. See cef_request_context_t::LoadExtension for details. + /// Returns the extension hosted in this browser or NULL if no extension is + /// hosted. See cef_request_context_t::LoadExtension for details. /// extern(System) cef_extension_t* function (cef_browser_host_t* self) nothrow get_extension; /// - // Returns true (1) if this browser is hosting an extension background script. - // Background hosts do not have a window and are not displayable. See - // cef_request_context_t::LoadExtension for details. + /// Returns true (1) if this browser is hosting an extension background + /// script. Background hosts do not have a window and are not displayable. See + /// cef_request_context_t::LoadExtension for details. /// extern(System) int function (cef_browser_host_t* self) nothrow is_background_host; /// - // Set whether the browser's audio is muted. + /// Set whether the browser's audio is muted. /// extern(System) void function (cef_browser_host_t* self, int mute) nothrow set_audio_muted; /// - // Returns true (1) if the browser's audio is muted. This function can only - // be called on the UI thread. + /// Returns true (1) if the browser's audio is muted. This function can only + /// be called on the UI thread. /// extern(System) int function (cef_browser_host_t* self) nothrow is_audio_muted; } @@ -6639,14 +6915,14 @@ struct cef_browser_host_t /// -// Create a new browser using the window parameters specified by |windowInfo|. -// All values will be copied internally and the actual window (if any) will be -// created on the UI thread. If |request_context| is NULL the global request -// context will be used. This function can be called on any browser process -// thread and will not block. The optional |extra_info| parameter provides an -// opportunity to specify extra information specific to the created browser that -// will be passed to cef_render_process_handler_t::on_browser_created() in the -// render process. +/// Create a new browser using the window parameters specified by |windowInfo|. +/// All values will be copied internally and the actual window (if any) will be +/// created on the UI thread. If |request_context| is NULL the global request +/// context will be used. This function can be called on any browser process +/// thread and will not block. The optional |extra_info| parameter provides an +/// opportunity to specify extra information specific to the created browser +/// that will be passed to cef_render_process_handler_t::on_browser_created() in +/// the render process. /// int cef_browser_host_create_browser ( const(cef_window_info_t)* windowInfo, @@ -6657,12 +6933,12 @@ int cef_browser_host_create_browser ( cef_request_context_t* request_context); /// -// Create a new browser using the window parameters specified by |windowInfo|. -// If |request_context| is NULL the global request context will be used. This -// function can only be called on the browser process UI thread. The optional -// |extra_info| parameter provides an opportunity to specify extra information -// specific to the created browser that will be passed to -// cef_render_process_handler_t::on_browser_created() in the render process. +/// Create a new browser using the window parameters specified by |windowInfo|. +/// If |request_context| is NULL the global request context will be used. This +/// function can only be called on the browser process UI thread. The optional +/// |extra_info| parameter provides an opportunity to specify extra information +/// specific to the created browser that will be passed to +/// cef_render_process_handler_t::on_browser_created() in the render process. /// cef_browser_t* cef_browser_host_create_browser_sync ( const(cef_window_info_t)* windowInfo, @@ -6673,7 +6949,7 @@ cef_browser_t* cef_browser_host_create_browser_sync ( cef_request_context_t* request_context); // CEF_INCLUDE_CAPI_CEF_BROWSER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -6708,64 +6984,64 @@ cef_browser_t* cef_browser_host_create_browser_sync ( // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=ade537f836add7fe0b5fd94ceba26d678abb3e43$ +// $hash=c4ed4278e513daa2a1ccf42e50e242d61dfbb86f$ // extern (C): /// -// Structure used to implement browser process callbacks. The functions of this -// structure will be called on the browser process main thread unless otherwise -// indicated. +/// Structure used to implement browser process callbacks. The functions of this +/// structure will be called on the browser process main thread unless otherwise +/// indicated. /// struct cef_browser_process_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Called on the browser process UI thread immediately after the CEF context - // has been initialized. + /// Called on the browser process UI thread immediately after the CEF context + /// has been initialized. /// extern(System) void function ( cef_browser_process_handler_t* self) nothrow on_context_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 or plugin process. Provides an - // opportunity to modify the child process command line. Do not keep a - // reference to |command_line| outside of this function. + /// 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 function. /// extern(System) void function ( cef_browser_process_handler_t* self, cef_command_line_t* command_line) nothrow on_before_child_process_launch; /// - // Called from any thread when work has been scheduled for the browser process - // main (UI) thread. This callback is used in combination with CefSettings. - // external_message_pump and cef_do_message_loop_work() in cases where the CEF - // message loop must be integrated into an existing application message loop - // (see additional comments and warnings on CefDoMessageLoopWork). This - // callback should schedule a cef_do_message_loop_work() call to happen on the - // main (UI) thread. |delay_ms| is the requested delay in milliseconds. If - // |delay_ms| is <= 0 then the call should happen reasonably soon. If - // |delay_ms| is > 0 then the call should be scheduled to happen after the - // specified delay and any currently pending scheduled call should be - // cancelled. + /// Called from any thread when work has been scheduled for the browser + /// process main (UI) thread. This callback is used in combination with + /// cef_settings_t.external_message_pump and cef_do_message_loop_work() in + /// cases where the CEF message loop must be integrated into an existing + /// application message loop (see additional comments and warnings on + /// CefDoMessageLoopWork). This callback should schedule a + /// cef_do_message_loop_work() call to happen on the main (UI) thread. + /// |delay_ms| is the requested delay in milliseconds. If |delay_ms| is <= 0 + /// then the call should happen reasonably soon. If |delay_ms| is > 0 then the + /// call should be scheduled to happen after the specified delay and any + /// currently pending scheduled call should be cancelled. /// extern(System) void function ( cef_browser_process_handler_t* self, int64 delay_ms) nothrow on_schedule_message_pump_work; /// - // Return the default client for use with a newly created browser window. If - // null is returned the browser will be unmanaged (no callbacks will be - // executed for that browser) and application shutdown will be blocked until - // the browser window is closed manually. This function is currently only used - // with the chrome runtime. + /// Return the default client for use with a newly created browser window. If + /// null is returned the browser will be unmanaged (no callbacks will be + /// executed for that browser) and application shutdown will be blocked until + /// the browser window is closed manually. This function is currently only + /// used with the chrome runtime. /// extern(System) cef_client_t* function ( cef_browser_process_handler_t* self) nothrow get_default_client; @@ -6774,7 +7050,7 @@ struct cef_browser_process_handler_t // CEF_INCLUDE_CAPI_CEF_BROWSER_PROCESS_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -6809,28 +7085,28 @@ struct cef_browser_process_handler_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=cd8c183355a6808abd763ecc0396b5da6c15b3f9$ +// $hash=1bb026d01d1d4bb38ceb4c54f6bcf70300bf5201$ // extern (C): /// -// Generic callback structure used for asynchronous continuation. +/// Generic callback structure used for asynchronous continuation. /// struct cef_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Continue processing. + /// Continue processing. /// extern(System) void function (cef_callback_t* self) nothrow cont; /// - // Cancel processing. + /// Cancel processing. /// extern(System) void function (cef_callback_t* self) nothrow cancel; } @@ -6838,17 +7114,17 @@ struct cef_callback_t /// -// Generic callback structure used for asynchronous completion. +/// Generic callback structure used for asynchronous completion. /// struct cef_completion_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be called once the task is complete. + /// Method that will be called once the task is complete. /// extern(System) void function (cef_completion_callback_t* self) nothrow on_complete; } @@ -6856,7 +7132,7 @@ struct cef_completion_callback_t // CEF_INCLUDE_CAPI_CEF_CALLBACK_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -6891,117 +7167,129 @@ struct cef_completion_callback_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=845a1d1dda63a06f4ae33ed39acfd2599b46a885$ +// $hash=93f1c39c102dc97d6ad8d236a90a2e0e88f10fb7$ // extern (C): /// -// Implement this structure to provide handler implementations. +/// Implement this structure to provide handler implementations. /// struct cef_client_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Return the handler for audio rendering events. + /// Return the handler for audio rendering events. /// extern(System) cef_audio_handler_t* function (cef_client_t* self) nothrow get_audio_handler; /// - // Return the handler for context menus. If no handler is provided the default - // implementation will be used. + /// Return the handler for commands. If no handler is provided the default + /// implementation will be used. + /// + extern(System) cef_command_handler_t* function (cef_client_t* self) nothrow get_command_handler; + + /// + /// Return the handler for context menus. If no handler is provided the + /// default implementation will be used. /// extern(System) cef_context_menu_handler_t* function ( cef_client_t* self) nothrow get_context_menu_handler; /// - // Return the handler for dialogs. 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. /// extern(System) cef_dialog_handler_t* function (cef_client_t* self) nothrow get_dialog_handler; /// - // Return the handler for browser display state events. + /// Return the handler for browser display state events. /// extern(System) cef_display_handler_t* function (cef_client_t* self) nothrow get_display_handler; /// - // Return the handler for download events. If no handler is returned downloads - // will not be allowed. + /// Return the handler for download events. If no handler is returned + /// downloads will not be allowed. /// extern(System) cef_download_handler_t* function ( cef_client_t* self) nothrow get_download_handler; /// - // Return the handler for drag events. + /// Return the handler for drag events. /// extern(System) cef_drag_handler_t* function (cef_client_t* self) nothrow get_drag_handler; /// - // Return the handler for find result events. + /// Return the handler for find result events. /// extern(System) cef_find_handler_t* function (cef_client_t* self) nothrow get_find_handler; /// - // Return the handler for focus events. + /// Return the handler for focus events. /// extern(System) cef_focus_handler_t* function (cef_client_t* self) nothrow get_focus_handler; /// - // Return the handler for events related to cef_frame_t lifespan. This - // function will be called once during cef_browser_t creation and the result - // will be cached for performance reasons. + /// Return the handler for events related to cef_frame_t lifespan. This + /// function will be called once during cef_browser_t creation and the result + /// will be cached for performance reasons. /// extern(System) cef_frame_handler_t* function (cef_client_t* self) nothrow get_frame_handler; /// - // Return the handler for JavaScript dialogs. If no handler is provided the - // default implementation will be used. + /// Return the handler for permission requests. + /// + extern(System) cef_permission_handler_t* function ( + cef_client_t* self) nothrow get_permission_handler; + + /// + /// Return the handler for JavaScript dialogs. If no handler is provided the + /// default implementation will be used. /// extern(System) cef_jsdialog_handler_t* function ( cef_client_t* self) nothrow get_jsdialog_handler; /// - // Return the handler for keyboard events. + /// Return the handler for keyboard events. /// extern(System) cef_keyboard_handler_t* function ( cef_client_t* self) nothrow get_keyboard_handler; /// - // Return the handler for browser life span events. + /// Return the handler for browser life span events. /// extern(System) cef_life_span_handler_t* function ( cef_client_t* self) nothrow get_life_span_handler; /// - // Return the handler for browser load status events. + /// Return the handler for browser load status events. /// extern(System) cef_load_handler_t* function (cef_client_t* self) nothrow get_load_handler; /// - // 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 printing on Linux. If a print handler is not + /// provided then printing will not be supported on the Linux platform. /// extern(System) cef_print_handler_t* function (cef_client_t* self) nothrow get_print_handler; /// - // Return the handler for off-screen rendering events. + /// Return the handler for off-screen rendering events. /// extern(System) cef_render_handler_t* function (cef_client_t* self) nothrow get_render_handler; /// - // Return the handler for browser request events. + /// Return the handler for browser request events. /// extern(System) cef_request_handler_t* function (cef_client_t* self) nothrow get_request_handler; /// - // Called when a new message is received from a different process. Return true - // (1) if the message was handled or false (0) otherwise. It is safe to keep - // a reference to |message| outside of this callback. + /// Called when a new message is received from a different process. Return + /// true (1) if the message was handled or false (0) otherwise. It is safe to + /// keep a reference to |message| outside of this callback. /// extern(System) int function ( cef_client_t* self, @@ -7014,7 +7302,7 @@ struct cef_client_t // CEF_INCLUDE_CAPI_CEF_CLIENT_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -7049,50 +7337,120 @@ struct cef_client_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=3ecebd6b30bb8fb837e062eacd021c1a1ff3620a$ +// $hash=ec05ae57537091e3543c4b31d72d2d84d44df876$ // extern (C): /// -// Structure 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 structure can be used before cef_initialize() is called. +/// Implement this structure to handle events related to commands. The functions +/// of this structure will be called on the UI thread. /// -struct cef_command_line_t +struct cef_command_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns true (1) if this object is valid. Do not call any other functions - // if this function returns false (0). + /// 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 (1) if the command was handled or + /// false (0) for the default implementation. For context menu commands this + /// will be called after cef_context_menu_handler_t::OnContextMenuCommand. + /// Only used with the Chrome runtime. + /// + extern(System) int function ( + cef_command_handler_t* self, + cef_browser_t* browser, + int command_id, + cef_window_open_disposition_t disposition) nothrow on_chrome_command; +} + + + +// CEF_INCLUDE_CAPI_CEF_COMMAND_HANDLER_CAPI_H_ +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the name Chromium Embedded +// Framework nor the names of its contributors may be used to endorse +// or promote products derived from this software without specific prior +// written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +// +// --------------------------------------------------------------------------- +// +// This file was generated by the CEF translator tool and should not edited +// by hand. See the translator.README.txt file in the tools directory for +// more information. +// +// $hash=f535e9560b9fde9b53fc4d8383905105ed029ea4$ +// + +extern (C): + +/// +/// Structure 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 structure can be used before cef_initialize() is called. +/// +struct cef_command_line_t +{ + /// + /// Base structure. + /// + cef_base_ref_counted_t base; + + /// + /// Returns true (1) if this object is valid. Do not call any other functions + /// if this function returns false (0). /// extern(System) int function (cef_command_line_t* self) nothrow is_valid; /// - // Returns true (1) if the values of this object are read-only. Some APIs may - // expose read-only objects. + /// Returns true (1) if the values of this object are read-only. Some APIs may + /// expose read-only objects. /// extern(System) int function (cef_command_line_t* self) nothrow is_read_only; /// - // Returns a writable copy of this object. + /// Returns a writable copy of this object. /// extern(System) cef_command_line_t* function (cef_command_line_t* self) nothrow copy; /// - // Initialize the command line with the specified |argc| and |argv| values. - // The first argument must be the name of the program. This function is only - // supported on non-Windows platforms. + /// Initialize the command line with the specified |argc| and |argv| values. + /// The first argument must be the name of the program. This function is only + /// supported on non-Windows platforms. /// extern(System) void function ( cef_command_line_t* self, @@ -7100,61 +7458,61 @@ struct cef_command_line_t const(char*)* argv) nothrow init_from_argv; /// - // Initialize the command line with the string returned by calling - // GetCommandLineW(). This function is only supported on Windows. + /// Initialize the command line with the string returned by calling + /// GetCommandLineW(). This function is only supported on Windows. /// extern(System) void function ( cef_command_line_t* self, const(cef_string_t)* command_line) nothrow init_from_string; /// - // Reset the command-line switches and arguments but leave the program - // component unchanged. + /// Reset the command-line switches and arguments but leave the program + /// component unchanged. /// extern(System) void function (cef_command_line_t* self) nothrow reset; /// - // Retrieve the original command line string as a vector of strings. The argv - // array: { program, [(--|-|/)switch[=value]]*, [--], [argument]* } + /// Retrieve the original command line string as a vector of strings. The argv + /// array: `{ program, [(--|-|/)switch[=value]]*, [--], [argument]* }` /// extern(System) void function (cef_command_line_t* self, cef_string_list_t argv) nothrow get_argv; /// - // Constructs and returns the represented command line string. Use this - // function cautiously because quoting behavior is unclear. + /// Constructs and returns the represented command line string. Use this + /// function cautiously because quoting behavior is unclear. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_command_line_t* self) nothrow get_command_line_string; /// - // Get the program part of the command line string (the first item). + /// Get the program part of the command line string (the first item). /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_command_line_t* self) nothrow get_program; /// - // Set the program part of the command line string (the first item). + /// Set the program part of the command line string (the first item). /// extern(System) void function ( cef_command_line_t* self, const(cef_string_t)* program) nothrow set_program; /// - // Returns true (1) if the command line has switches. + /// Returns true (1) if the command line has switches. /// extern(System) int function (cef_command_line_t* self) nothrow has_switches; /// - // Returns true (1) if the command line contains the given switch. + /// Returns true (1) if the command line contains the given switch. /// extern(System) int function ( cef_command_line_t* self, const(cef_string_t)* name) nothrow has_switch; /// - // Returns the value associated with the given switch. If the switch has no - // value or isn't present this function returns the NULL string. + /// Returns the value associated with the given switch. If the switch has no + /// value or isn't present this function returns the NULL string. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( @@ -7162,23 +7520,23 @@ struct cef_command_line_t const(cef_string_t)* name) nothrow get_switch_value; /// - // Returns the map of switch names and values. If a switch has no value an - // NULL string is returned. + /// Returns the map of switch names and values. If a switch has no value an + /// NULL string is returned. /// extern(System) void function ( cef_command_line_t* self, cef_string_map_t switches) nothrow get_switches; /// - // Add a switch to the end of the command line. If the switch has no value - // pass an NULL value string. + /// Add a switch to the end of the command line. If the switch has no value + /// pass an NULL value string. /// extern(System) void function ( cef_command_line_t* self, const(cef_string_t)* name) nothrow append_switch; /// - // Add a switch with the specified value to the end of the command line. + /// Add a switch with the specified value to the end of the command line. /// extern(System) void function ( cef_command_line_t* self, @@ -7186,27 +7544,27 @@ struct cef_command_line_t const(cef_string_t)* value) nothrow append_switch_with_value; /// - // True if there are remaining command line arguments. + /// True if there are remaining command line arguments. /// extern(System) int function (cef_command_line_t* self) nothrow has_arguments; /// - // Get the remaining command line arguments. + /// Get the remaining command line arguments. /// extern(System) void function ( cef_command_line_t* self, cef_string_list_t arguments) nothrow get_arguments; /// - // Add an argument to the end of the command line. + /// Add an argument to the end of the command line. /// extern(System) void function ( cef_command_line_t* self, const(cef_string_t)* argument) nothrow append_argument; /// - // Insert a command before the current command. Common for debuggers, like - // "valgrind" or "gdb --args". + /// Insert a command before the current command. Common for debuggers, like + /// "valgrind" or "gdb --args". /// extern(System) void function ( cef_command_line_t* self, @@ -7216,18 +7574,18 @@ struct cef_command_line_t /// -// Create a new cef_command_line_t instance. +/// Create a new cef_command_line_t instance. /// cef_command_line_t* cef_command_line_create (); /// -// Returns the singleton global cef_command_line_t object. The returned object -// will be read-only. +/// Returns the singleton global cef_command_line_t object. The returned object +/// will be read-only. /// cef_command_line_t* cef_command_line_get_global (); // CEF_INCLUDE_CAPI_CEF_COMMAND_LINE_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -7262,24 +7620,24 @@ cef_command_line_t* cef_command_line_get_global (); // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=175779df75a1405fcc5c337a09e6322c556698ba$ +// $hash=0ae549ed35e30afcbb01961fe55455beaadcd7f9$ // extern (C): /// -// Callback structure used for continuation of custom context menu display. +/// Callback structure used for continuation of custom context menu display. /// struct cef_run_context_menu_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Complete context menu display by selecting the specified |command_id| and - // |event_flags|. + /// Complete context menu display by selecting the specified |command_id| and + /// |event_flags|. /// extern(System) void function ( cef_run_context_menu_callback_t* self, @@ -7287,7 +7645,7 @@ struct cef_run_context_menu_callback_t cef_event_flags_t event_flags) nothrow cont; /// - // Cancel context menu display. + /// Cancel context menu display. /// extern(System) void function (cef_run_context_menu_callback_t* self) nothrow cancel; } @@ -7295,22 +7653,49 @@ struct cef_run_context_menu_callback_t /// -// Implement this structure to handle context menu events. The functions of this -// structure will be called on the UI thread. +/// Callback structure used for continuation of custom quick menu display. /// -struct cef_context_menu_handler_t +struct cef_run_quick_menu_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // 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. + /// Complete quick menu display by selecting the specified |command_id| and + /// |event_flags|. + /// + extern(System) void function ( + cef_run_quick_menu_callback_t* self, + int command_id, + cef_event_flags_t event_flags) nothrow cont; + + /// + /// Cancel quick menu display. + /// + extern(System) void function (cef_run_quick_menu_callback_t* self) nothrow cancel; +} + + + +/// +/// Implement this structure to handle context menu events. The functions of +/// this structure will be called on the UI thread. +/// +struct cef_context_menu_handler_t +{ + /// + /// Base structure. + /// + cef_base_ref_counted_t base; + + /// + /// 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. /// extern(System) void function ( cef_context_menu_handler_t* self, @@ -7320,12 +7705,12 @@ struct cef_context_menu_handler_t cef_menu_model_t* model) nothrow on_before_context_menu; /// - // 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 - // (1) and execute |callback| either synchronously or asynchronously with the - // selected command ID. For default display return false (0). 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 (1) and execute |callback| either synchronously or asynchronously + /// with the selected command ID. For default display return false (0). Do not + /// keep references to |params| or |model| outside of this callback. /// extern(System) int function ( cef_context_menu_handler_t* self, @@ -7336,13 +7721,13 @@ struct cef_context_menu_handler_t cef_run_context_menu_callback_t* callback) nothrow run_context_menu; /// - // Called to execute a command selected from the context menu. Return true (1) - // if the command was handled or false (0) 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 - // on_before_context_menu(). Do not keep a reference to |params| outside of - // this callback. + /// Called to execute a command selected from the context menu. Return true + /// (1) if the command was handled or false (0) 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 on_before_context_menu(). Do not keep a + /// reference to |params| outside of this callback. /// extern(System) int function ( cef_context_menu_handler_t* self, @@ -7353,167 +7738,208 @@ struct cef_context_menu_handler_t cef_event_flags_t event_flags) nothrow on_context_menu_command; /// - // Called when the context menu is dismissed irregardless of whether the menu - // was NULL or a command was selected. + /// Called when the context menu is dismissed irregardless of whether the menu + /// was canceled or a command was selected. /// extern(System) void function ( cef_context_menu_handler_t* self, cef_browser_t* browser, cef_frame_t* frame) nothrow on_context_menu_dismissed; + + /// + /// 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 (1) if the menu + /// will be handled and execute |callback| either synchronously or + /// asynchronously with the selected command ID. Return false (0) to cancel + /// the menu. + /// + extern(System) int function ( + cef_context_menu_handler_t* self, + cef_browser_t* browser, + cef_frame_t* frame, + const(cef_point_t)* location, + const(cef_size_t)* size, + cef_quick_menu_edit_state_flags_t edit_state_flags, + cef_run_quick_menu_callback_t* callback) nothrow run_quick_menu; + + /// + /// Called to execute a command selected from the quick menu for a windowless + /// browser. Return true (1) if the command was handled or false (0) for the + /// default implementation. See cef_menu_id_t for command IDs that have + /// default implementations. + /// + extern(System) int function ( + cef_context_menu_handler_t* self, + cef_browser_t* browser, + cef_frame_t* frame, + int command_id, + cef_event_flags_t event_flags) nothrow on_quick_menu_command; + + /// + /// Called when the quick menu for a windowless browser is dismissed + /// irregardless of whether the menu was canceled or a command was selected. + /// + extern(System) void function ( + cef_context_menu_handler_t* self, + cef_browser_t* browser, + cef_frame_t* frame) nothrow on_quick_menu_dismissed; } /// -// Provides information about the context menu state. The ethods of this -// structure can only be accessed on browser process the UI thread. +/// Provides information about the context menu state. The functions of this +/// structure can only be accessed on browser process the UI thread. /// struct cef_context_menu_params_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns the X coordinate of the mouse where the context menu was invoked. - // Coords are relative to the associated RenderView's origin. + /// Returns the X coordinate of the mouse where the context menu was invoked. + /// Coords are relative to the associated RenderView's origin. /// extern(System) int function (cef_context_menu_params_t* self) nothrow get_xcoord; /// - // Returns the Y 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. /// extern(System) int function (cef_context_menu_params_t* self) nothrow get_ycoord; /// - // Returns flags representing the type of node that the context menu was - // invoked on. + /// Returns flags representing the type of node that the context menu was + /// invoked on. /// extern(System) cef_context_menu_type_flags_t function ( cef_context_menu_params_t* self) nothrow get_type_flags; /// - // Returns the URL of the link, if any, that encloses the 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. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_link_url; /// - // 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 link URL, if any, to be used ONLY for "copy link address". We + /// don't validate this field in the frontend process. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_unfiltered_link_url; /// - // 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 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. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_source_url; /// - // Returns true (1) if the context menu was invoked on an image which has non- - // NULL contents. + /// Returns true (1) if the context menu was invoked on an image which has + /// non-NULL contents. /// extern(System) int function (cef_context_menu_params_t* self) nothrow has_image_contents; /// - // Returns the title text or the alt text if the context menu was invoked on - // an image. + /// Returns the title text or the alt text if the context menu was invoked on + /// an image. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_title_text; /// - // Returns the URL of the top level page that the context menu was invoked on. + /// Returns the URL of the top level page that the context menu was invoked + /// on. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_page_url; /// - // Returns the URL of the subframe that the context menu was invoked on. + /// Returns the URL of the subframe that the context menu was invoked on. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_frame_url; /// - // Returns the character encoding of the subframe that the context menu was - // invoked on. + /// Returns the character encoding of the subframe that the context menu was + /// invoked on. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_frame_charset; /// - // Returns the type of context node that the context menu was invoked on. + /// Returns the type of context node that the context menu was invoked on. /// extern(System) cef_context_menu_media_type_t function ( cef_context_menu_params_t* self) nothrow get_media_type; /// - // Returns flags representing the actions supported by the media element, if - // any, 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. /// extern(System) cef_context_menu_media_state_flags_t function ( cef_context_menu_params_t* self) nothrow get_media_state_flags; /// - // Returns the text of the selection, if any, that the context menu was - // invoked on. + /// Returns the text of the selection, if any, that the context menu was + /// invoked on. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_selection_text; /// - // Returns the text of the misspelled word, 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. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_context_menu_params_t* self) nothrow get_misspelled_word; /// - // Returns true (1) if suggestions exist, false (0) otherwise. Fills in - // |suggestions| from the spell check service for the misspelled word if there - // is one. + /// Returns true (1) if suggestions exist, false (0) otherwise. Fills in + /// |suggestions| from the spell check service for the misspelled word if + /// there is one. /// extern(System) int function ( cef_context_menu_params_t* self, cef_string_list_t suggestions) nothrow get_dictionary_suggestions; /// - // Returns true (1) if the context menu was invoked on an editable node. + /// Returns true (1) if the context menu was invoked on an editable node. /// extern(System) int function (cef_context_menu_params_t* self) nothrow is_editable; /// - // Returns true (1) if the context menu was invoked on an editable node where - // spell-check is enabled. + /// Returns true (1) if the context menu was invoked on an editable node where + /// spell-check is enabled. /// extern(System) int function (cef_context_menu_params_t* self) nothrow is_spell_check_enabled; /// - // Returns flags representing the actions supported by the editable node, if - // any, that the context menu was invoked on. + /// Returns flags representing the actions supported by the editable node, if + /// any, that the context menu was invoked on. /// extern(System) cef_context_menu_edit_state_flags_t function ( cef_context_menu_params_t* self) nothrow get_edit_state_flags; /// - // Returns true (1) if the context menu contains items specified by the - // renderer process (for example, plugin placeholder or pepper plugin menu - // items). + /// Returns true (1) if the context menu contains items specified by the + /// renderer process. /// extern(System) int function (cef_context_menu_params_t* self) nothrow is_custom_menu; } @@ -7521,7 +7947,7 @@ struct cef_context_menu_params_t // CEF_INCLUDE_CAPI_CEF_CONTEXT_MENU_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -7556,37 +7982,37 @@ struct cef_context_menu_params_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=b19ef1c8a781f8d59276357609fe64370bb8a107$ +// $hash=37b5e115ff7abd1df1b9913404b69505fb9fef29$ // extern (C): /// -// Structure used for managing cookies. The functions of this structure may be -// called on any thread unless otherwise indicated. +/// Structure used for managing cookies. The functions of this structure may be +/// called on any thread unless otherwise indicated. /// struct cef_cookie_manager_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Visit all cookies on the UI thread. The returned cookies are ordered by - // longest path, then by earliest creation date. Returns false (0) if cookies - // cannot be accessed. + /// Visit all cookies on the UI thread. The returned cookies are ordered by + /// longest path, then by earliest creation date. Returns false (0) if cookies + /// cannot be accessed. /// extern(System) int function ( cef_cookie_manager_t* self, cef_cookie_visitor_t* visitor) nothrow visit_all_cookies; /// - // Visit a subset of cookies on the UI thread. The results are filtered by the - // given url scheme, host, domain and path. If |includeHttpOnly| is true (1) - // HTTP-only cookies will also be included in the results. The returned - // cookies are ordered by longest path, then by earliest creation date. - // Returns false (0) if cookies cannot be accessed. + /// Visit a subset of cookies on the UI thread. The results are filtered by + /// the given url scheme, host, domain and path. If |includeHttpOnly| is true + /// (1) HTTP-only cookies will also be included in the results. The returned + /// cookies are ordered by longest path, then by earliest creation date. + /// Returns false (0) if cookies cannot be accessed. /// extern(System) int function ( cef_cookie_manager_t* self, @@ -7595,13 +8021,13 @@ struct cef_cookie_manager_t cef_cookie_visitor_t* visitor) nothrow visit_url_cookies; /// - // Sets a cookie given a valid URL and explicit user-provided cookie - // attributes. This function expects each attribute to be well-formed. It will - // check for disallowed characters (e.g. the ';' character is disallowed - // within the cookie value attribute) and fail without setting the cookie if - // such characters are found. If |callback| is non-NULL it will be executed - // asnychronously on the UI thread after the cookie has been set. Returns - // false (0) if an invalid URL is specified or if cookies cannot be accessed. + /// Sets a cookie given a valid URL and explicit user-provided cookie + /// attributes. This function expects each attribute to be well-formed. It + /// will check for disallowed characters (e.g. the ';' character is disallowed + /// within the cookie value attribute) and fail without setting the cookie if + /// such characters are found. If |callback| is non-NULL it will be executed + /// asnychronously on the UI thread after the cookie has been set. Returns + /// false (0) if an invalid URL is specified or if cookies cannot be accessed. /// extern(System) int function ( cef_cookie_manager_t* self, @@ -7610,15 +8036,15 @@ struct cef_cookie_manager_t cef_set_cookie_callback_t* callback) nothrow set_cookie; /// - // Delete all cookies that match the specified parameters. If both |url| and - // |cookie_name| values are specified all host and domain cookies matching - // both will be deleted. If only |url| is specified all host cookies (but not - // domain cookies) irrespective of path will be deleted. If |url| is NULL all - // cookies for all hosts and domains will be deleted. If |callback| is non- - // NULL it will be executed asnychronously on the UI thread after the cookies - // have been deleted. Returns false (0) if a non-NULL invalid URL is specified - // or if cookies cannot be accessed. Cookies can alternately be deleted using - // the Visit*Cookies() functions. + /// Delete all cookies that match the specified parameters. If both |url| and + /// |cookie_name| values are specified all host and domain cookies matching + /// both will be deleted. If only |url| is specified all host cookies (but not + /// domain cookies) irrespective of path will be deleted. If |url| is NULL all + /// cookies for all hosts and domains will be deleted. If |callback| is non- + /// NULL it will be executed asnychronously on the UI thread after the cookies + /// have been deleted. Returns false (0) if a non-NULL invalid URL is + /// specified or if cookies cannot be accessed. Cookies can alternately be + /// deleted using the Visit*Cookies() functions. /// extern(System) int function ( cef_cookie_manager_t* self, @@ -7627,9 +8053,9 @@ struct cef_cookie_manager_t cef_delete_cookies_callback_t* callback) nothrow delete_cookies; /// - // Flush the backing store (if any) to disk. If |callback| is non-NULL it will - // be executed asnychronously on the UI thread after the flush is complete. - // Returns false (0) if cookies cannot be accessed. + /// Flush the backing store (if any) to disk. If |callback| is non-NULL it + /// will be executed asnychronously on the UI thread after the flush is + /// complete. Returns false (0) if cookies cannot be accessed. /// extern(System) int function ( cef_cookie_manager_t* self, @@ -7639,33 +8065,33 @@ struct cef_cookie_manager_t /// -// Returns the global cookie manager. By default data will be stored at -// CefSettings.cache_path if specified or in memory otherwise. If |callback| is -// non-NULL it will be executed asnychronously on the UI thread after the -// manager's storage has been initialized. Using this function is equivalent to -// calling cef_request_context_t::cef_request_context_get_global_context()->GetD -// efaultCookieManager(). +/// Returns the global cookie manager. By default data will be stored at +/// cef_settings_t.cache_path if specified or in memory otherwise. If |callback| +/// is non-NULL it will be executed asnychronously on the UI thread after the +/// manager's storage has been initialized. Using this function is equivalent to +/// calling cef_request_context_t::cef_request_context_get_global_context()->Get +/// DefaultCookieManager(). /// cef_cookie_manager_t* cef_cookie_manager_get_global_manager ( cef_completion_callback_t* callback); /// -// Structure to implement for visiting cookie values. The functions of this -// structure will always be called on the UI thread. +/// Structure to implement for visiting cookie values. The functions of this +/// structure will always be called on the UI thread. /// struct cef_cookie_visitor_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be called once for each cookie. |count| is the 0-based - // index for the current cookie. |total| is the total number of cookies. Set - // |deleteCookie| to true (1) to delete the cookie currently being visited. - // Return false (0) to stop visiting cookies. This function may never be - // called if no cookies are found. + /// Method that will be called once for each cookie. |count| is the 0-based + /// index for the current cookie. |total| is the total number of cookies. Set + /// |deleteCookie| to true (1) to delete the cookie currently being visited. + /// Return false (0) to stop visiting cookies. This function may never be + /// called if no cookies are found. /// extern(System) int function ( cef_cookie_visitor_t* self, @@ -7678,19 +8104,19 @@ struct cef_cookie_visitor_t /// -// Structure to implement to be notified of asynchronous completion via -// cef_cookie_manager_t::set_cookie(). +/// Structure to implement to be notified of asynchronous completion via +/// cef_cookie_manager_t::set_cookie(). /// struct cef_set_cookie_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be called upon completion. |success| will be true (1) if - // the cookie was set successfully. + /// Method that will be called upon completion. |success| will be true (1) if + /// the cookie was set successfully. /// extern(System) void function (cef_set_cookie_callback_t* self, int success) nothrow on_complete; } @@ -7698,19 +8124,19 @@ struct cef_set_cookie_callback_t /// -// Structure to implement to be notified of asynchronous completion via -// cef_cookie_manager_t::delete_cookies(). +/// Structure to implement to be notified of asynchronous completion via +/// cef_cookie_manager_t::delete_cookies(). /// struct cef_delete_cookies_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be called upon completion. |num_deleted| will be the - // number of cookies that were deleted. + /// Method that will be called upon completion. |num_deleted| will be the + /// number of cookies that were deleted. /// extern(System) void function ( cef_delete_cookies_callback_t* self, @@ -7720,7 +8146,7 @@ struct cef_delete_cookies_callback_t // CEF_INCLUDE_CAPI_CEF_COOKIE_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -7755,112 +8181,115 @@ struct cef_delete_cookies_callback_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=5e19231e3476eef376c2742e8d375bee7bd4ea2d$ +// $hash=1ce19c3213f033ca9059da738102b9b4292d4a06$ // extern (C): /// -// Crash reporting is configured using an INI-style config file named -// "crash_reporter.cfg". On Windows and Linux this file must be placed next to -// the main application executable. On macOS this file must be placed in the -// top-level app bundle Resources directory (e.g. -// ".app/Contents/Resources"). File contents are as follows: -// -// # Comments start with a hash character and must be on their own line. -// -// [Config] -// ProductName= -// ProductVersion= -// AppName= -// ExternalHandler= -// BrowserCrashForwardingEnabled= -// ServerURL= -// RateLimitEnabled= -// MaxUploadsPerDay= -// MaxDatabaseSizeInMb= -// MaxDatabaseAgeInDays= -// -// [CrashKeys] -// my_key1= -// my_key2= -// -// Config section: -// -// If "ProductName" and/or "ProductVersion" are set then the specified values -// will be included in the crash dump metadata. On macOS if these values are set -// to NULL then they will be retrieved from the Info.plist file using the -// "CFBundleName" and "CFBundleShortVersionString" keys respectively. -// -// If "AppName" is set on Windows then crash report information (metrics, -// database and dumps) will be stored locally on disk under the -// "C:\Users\[CurrentUser]\AppData\Local\[AppName]\User Data" folder. On other -// platforms the CefSettings.user_data_path value will be used. -// -// If "ExternalHandler" is set on Windows then the specified exe will be -// launched as the crashpad-handler instead of re-launching the main process -// exe. The value can be an absolute path or a path relative to the main exe -// directory. On Linux the CefSettings.browser_subprocess_path value will be -// used. On macOS the existing subprocess app bundle will be used. -// -// If "BrowserCrashForwardingEnabled" is set to true (1) on macOS then browser -// process crashes will be forwarded to the system crash reporter. This results -// in the crash UI dialog being displayed to the user and crash reports being -// logged under "~/Library/Logs/DiagnosticReports". Forwarding of crash reports -// from non-browser processes and Debug builds is always disabled. -// -// If "ServerURL" is set then crashes will be uploaded as a multi-part POST -// request to the specified URL. Otherwise, reports will only be stored locally -// on disk. -// -// If "RateLimitEnabled" is set to true (1) then crash report uploads will be -// rate limited as follows: -// 1. If "MaxUploadsPerDay" is set to a positive value then at most the -// specified number of crashes will be uploaded in each 24 hour period. -// 2. If crash upload fails due to a network or server error then an -// incremental backoff delay up to a maximum of 24 hours will be applied for -// retries. -// 3. If a backoff delay is applied and "MaxUploadsPerDay" is > 1 then the -// "MaxUploadsPerDay" value will be reduced to 1 until the client is -// restarted. This helps to avoid an upload flood when the network or -// server error is resolved. -// Rate limiting is not supported on Linux. -// -// If "MaxDatabaseSizeInMb" is set to a positive value then crash report storage -// on disk will be limited to that size in megabytes. For example, on Windows -// each dump is about 600KB so a "MaxDatabaseSizeInMb" value of 20 equates to -// about 34 crash reports stored on disk. Not supported on Linux. -// -// If "MaxDatabaseAgeInDays" is set to a positive value then crash reports older -// than the specified age in days will be deleted. Not supported on Linux. -// -// CrashKeys section: -// -// A maximum of 26 crash keys of each size can be specified for use by the -// application. Crash key values will be truncated based on the specified size -// (small = 64 bytes, medium = 256 bytes, large = 1024 bytes). The value of -// crash keys can be set from any thread or process using the -// CefSetCrashKeyValue function. These key/value pairs will be sent to the crash -// server along with the crash dump file. +/// Crash reporting is configured using an INI-style config file named +/// "crash_reporter.cfg". On Windows and Linux this file must be placed next to +/// the main application executable. On macOS this file must be placed in the +/// top-level app bundle Resources directory (e.g. +/// ".app/Contents/Resources"). File contents are as follows: +/// +/// 
+///  # Comments start with a hash character and must be on their own line.
+///
+///  [Config]
+///  ProductName=
+///  ProductVersion=
+///  AppName=
+///  ExternalHandler=
+///  BrowserCrashForwardingEnabled=
+///  ServerURL=
+///  RateLimitEnabled=
+///  MaxUploadsPerDay=
+///  MaxDatabaseSizeInMb=
+///  MaxDatabaseAgeInDays=
+///
+///  [CrashKeys]
+///  my_key1=
+///  my_key2=
+///
+/// +/// Config section: +/// +/// If "ProductName" and/or "ProductVersion" are set then the specified values +/// will be included in the crash dump metadata. On macOS if these values are +/// set to NULL then they will be retrieved from the Info.plist file using the +/// "CFBundleName" and "CFBundleShortVersionString" keys respectively. +/// +/// If "AppName" is set on Windows then crash report information (metrics, +/// database and dumps) will be stored locally on disk under the +/// "C:\Users\[CurrentUser]\AppData\Local\[AppName]\User Data" folder. On other +/// platforms the cef_settings_t.user_data_path value will be used. +/// +/// If "ExternalHandler" is set on Windows then the specified exe will be +/// launched as the crashpad-handler instead of re-launching the main process +/// exe. The value can be an absolute path or a path relative to the main exe +/// directory. On Linux the cef_settings_t.browser_subprocess_path value will be +/// used. On macOS the existing subprocess app bundle will be used. +/// +/// If "BrowserCrashForwardingEnabled" is set to true (1) on macOS then browser +/// process crashes will be forwarded to the system crash reporter. This results +/// in the crash UI dialog being displayed to the user and crash reports being +/// logged under "~/Library/Logs/DiagnosticReports". Forwarding of crash reports +/// from non-browser processes and Debug builds is always disabled. +/// +/// If "ServerURL" is set then crashes will be uploaded as a multi-part POST +/// request to the specified URL. Otherwise, reports will only be stored locally +/// on disk. +/// +/// If "RateLimitEnabled" is set to true (1) then crash report uploads will be +/// rate limited as follows: +/// 1. If "MaxUploadsPerDay" is set to a positive value then at most the +/// specified number of crashes will be uploaded in each 24 hour period. +/// 2. If crash upload fails due to a network or server error then an +/// incremental backoff delay up to a maximum of 24 hours will be applied +/// for retries. +/// 3. If a backoff delay is applied and "MaxUploadsPerDay" is > 1 then the +/// "MaxUploadsPerDay" value will be reduced to 1 until the client is +/// restarted. This helps to avoid an upload flood when the network or +/// server error is resolved. +/// Rate limiting is not supported on Linux. +/// +/// If "MaxDatabaseSizeInMb" is set to a positive value then crash report +/// storage on disk will be limited to that size in megabytes. For example, on +/// Windows each dump is about 600KB so a "MaxDatabaseSizeInMb" value of 20 +/// equates to about 34 crash reports stored on disk. Not supported on Linux. +/// +/// If "MaxDatabaseAgeInDays" is set to a positive value then crash reports +/// older than the specified age in days will be deleted. Not supported on +/// Linux. +/// +/// CrashKeys section: +/// +/// A maximum of 26 crash keys of each size can be specified for use by the +/// application. Crash key values will be truncated based on the specified size +/// (small = 64 bytes, medium = 256 bytes, large = 1024 bytes). The value of +/// crash keys can be set from any thread or process using the +/// CefSetCrashKeyValue function. These key/value pairs will be sent to the +/// crash server along with the crash dump file. /// int cef_crash_reporting_enabled (); /// -// Sets or clears a specific key-value pair from the crash metadata. +/// Sets or clears a specific key-value pair from the crash metadata. /// void cef_set_crash_key_value ( const(cef_string_t)* key, const(cef_string_t)* value); // CEF_INCLUDE_CAPI_CEF_CRASH_UTIL_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -7895,7 +8324,7 @@ void cef_set_crash_key_value ( // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=1a256c04042ebd4867f39e1c31def558871b2bab$ +// $hash=076a01db2fc4241efeb46c5f247a9737fd828f9b$ // extern (C): @@ -7903,36 +8332,37 @@ extern (C): /// -// Callback structure for cef_browser_host_t::AddDevToolsMessageObserver. The -// functions of this structure will be called on the browser process UI thread. +/// Callback structure for cef_browser_host_t::AddDevToolsMessageObserver. The +/// functions of this structure will be called on the browser process UI thread. /// struct cef_dev_tools_message_observer_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method that will be called on receipt of a DevTools protocol message. - // |browser| is the originating browser instance. |message| is a UTF8-encoded - // JSON dictionary representing either a function result or an event. - // |message| is only valid for the scope of this callback and should be copied - // if necessary. Return true (1) if the message was handled or false (0) if - // the message should be further processed and passed to the - // OnDevToolsMethodResult or OnDevToolsEvent functions as appropriate. - // - // Method result dictionaries include an "id" (int) value that identifies the - // orginating function call sent from cef_browser_host_t::SendDevToolsMessage, - // and optionally either a "result" (dictionary) or "error" (dictionary) - // value. The "error" dictionary will contain "code" (int) and "message" - // (string) values. Event dictionaries include a "function" (string) value and - // optionally a "params" (dictionary) value. See the DevTools protocol - // documentation at https://chromedevtools.github.io/devtools-protocol/ for - // details of supported function calls and the expected "result" or "params" - // dictionary contents. JSON dictionaries can be parsed using the CefParseJSON - // function if desired, however be aware of performance considerations when - // parsing large messages (some of which may exceed 1MB in size). + /// Method that will be called on receipt of a DevTools protocol message. + /// |browser| is the originating browser instance. |message| is a UTF8-encoded + /// JSON dictionary representing either a function result or an event. + /// |message| is only valid for the scope of this callback and should be + /// copied if necessary. Return true (1) if the message was handled or false + /// (0) if the message should be further processed and passed to the + /// OnDevToolsMethodResult or OnDevToolsEvent functions as appropriate. + /// + /// Method result dictionaries include an "id" (int) value that identifies the + /// orginating function call sent from + /// cef_browser_host_t::SendDevToolsMessage, and optionally either a "result" + /// (dictionary) or "error" (dictionary) value. The "error" dictionary will + /// contain "code" (int) and "message" (string) values. Event dictionaries + /// include a "function" (string) value and optionally a "params" (dictionary) + /// value. See the DevTools protocol documentation at + /// https://chromedevtools.github.io/devtools-protocol/ for details of + /// supported function calls and the expected "result" or "params" dictionary + /// contents. JSON dictionaries can be parsed using the CefParseJSON function + /// if desired, however be aware of performance considerations when parsing + /// large messages (some of which may exceed 1MB in size). /// extern(System) int function ( cef_dev_tools_message_observer_t* self, @@ -7941,16 +8371,16 @@ struct cef_dev_tools_message_observer_t size_t message_size) nothrow on_dev_tools_message; /// - // Method that will be called after attempted execution of a DevTools protocol - // function. |browser| is the originating browser instance. |message_id| is - // the "id" value that identifies the originating function call message. If - // the function succeeded |success| will be true (1) and |result| will be the - // UTF8-encoded JSON "result" dictionary value (which may be NULL). If the - // function failed |success| will be false (0) and |result| will be the - // UTF8-encoded JSON "error" dictionary value. |result| is only valid for the - // scope of this callback and should be copied if necessary. See the - // OnDevToolsMessage documentation for additional details on |result| - // contents. + /// Method that will be called after attempted execution of a DevTools + /// protocol function. |browser| is the originating browser instance. + /// |message_id| is the "id" value that identifies the originating function + /// call message. If the function succeeded |success| will be true (1) and + /// |result| will be the UTF8-encoded JSON "result" dictionary value (which + /// may be NULL). If the function failed |success| will be false (0) and + /// |result| will be the UTF8-encoded JSON "error" dictionary value. |result| + /// is only valid for the scope of this callback and should be copied if + /// necessary. See the OnDevToolsMessage documentation for additional details + /// on |result| contents. /// extern(System) void function ( cef_dev_tools_message_observer_t* self, @@ -7961,12 +8391,12 @@ struct cef_dev_tools_message_observer_t size_t result_size) nothrow on_dev_tools_method_result; /// - // Method that will be called on receipt of a DevTools protocol event. - // |browser| is the originating browser instance. |function| is the "function" - // value. |params| is the UTF8-encoded JSON "params" dictionary value (which - // may be NULL). |params| is only valid for the scope of this callback and - // should be copied if necessary. See the OnDevToolsMessage documentation for - // additional details on |params| contents. + /// Method that will be called on receipt of a DevTools protocol event. + /// |browser| is the originating browser instance. |function| is the + /// "function" value. |params| is the UTF8-encoded JSON "params" dictionary + /// value (which may be NULL). |params| is only valid for the scope of this + /// callback and should be copied if necessary. See the OnDevToolsMessage + /// documentation for additional details on |params| contents. /// extern(System) void function ( cef_dev_tools_message_observer_t* self, @@ -7976,19 +8406,19 @@ struct cef_dev_tools_message_observer_t size_t params_size) nothrow on_dev_tools_event; /// - // Method that will be called when the DevTools agent has attached. |browser| - // is the originating browser instance. This will generally occur in response - // to the first message sent while the agent is detached. + /// Method that will be called when the DevTools agent has attached. |browser| + /// is the originating browser instance. This will generally occur in response + /// to the first message sent while the agent is detached. /// extern(System) void function ( cef_dev_tools_message_observer_t* self, cef_browser_t* browser) nothrow on_dev_tools_agent_attached; /// - // Method that will be called when the DevTools agent has detached. |browser| - // is the originating browser instance. Any function results that were pending - // before the agent became detached will not be delivered, and any active - // event subscriptions will be canceled. + /// Method that will be called when the DevTools agent has detached. |browser| + /// is the originating browser instance. Any function results that were + /// pending before the agent became detached will not be delivered, and any + /// active event subscriptions will be canceled. /// extern(System) void function ( cef_dev_tools_message_observer_t* self, @@ -7998,7 +8428,7 @@ struct cef_dev_tools_message_observer_t // CEF_INCLUDE_CAPI_CEF_DEVTOOLS_MESSAGE_OBSERVER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -8033,35 +8463,32 @@ struct cef_dev_tools_message_observer_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=5ae5556e4085faf8cf17ee757f5eeac9197f75c0$ +// $hash=3a1a3ac84690c6090d356ddec3ddb49b934fe28c$ // extern (C): /// -// Callback structure for asynchronous continuation of file dialog requests. +/// Callback structure for asynchronous continuation of file dialog requests. /// struct cef_file_dialog_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Continue the file selection. |selected_accept_filter| should be the 0-based - // index of the value selected from the accept filters array passed to - // cef_dialog_handler_t::OnFileDialog. |file_paths| should be a single value - // or a list of values depending on the dialog mode. An NULL |file_paths| - // value is treated the same as calling cancel(). + /// Continue the file selection. |file_paths| should be a single value or a + /// list of values depending on the dialog mode. An NULL |file_paths| value is + /// treated the same as calling cancel(). /// extern(System) void function ( cef_file_dialog_callback_t* self, - int selected_accept_filter, cef_string_list_t file_paths) nothrow cont; /// - // Cancel the file selection. + /// Cancel the file selection. /// extern(System) void function (cef_file_dialog_callback_t* self) nothrow cancel; } @@ -8069,30 +8496,29 @@ struct cef_file_dialog_callback_t /// -// Implement this structure to handle dialog events. The functions of this -// structure will be called on the browser process UI thread. +/// Implement this structure to handle dialog events. The functions of this +/// structure will be called on the browser process UI thread. /// struct cef_dialog_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // 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 NULL - // 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 any combination of - // (a) valid lower-cased MIME types (e.g. "text/*" or "image/*"), (b) - // individual file extensions (e.g. ".txt" or ".png"), or (c) combined - // description and file extension delimited using "|" and ";" (e.g. "Image - // Types|.png;.gif;.jpg"). |selected_accept_filter| is the 0-based index of - // the filter that should be selected by default. To display a custom dialog - // return true (1) and execute |callback| either inline or at a later time. To - // display the default dialog return false (0). + /// 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 NULL + /// 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 + /// any combination of (a) valid lower-cased MIME types (e.g. "text/*" or + /// "image/*"), (b) individual file extensions (e.g. ".txt" or ".png"), or (c) + /// combined description and file extension delimited using "|" and ";" (e.g. + /// "Image Types|.png;.gif;.jpg"). To display a custom dialog return true (1) + /// and execute |callback| either inline or at a later time. To display the + /// default dialog return false (0). /// extern(System) int function ( cef_dialog_handler_t* self, @@ -8101,14 +8527,13 @@ struct cef_dialog_handler_t const(cef_string_t)* title, const(cef_string_t)* default_file_path, cef_string_list_t accept_filters, - int selected_accept_filter, cef_file_dialog_callback_t* callback) nothrow on_file_dialog; } // CEF_INCLUDE_CAPI_CEF_DIALOG_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -8143,7 +8568,7 @@ struct cef_dialog_handler_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=067fd169a30bec1ad8eeacc5ab1ac750cf59640e$ +// $hash=976a61df924efbcb0c53afeb75265e5e9e80c2de$ // import core.stdc.config; @@ -8151,18 +8576,18 @@ import core.stdc.config; extern (C): /// -// Implement this structure to handle events related to browser display state. -// The functions of this structure will be called on the UI thread. +/// Implement this structure to handle events related to browser display state. +/// The functions of this structure will be called on the UI thread. /// struct cef_display_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Called when a frame's address has changed. + /// Called when a frame's address has changed. /// extern(System) void function ( cef_display_handler_t* self, @@ -8171,7 +8596,7 @@ struct cef_display_handler_t const(cef_string_t)* url) nothrow on_address_change; /// - // Called when the page title changes. + /// Called when the page title changes. /// extern(System) void function ( cef_display_handler_t* self, @@ -8179,7 +8604,7 @@ struct cef_display_handler_t const(cef_string_t)* title) nothrow on_title_change; /// - // Called when the page icon changes. + /// Called when the page icon changes. /// extern(System) void function ( cef_display_handler_t* self, @@ -8187,11 +8612,11 @@ struct cef_display_handler_t cef_string_list_t icon_urls) nothrow on_favicon_urlchange; /// - // Called when web content in the page has toggled fullscreen mode. If - // |fullscreen| is true (1) the content will automatically be sized to fill - // the browser content area. If |fullscreen| is false (0) the content will - // automatically return to its original size and position. The client is - // responsible for resizing the browser if desired. + /// Called when web content in the page has toggled fullscreen mode. If + /// |fullscreen| is true (1) the content will automatically be sized to fill + /// the browser content area. If |fullscreen| is false (0) the content will + /// automatically return to its original size and position. The client is + /// responsible for resizing the browser if desired. /// extern(System) void function ( cef_display_handler_t* self, @@ -8199,12 +8624,12 @@ struct cef_display_handler_t int fullscreen) nothrow on_fullscreen_mode_change; /// - // 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 (1). Otherwise, you can optionally modify - // |text| and then return false (0) 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 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 (1). Otherwise, you can optionally modify + /// |text| and then return false (0) 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. /// extern(System) int function ( cef_display_handler_t* self, @@ -8212,8 +8637,8 @@ struct cef_display_handler_t cef_string_t* text) nothrow on_tooltip; /// - // Called when the browser receives a status message. |value| contains the - // text that will be displayed in the status message. + /// Called when the browser receives a status message. |value| contains the + /// text that will be displayed in the status message. /// extern(System) void function ( cef_display_handler_t* self, @@ -8221,8 +8646,8 @@ struct cef_display_handler_t const(cef_string_t)* value) nothrow on_status_message; /// - // Called to display a console message. Return true (1) to stop the message - // from being output to the console. + /// Called to display a console message. Return true (1) to stop the message + /// from being output to the console. /// extern(System) int function ( cef_display_handler_t* self, @@ -8233,10 +8658,10 @@ struct cef_display_handler_t int line) nothrow on_console_message; /// - // Called when auto-resize is enabled via - // cef_browser_host_t::SetAutoResizeEnabled and the contents have auto- - // resized. |new_size| will be the desired size in view coordinates. Return - // true (1) if the resize was handled or false (0) for default handling. + /// Called when auto-resize is enabled via + /// cef_browser_host_t::SetAutoResizeEnabled and the contents have auto- + /// resized. |new_size| will be the desired size in view coordinates. Return + /// true (1) if the resize was handled or false (0) for default handling. /// extern(System) int function ( cef_display_handler_t* self, @@ -8244,8 +8669,8 @@ struct cef_display_handler_t const(cef_size_t)* new_size) nothrow on_auto_resize; /// - // Called when the overall page loading progress has changed. |progress| - // ranges from 0.0 to 1.0. + /// Called when the overall page loading progress has changed. |progress| + /// ranges from 0.0 to 1.0. /// extern(System) void function ( cef_display_handler_t* self, @@ -8253,10 +8678,10 @@ struct cef_display_handler_t double progress) nothrow on_loading_progress_change; /// - // 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 (1) if the cursor change was handled or false (0) for default - // handling. + /// 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 (1) if the cursor change was handled or false (0) for default + /// handling. /// extern(System) int function ( cef_display_handler_t* self, @@ -8264,12 +8689,22 @@ struct cef_display_handler_t c_ulong cursor, cef_cursor_type_t type, const(cef_cursor_info_t)* custom_cursor_info) nothrow on_cursor_change; + + /// + /// Called when the browser's access to an audio and/or video source has + /// changed. + /// + extern(System) void function ( + cef_display_handler_t* self, + cef_browser_t* browser, + int has_video_access, + int has_audio_access) nothrow on_media_access_change; } // CEF_INCLUDE_CAPI_CEF_DISPLAY_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -8304,28 +8739,28 @@ struct cef_display_handler_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=0517dc6c42fdde9fecfc4549fab1ea12b614e143$ +// $hash=47d8c186f687b65c8e7f394b97d72530e67593cd$ // extern (C): /// -// Structure to implement for visiting the DOM. The functions of this structure -// will be called on the render process main thread. +/// Structure to implement for visiting the DOM. The functions of this structure +/// will be called on the render process main thread. /// struct cef_domvisitor_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Method executed for visiting the DOM. The document object passed to this - // function represents a snapshot of the DOM at the time this function is - // executed. DOM objects are only valid for the scope of this function. Do not - // keep references to or attempt to access any DOM objects outside the scope - // of this function. + /// Method executed for visiting the DOM. The document object passed to this + /// function represents a snapshot of the DOM at the time this function is + /// executed. DOM objects are only valid for the scope of this function. Do + /// not keep references to or attempt to access any DOM objects outside the + /// scope of this function. /// extern(System) void function ( cef_domvisitor_t* self, @@ -8335,92 +8770,92 @@ struct cef_domvisitor_t /// -// Structure used to represent a DOM document. The functions of this structure -// should only be called on the render process main thread thread. +/// Structure used to represent a DOM document. The functions of this structure +/// should only be called on the render process main thread thread. /// struct cef_domdocument_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns the document type. + /// Returns the document type. /// extern(System) cef_dom_document_type_t function (cef_domdocument_t* self) nothrow get_type; /// - // Returns the root document node. + /// Returns the root document node. /// extern(System) cef_domnode_t* function (cef_domdocument_t* self) nothrow get_document; /// - // Returns the BODY node of an HTML document. + /// Returns the BODY node of an HTML document. /// extern(System) cef_domnode_t* function (cef_domdocument_t* self) nothrow get_body; /// - // Returns the HEAD node of an HTML document. + /// Returns the HEAD node of an HTML document. /// extern(System) cef_domnode_t* function (cef_domdocument_t* self) nothrow get_head; /// - // Returns the title of an HTML document. + /// Returns the title of an HTML document. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_domdocument_t* self) nothrow get_title; /// - // Returns the document element with the specified ID value. + /// Returns the document element with the specified ID value. /// extern(System) cef_domnode_t* function ( cef_domdocument_t* self, const(cef_string_t)* id) nothrow get_element_by_id; /// - // Returns the node that currently has keyboard focus. + /// Returns the node that currently has keyboard focus. /// extern(System) cef_domnode_t* function (cef_domdocument_t* self) nothrow get_focused_node; /// - // Returns true (1) if a portion of the document is selected. + /// Returns true (1) if a portion of the document is selected. /// extern(System) int function (cef_domdocument_t* self) nothrow has_selection; /// - // Returns the selection offset within the start node. + /// Returns the selection offset within the start node. /// extern(System) int function (cef_domdocument_t* self) nothrow get_selection_start_offset; /// - // Returns the selection offset within the end node. + /// Returns the selection offset within the end node. /// extern(System) int function (cef_domdocument_t* self) nothrow get_selection_end_offset; /// - // Returns the contents of this selection as markup. + /// Returns the contents of this selection as markup. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_domdocument_t* self) nothrow get_selection_as_markup; /// - // Returns the contents of this selection as text. + /// Returns the contents of this selection as text. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_domdocument_t* self) nothrow get_selection_as_text; /// - // Returns the base URL for the document. + /// Returns the base URL for the document. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_domdocument_t* self) nothrow get_base_url; /// - // Returns a complete URL based on the document base URL and the specified - // partial URL. + /// Returns a complete URL based on the document base URL and the specified + /// partial URL. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( @@ -8431,134 +8866,132 @@ struct cef_domdocument_t /// -// Structure used to represent a DOM node. The functions of this structure -// should only be called on the render process main thread. +/// Structure used to represent a DOM node. The functions of this structure +/// should only be called on the render process main thread. /// struct cef_domnode_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns the type for this node. + /// Returns the type for this node. /// extern(System) cef_dom_node_type_t function (cef_domnode_t* self) nothrow get_type; /// - // Returns true (1) if this is a text node. + /// Returns true (1) if this is a text node. /// extern(System) int function (cef_domnode_t* self) nothrow is_text; /// - // Returns true (1) if this is an element node. + /// Returns true (1) if this is an element node. /// extern(System) int function (cef_domnode_t* self) nothrow is_element; /// - // Returns true (1) if this is an editable node. + /// Returns true (1) if this is an editable node. /// extern(System) int function (cef_domnode_t* self) nothrow is_editable; /// - // Returns true (1) if this is a form control element node. + /// Returns true (1) if this is a form control element node. /// extern(System) int function (cef_domnode_t* self) nothrow is_form_control_element; /// - // Returns the type of this form control element node. + /// Returns the type of this form control element node. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_domnode_t* self) nothrow get_form_control_element_type; /// - // Returns true (1) if this object is pointing to the same handle as |that| - // object. + /// Returns true (1) if this object is pointing to the same handle as |that| + /// object. /// extern(System) int function (cef_domnode_t* self, cef_domnode_t* that) nothrow is_same; /// - // Returns the name of this node. + /// Returns the name of this node. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_domnode_t* self) nothrow get_name; /// - // Returns the value of this node. + /// Returns the value of this node. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_domnode_t* self) nothrow get_value; /// - // Set the value of this node. Returns true (1) on success. + /// Set the value of this node. Returns true (1) on success. /// extern(System) int function (cef_domnode_t* self, const(cef_string_t)* value) nothrow set_value; /// - // Returns the contents of this node as markup. + /// Returns the contents of this node as markup. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_domnode_t* self) nothrow get_as_markup; /// - // Returns the document associated with this node. + /// Returns the document associated with this node. /// extern(System) cef_domdocument_t* function (cef_domnode_t* self) nothrow get_document; /// - // Returns the parent node. + /// Returns the parent node. /// extern(System) cef_domnode_t* function (cef_domnode_t* self) nothrow get_parent; /// - // Returns the previous sibling node. + /// Returns the previous sibling node. /// extern(System) cef_domnode_t* function (cef_domnode_t* self) nothrow get_previous_sibling; /// - // Returns the next sibling node. + /// Returns the next sibling node. /// extern(System) cef_domnode_t* function (cef_domnode_t* self) nothrow get_next_sibling; /// - // Returns true (1) if this node has child nodes. + /// Returns true (1) if this node has child nodes. /// extern(System) int function (cef_domnode_t* self) nothrow has_children; /// - // Return the first child node. + /// Return the first child node. /// extern(System) cef_domnode_t* function (cef_domnode_t* self) nothrow get_first_child; /// - // Returns the last child node. + /// Returns the last child node. /// extern(System) cef_domnode_t* function (cef_domnode_t* self) nothrow get_last_child; - // The following functions are valid only for element nodes. - /// - // Returns the tag name of this element. + /// Returns the tag name of this element. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_domnode_t* self) nothrow get_element_tag_name; /// - // Returns true (1) if this element has attributes. + /// Returns true (1) if this element has attributes. /// extern(System) int function (cef_domnode_t* self) nothrow has_element_attributes; /// - // Returns true (1) if this element has an attribute named |attrName|. + /// Returns true (1) if this element has an attribute named |attrName|. /// extern(System) int function ( cef_domnode_t* self, const(cef_string_t)* attrName) nothrow has_element_attribute; /// - // Returns the element attribute named |attrName|. + /// Returns the element attribute named |attrName|. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( @@ -8566,15 +8999,15 @@ struct cef_domnode_t const(cef_string_t)* attrName) nothrow get_element_attribute; /// - // Returns a map of all element attributes. + /// Returns a map of all element attributes. /// extern(System) void function ( cef_domnode_t* self, cef_string_map_t attrMap) nothrow get_element_attributes; /// - // Set the value for the element attribute named |attrName|. Returns true (1) - // on success. + /// Set the value for the element attribute named |attrName|. Returns true (1) + /// on success. /// extern(System) int function ( cef_domnode_t* self, @@ -8582,14 +9015,15 @@ struct cef_domnode_t const(cef_string_t)* value) nothrow set_element_attribute; /// - // Returns the inner text of the element. + /// Returns the inner text of the element. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_domnode_t* self) nothrow get_element_inner_text; /// - // Returns the bounds of the element. + /// Returns the bounds of the element in device pixels. Use + /// "window.devicePixelRatio" to convert to/from CSS pixels. /// extern(System) cef_rect_t function (cef_domnode_t* self) nothrow get_element_bounds; } @@ -8597,7 +9031,7 @@ struct cef_domnode_t // CEF_INCLUDE_CAPI_CEF_DOM_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -8632,26 +9066,26 @@ struct cef_domnode_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=f0ceb73b289072a01c45c6e7abf339a4ec924d29$ +// $hash=aff139899b4b8b769fd0e506d8a46e434f924eee$ // extern (C): /// -// Callback structure used to asynchronously continue a download. +/// Callback structure used to asynchronously continue a download. /// struct cef_before_download_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // 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 - // (1) if you do wish to show the default "Save As" dialog. + /// 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 + /// (1) if you do wish to show the default "Save As" dialog. /// extern(System) void function ( cef_before_download_callback_t* self, @@ -8662,27 +9096,27 @@ struct cef_before_download_callback_t /// -// Callback structure used to asynchronously cancel a download. +/// Callback structure used to asynchronously cancel a download. /// struct cef_download_item_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Call to cancel the download. + /// Call to cancel the download. /// extern(System) void function (cef_download_item_callback_t* self) nothrow cancel; /// - // Call to pause the download. + /// Call to pause the download. /// extern(System) void function (cef_download_item_callback_t* self) nothrow pause; /// - // Call to resume the download. + /// Call to resume the download. /// extern(System) void function (cef_download_item_callback_t* self) nothrow resume; } @@ -8690,22 +9124,35 @@ struct cef_download_item_callback_t /// -// Structure used to handle file downloads. The functions of this structure will -// called on the browser process UI thread. +/// Structure used to handle file downloads. The functions of this structure +/// will called on the browser process UI thread. /// struct cef_download_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Called before a download begins. |suggested_name| is the suggested name for - // the download file. By default the download will be canceled. Execute - // |callback| either asynchronously or in this function to continue the - // download if desired. Do not keep a reference to |download_item| outside of - // this function. + /// 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_function| is the target function (GET, POST, etc) nothrow. Return + /// true (1) to proceed with the download or false (0) to cancel the download. + /// + extern(System) int function ( + cef_download_handler_t* self, + cef_browser_t* browser, + const(cef_string_t)* url, + const(cef_string_t)* request_method) nothrow can_download; + + /// + /// Called before a download begins. |suggested_name| is the suggested name + /// for the download file. By default the download will be canceled. Execute + /// |callback| either asynchronously or in this function to continue the + /// download if desired. Do not keep a reference to |download_item| outside of + /// this function. /// extern(System) void function ( cef_download_handler_t* self, @@ -8715,11 +9162,11 @@ struct cef_download_handler_t cef_before_download_callback_t* callback) nothrow on_before_download; /// - // Called when a download's status or progress information has been updated. - // This may be called multiple times before and after on_before_download(). - // Execute |callback| either asynchronously or in this function to cancel the - // download if desired. Do not keep a reference to |download_item| outside of - // this function. + /// Called when a download's status or progress information has been updated. + /// This may be called multiple times before and after on_before_download(). + /// Execute |callback| either asynchronously or in this function to cancel the + /// download if desired. Do not keep a reference to |download_item| outside of + /// this function. /// extern(System) void function ( cef_download_handler_t* self, @@ -8731,7 +9178,7 @@ struct cef_download_handler_t // CEF_INCLUDE_CAPI_CEF_DOWNLOAD_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -8766,113 +9213,113 @@ struct cef_download_handler_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=d84044bb582b029af5fa46c75f35b3da948dffd2$ +// $hash=a218058d7ceb842c9ea0cf0c252f9787de6562e7$ // extern (C): /// -// Structure used to represent a download item. +/// Structure used to represent a download item. /// struct cef_download_item_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns true (1) if this object is valid. Do not call any other functions - // if this function returns false (0). + /// Returns true (1) if this object is valid. Do not call any other functions + /// if this function returns false (0). /// extern(System) int function (cef_download_item_t* self) nothrow is_valid; /// - // Returns true (1) if the download is in progress. + /// Returns true (1) if the download is in progress. /// extern(System) int function (cef_download_item_t* self) nothrow is_in_progress; /// - // Returns true (1) if the download is complete. + /// Returns true (1) if the download is complete. /// extern(System) int function (cef_download_item_t* self) nothrow is_complete; /// - // Returns true (1) if the download has been canceled or interrupted. + /// Returns true (1) if the download has been canceled or interrupted. /// extern(System) int function (cef_download_item_t* self) nothrow is_canceled; /// - // Returns a simple speed estimate in bytes/s. + /// Returns a simple speed estimate in bytes/s. /// extern(System) int64 function (cef_download_item_t* self) nothrow get_current_speed; /// - // Returns the rough percent complete or -1 if the receive total size is - // unknown. + /// Returns the rough percent complete or -1 if the receive total size is + /// unknown. /// extern(System) int function (cef_download_item_t* self) nothrow get_percent_complete; /// - // Returns the total number of bytes. + /// Returns the total number of bytes. /// extern(System) int64 function (cef_download_item_t* self) nothrow get_total_bytes; /// - // Returns the number of received bytes. + /// Returns the number of received bytes. /// extern(System) int64 function (cef_download_item_t* self) nothrow get_received_bytes; /// - // Returns the time that the download started. + /// Returns the time that the download started. /// - extern(System) cef_time_t function (cef_download_item_t* self) nothrow get_start_time; + extern(System) cef_basetime_t function (cef_download_item_t* self) nothrow get_start_time; /// - // Returns the time that the download ended. + /// Returns the time that the download ended. /// - extern(System) cef_time_t function (cef_download_item_t* self) nothrow get_end_time; + extern(System) cef_basetime_t function (cef_download_item_t* self) nothrow get_end_time; /// - // Returns the full path to the downloaded or downloading file. + /// Returns the full path to the downloaded or downloading file. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_download_item_t* self) nothrow get_full_path; /// - // Returns the unique identifier for this download. + /// Returns the unique identifier for this download. /// extern(System) uint32 function (cef_download_item_t* self) nothrow get_id; /// - // Returns the URL. + /// Returns the URL. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_download_item_t* self) nothrow get_url; /// - // Returns the original URL before any redirections. + /// Returns the original URL before any redirections. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_download_item_t* self) nothrow get_original_url; /// - // Returns the suggested file name. + /// Returns the suggested file name. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_download_item_t* self) nothrow get_suggested_file_name; /// - // Returns the content disposition. + /// Returns the content disposition. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_download_item_t* self) nothrow get_content_disposition; /// - // Returns the mime type. + /// Returns the mime type. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_download_item_t* self) nothrow get_mime_type; @@ -8881,7 +9328,7 @@ struct cef_download_item_t // CEF_INCLUDE_CAPI_CEF_DOWNLOAD_ITEM_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -8916,160 +9363,160 @@ struct cef_download_item_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=9663321e2be1d000ac54e195c81f210ae40773d1$ +// $hash=9e8375de3d30eb7e4f67488da3568d19848eb038$ // extern (C): /// -// Structure used to represent drag data. The functions of this structure may be -// called on any thread. +/// Structure used to represent drag data. The functions of this structure may +/// be called on any thread. /// struct cef_drag_data_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns a copy of the current object. + /// Returns a copy of the current object. /// extern(System) cef_drag_data_t* function (cef_drag_data_t* self) nothrow clone; /// - // Returns true (1) if this object is read-only. + /// Returns true (1) if this object is read-only. /// extern(System) int function (cef_drag_data_t* self) nothrow is_read_only; /// - // Returns true (1) if the drag data is a link. + /// Returns true (1) if the drag data is a link. /// extern(System) int function (cef_drag_data_t* self) nothrow is_link; /// - // Returns true (1) if the drag data is a text or html fragment. + /// Returns true (1) if the drag data is a text or html fragment. /// extern(System) int function (cef_drag_data_t* self) nothrow is_fragment; /// - // Returns true (1) if the drag data is a file. + /// Returns true (1) if the drag data is a file. /// extern(System) int function (cef_drag_data_t* self) nothrow is_file; /// - // Return the link URL that is being dragged. + /// Return the link URL that is being dragged. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_drag_data_t* self) nothrow get_link_url; /// - // Return the title associated with the link being dragged. + /// Return the title associated with the link being dragged. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_drag_data_t* self) nothrow get_link_title; /// - // Return the metadata, if any, associated with the link being dragged. + /// Return the metadata, if any, associated with the link being dragged. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_drag_data_t* self) nothrow get_link_metadata; /// - // Return the plain text fragment that is being dragged. + /// Return the plain text fragment that is being dragged. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_drag_data_t* self) nothrow get_fragment_text; /// - // Return the text/html fragment that is being dragged. + /// Return the text/html fragment that is being dragged. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_drag_data_t* self) nothrow get_fragment_html; /// - // Return the base URL that the fragment came from. This value is used for - // resolving relative URLs and may be NULL. + /// Return the base URL that the fragment came from. This value is used for + /// resolving relative URLs and may be NULL. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function ( cef_drag_data_t* self) nothrow get_fragment_base_url; /// - // Return the name of the file being dragged out of the browser window. + /// Return the name of the file being dragged out of the browser window. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_drag_data_t* self) nothrow get_file_name; /// - // Write the contents of the file being dragged out of the web view into - // |writer|. Returns the number of bytes sent to |writer|. If |writer| is NULL - // this function will return the size of the file contents in bytes. Call - // get_file_name() to get a suggested name for the file. + /// Write the contents of the file being dragged out of the web view into + /// |writer|. Returns the number of bytes sent to |writer|. If |writer| is + /// NULL this function will return the size of the file contents in bytes. + /// Call get_file_name() to get a suggested name for the file. /// extern(System) size_t function ( cef_drag_data_t* self, cef_stream_writer_t* writer) nothrow get_file_contents; /// - // Retrieve the list of file names that are being dragged into the browser - // window. + /// Retrieve the list of file names that are being dragged into the browser + /// window. /// extern(System) int function ( cef_drag_data_t* self, cef_string_list_t names) nothrow get_file_names; /// - // Set the link URL that is being dragged. + /// Set the link URL that is being dragged. /// extern(System) void function ( cef_drag_data_t* self, const(cef_string_t)* url) nothrow set_link_url; /// - // Set the title associated with the link being dragged. + /// Set the title associated with the link being dragged. /// extern(System) void function ( cef_drag_data_t* self, const(cef_string_t)* title) nothrow set_link_title; /// - // Set the metadata associated with the link being dragged. + /// Set the metadata associated with the link being dragged. /// extern(System) void function ( cef_drag_data_t* self, const(cef_string_t)* data) nothrow set_link_metadata; /// - // Set the plain text fragment that is being dragged. + /// Set the plain text fragment that is being dragged. /// extern(System) void function ( cef_drag_data_t* self, const(cef_string_t)* text) nothrow set_fragment_text; /// - // Set the text/html fragment that is being dragged. + /// Set the text/html fragment that is being dragged. /// extern(System) void function ( cef_drag_data_t* self, const(cef_string_t)* html) nothrow set_fragment_html; /// - // Set the base URL that the fragment came from. + /// Set the base URL that the fragment came from. /// extern(System) void function ( cef_drag_data_t* self, const(cef_string_t)* base_url) nothrow set_fragment_base_url; /// - // Reset the file contents. You should do this before calling - // cef_browser_host_t::DragTargetDragEnter as the web view does not allow us - // to drag in this kind of data. + /// Reset the file contents. You should do this before calling + /// cef_browser_host_t::DragTargetDragEnter as the web view does not allow us + /// to drag in this kind of data. /// extern(System) void function (cef_drag_data_t* self) nothrow reset_file_contents; /// - // Add a file that is being dragged into the webview. + /// Add a file that is being dragged into the webview. /// extern(System) void function ( cef_drag_data_t* self, @@ -9077,18 +9524,23 @@ struct cef_drag_data_t const(cef_string_t)* display_name) nothrow add_file; /// - // Get the image representation of drag data. May return NULL if no image - // representation is available. + /// Clear list of filenames. + /// + extern(System) void function (cef_drag_data_t* self) nothrow clear_filenames; + + /// + /// Get the image representation of drag data. May return NULL if no image + /// representation is available. /// extern(System) cef_image_t* function (cef_drag_data_t* self) nothrow get_image; /// - // Get the image hotspot (drag start location relative to image dimensions). + /// Get the image hotspot (drag start location relative to image dimensions). /// extern(System) cef_point_t function (cef_drag_data_t* self) nothrow get_image_hotspot; /// - // Returns true (1) if an image representation of drag data is available. + /// Returns true (1) if an image representation of drag data is available. /// extern(System) int function (cef_drag_data_t* self) nothrow has_image; } @@ -9096,12 +9548,12 @@ struct cef_drag_data_t /// -// Create a new cef_drag_data_t object. +/// Create a new cef_drag_data_t object. /// cef_drag_data_t* cef_drag_data_create (); // CEF_INCLUDE_CAPI_CEF_DRAG_DATA_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -9136,27 +9588,27 @@ cef_drag_data_t* cef_drag_data_create (); // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=1cc1f134e68406ae3b05f7e181e12f27262772f0$ +// $hash=ec450acb2c3cc4d0e69b7da725387d5c1049773b$ // extern (C): /// -// Implement this structure to handle events related to dragging. The functions -// of this structure will be called on the UI thread. +/// Implement this structure to handle events related to dragging. The functions +/// of this structure will be called on the UI thread. /// struct cef_drag_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // 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 (0) for default drag handling behavior or true (1) - // to cancel the drag event. + /// 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 (0) for default drag handling behavior or true (1) + /// to cancel the drag event. /// extern(System) int function ( cef_drag_handler_t* self, @@ -9165,11 +9617,11 @@ struct cef_drag_handler_t cef_drag_operations_mask_t mask) nothrow on_drag_enter; /// - // 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 function will also - // never be called. If the last draggable region is removed from a document - // this function will be called with an NULL vector. + /// 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 function will also + /// never be called. If the last draggable region is removed from a document + /// this function will be called with an NULL vector. /// extern(System) void function ( cef_drag_handler_t* self, @@ -9182,7 +9634,7 @@ struct cef_drag_handler_t // CEF_INCLUDE_CAPI_CEF_DRAG_HANDLER_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -9217,7 +9669,7 @@ struct cef_drag_handler_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=5d5251098be1477705de2a21502dec2d8338ce00$ +// $hash=b16b1c47d26e911d360159e5535743622a411c31$ // extern (C): @@ -9226,71 +9678,71 @@ extern (C): /// -// Object representing an extension. Methods may be called on any thread unless -// otherwise indicated. +/// Object representing an extension. Methods may be called on any thread unless +/// otherwise indicated. /// struct cef_extension_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Returns the unique extension identifier. This is calculated based on the - // extension public key, if available, or on the extension path. See - // https://developer.chrome.com/extensions/manifest/key for details. + /// Returns the unique extension identifier. This is calculated based on the + /// extension public key, if available, or on the extension path. See + /// https://developer.chrome.com/extensions/manifest/key for details. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_extension_t* self) nothrow get_identifier; /// - // Returns the absolute path to the extension directory on disk. This value - // will be prefixed with PK_DIR_RESOURCES if a relative path was passed to - // cef_request_context_t::LoadExtension. + /// Returns the absolute path to the extension directory on disk. This value + /// will be prefixed with PK_DIR_RESOURCES if a relative path was passed to + /// cef_request_context_t::LoadExtension. /// // The resulting string must be freed by calling cef_string_userfree_free(). extern(System) cef_string_userfree_t function (cef_extension_t* self) nothrow get_path; /// - // Returns the extension manifest contents as a cef_dictionary_value_t object. - // See https://developer.chrome.com/extensions/manifest for details. + /// Returns the extension manifest contents as a cef_dictionary_value_t + /// object. See https://developer.chrome.com/extensions/manifest for details. /// extern(System) cef_dictionary_value_t* function (cef_extension_t* self) nothrow get_manifest; /// - // Returns true (1) if this object is the same extension as |that| object. - // Extensions are considered the same if identifier, path and loader context - // match. + /// Returns true (1) if this object is the same extension as |that| object. + /// Extensions are considered the same if identifier, path and loader context + /// match. /// extern(System) int function (cef_extension_t* self, cef_extension_t* that) nothrow is_same; /// - // Returns the handler for this extension. Will return NULL for internal - // extensions or if no handler was passed to - // cef_request_context_t::LoadExtension. + /// Returns the handler for this extension. Will return NULL for internal + /// extensions or if no handler was passed to + /// cef_request_context_t::LoadExtension. /// extern(System) cef_extension_handler_t* function (cef_extension_t* self) nothrow get_handler; /// - // Returns the request context that loaded this extension. Will return NULL - // for internal extensions or if the extension has been unloaded. See the - // cef_request_context_t::LoadExtension documentation for more information - // about loader contexts. Must be called on the browser process UI thread. + /// Returns the request context that loaded this extension. Will return NULL + /// for internal extensions or if the extension has been unloaded. See the + /// cef_request_context_t::LoadExtension documentation for more information + /// about loader contexts. Must be called on the browser process UI thread. /// extern(System) cef_request_context_t* function ( cef_extension_t* self) nothrow get_loader_context; /// - // Returns true (1) if this extension is currently loaded. Must be called on - // the browser process UI thread. + /// Returns true (1) if this extension is currently loaded. Must be called on + /// the browser process UI thread. /// extern(System) int function (cef_extension_t* self) nothrow is_loaded; /// - // Unload this extension if it is not an internal extension and is currently - // loaded. Will result in a call to - // cef_extension_handler_t::OnExtensionUnloaded on success. + /// Unload this extension if it is not an internal extension and is currently + /// loaded. Will result in a call to + /// cef_extension_handler_t::OnExtensionUnloaded on success. /// extern(System) void function (cef_extension_t* self) nothrow unload; } @@ -9298,7 +9750,7 @@ struct cef_extension_t // CEF_INCLUDE_CAPI_CEF_EXTENSION_CAPI_H_ -// Copyright (c) 2021 Marshall A. Greenblatt. All rights reserved. +// Copyright (c) 2022 Marshall A. Greenblatt. All rights reserved. // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are @@ -9333,7 +9785,7 @@ struct cef_extension_t // by hand. See the translator.README.txt file in the tools directory for // more information. // -// $hash=c952241dabb9d99109ebb64acba0124e43150628$ +// $hash=ba961ade334c82e53213e7e8ac848adc2a7b533a$ // extern (C): @@ -9341,25 +9793,25 @@ extern (C): /// -// Callback structure used for asynchronous continuation of -// cef_extension_handler_t::GetExtensionResource. +/// Callback structure used for asynchronous continuation of +/// cef_extension_handler_t::GetExtensionResource. /// struct cef_get_extension_resource_callback_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Continue the request. Read the resource contents from |stream|. + /// Continue the request. Read the resource contents from |stream|. /// extern(System) void function ( cef_get_extension_resource_callback_t* self, cef_stream_reader_t* stream) nothrow cont; /// - // Cancel the request. + /// Cancel the request. /// extern(System) void function (cef_get_extension_resource_callback_t* self) nothrow cancel; } @@ -9367,54 +9819,55 @@ struct cef_get_extension_resource_callback_t /// -// Implement this structure to handle events related to browser extensions. The -// functions of this structure will be called on the UI thread. See -// cef_request_context_t::LoadExtension for information about extension loading. +/// Implement this structure to handle events related to browser extensions. The +/// functions of this structure will be called on the UI thread. See +/// cef_request_context_t::LoadExtension for information about extension +/// loading. /// struct cef_extension_handler_t { /// - // Base structure. + /// Base structure. /// cef_base_ref_counted_t base; /// - // Called if the cef_request_context_t::LoadExtension request fails. |result| - // will be the error code. + /// Called if the cef_request_context_t::LoadExtension request fails. |result| + /// will be the error code. /// extern(System) void function ( cef_extension_handler_t* self, cef_errorcode_t result) nothrow on_extension_load_failed; /// - // Called if the cef_request_context_t::LoadExtension request succeeds. - // |extension| is the loaded extension. + /// Called if the cef_request_context_t::LoadExtension request succeeds. + /// |extension| is the loaded extension. /// extern(System) void function ( cef_extension_handler_t* self, cef_extension_t* extension) nothrow on_extension_loaded; /// - // Called after the cef_extension_t::Unload request has completed. + /// Called after the cef_extension_t::Unload request has completed. /// extern(System) void function ( cef_extension_handler_t* self, cef_extension_t* extension) nothrow on_extension_unloaded; /// - // Called when an extension needs a browser to host a background script - // specified via the "background" manifest key. The browser will have no - // visible window and cannot be displayed. |extension| is the extension that - // is loading the background script. |url| is an internally generated - // reference to an HTML page that will be used to load the background script - // via a