// Copyright © 2010 The CefSharp Authors. All rights reserved. // // Use of this source code is governed by a BSD-style license that can be found in the LICENSE file. #pragma once #include "Stdafx.h" using namespace System::Collections::Generic; using namespace System::IO; namespace CefSharp { namespace Core { /// /// Initialization settings. Many of these and other settings can also configured using command-line switches. /// WPF/WinForms/OffScreen each have their own CefSettings implementation that sets /// relevant settings e.g. OffScreen starts with audio muted. /// [System::ComponentModel::EditorBrowsableAttribute(System::ComponentModel::EditorBrowsableState::Never)] public ref class CefSettingsBase sealed { private: /// /// Command Line Arguments Dictionary. /// CommandLineArgDictionary^ _cefCommandLineArgs; internal: /// /// CefSettings unmanaged pointer /// ::CefSettings* _cefSettings; /// /// CefCustomScheme collection /// List^ _cefCustomSchemes; public: /// /// Default Constructor. /// CefSettingsBase() : _cefSettings(new ::CefSettings()) { _cefSettings->multi_threaded_message_loop = true; _cefSettings->no_sandbox = true; BrowserSubprocessPath = Path::Combine(Path::GetDirectoryName(CefSettingsBase::typeid->Assembly->Location), "CefSharp.BrowserSubprocess.exe"); _cefCustomSchemes = gcnew List(); _cefCommandLineArgs = gcnew CommandLineArgDictionary(); } /// /// Finalizer. /// !CefSettingsBase() { _cefSettings = nullptr; } /// /// Destructor. /// ~CefSettingsBase() { this->!CefSettingsBase(); } /// /// Add Customs schemes to this collection. /// property IEnumerable^ CefCustomSchemes { IEnumerable^ get() { return _cefCustomSchemes; } } /// /// Add custom command line argumens to this collection, they will be added in OnBeforeCommandLineProcessing. The /// CefSettings.CommandLineArgsDisabled value can be used to start with an empty command-line object. Any values specified in /// CefSettings that equate to command-line arguments will be set before this method is called. /// property CommandLineArgDictionary^ CefCommandLineArgs { CommandLineArgDictionary^ get() { return _cefCommandLineArgs; } } /// /// Set to true 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 by adding to CefCommandLineArgs. /// property bool CommandLineArgsDisabled { bool get() { return _cefSettings->command_line_args_disabled == 1; } void set(bool value) { _cefSettings->command_line_args_disabled = value; } } /// /// Set to true to control browser process main (UI) thread message pump scheduling via the /// IBrowserProcessHandler.OnScheduleMessagePumpWork callback. This option is recommended for use in combination with the /// Cef.DoMessageLoopWork() function in cases where the CEF message loop must be integrated into an existing application message /// loop (see additional comments and warnings on Cef.DoMessageLoopWork). Enabling this option is not recommended for most users; /// leave this option disabled and use either MultiThreadedMessageLoop (the default) if possible. /// property bool ExternalMessagePump { bool get() { return _cefSettings->external_message_pump == 1; } void set(bool value) { _cefSettings->external_message_pump = value; } } /// /// Set to true to have the browser process message loop run in a separate thread. If false than the CefDoMessageLoopWork() /// function must be called from your application message loop. This option is only supported on Windows. The default value is /// true. /// property bool MultiThreadedMessageLoop { bool get() { return _cefSettings->multi_threaded_message_loop == 1; } void set(bool value) { _cefSettings->multi_threaded_message_loop = value; } } /// /// The path to a separate executable that will be launched for sub-processes. By default the browser process executable is used. /// See the comments on Cef.ExecuteProcess() 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. /// Defaults to using the provided CefSharp.BrowserSubprocess.exe instance /// property String^ BrowserSubprocessPath { String^ get() { return StringUtils::ToClr(_cefSettings->browser_subprocess_path); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->browser_subprocess_path, value); } } /// /// The location where data for the global browser cache will be stored on disk. In this value is non-empty then it must be /// an absolute path that is must be either equal to or a child directory of CefSettings.RootCachePath (if RootCachePath is /// empty it will default to this value). If the value is empty then browsers will be created in "incognito mode" where /// in-memory caches are used for storage and no data is persisted to disk. HTML5 databases such as localStorage will only /// persist across sessions if a cache path is specified. Can be overridden for individual RequestContext instances via the /// RequestContextSettings.CachePath value. /// property String^ CachePath { String^ get() { return StringUtils::ToClr(_cefSettings->cache_path); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->cache_path, value); } } /// /// The root directory for installation-specific data and the parent directory for profile-specific data. /// All CachePath and RequestContextSettings.CachePath" values must have this parent directory /// in common. If this value is empty and is non-empty then it will default to the /// CachePath value. Any non-empty value must be an absolute path. If both values are empty then /// the default platform-specific directory will be used ("AppData\Local\CEF\User Data" directory under the user /// profile directory on Windows). /// /// **Use of the default directory is not recommended in production applications(see below).** /// /// Multiple application instances writing to the same RootCachePath directory could result in data corruption. /// A process singleton lock based on the RootCachePath value is therefore used to protect against this. /// This singleton behavior applies to all CEF-based applications using version 120 or newer. /// You should customize RootCachePath for your application and implement IBrowserProcessHandler.OnAlreadyRunningAppRelaunch, /// which will then be called on any app relaunch with the same RootCachePath value. /// /// Failure to set the RootCachePath value correctly may result in startup crashes or other unexpected behaviors /// property String^ RootCachePath { String^ get() { return StringUtils::ToClr(_cefSettings->root_cache_path); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->root_cache_path, value); } } /// /// The locale string that will be passed to WebKit. If empty the default locale of "en-US" will be used. Also configurable using /// the "lang" command-line switch. /// property String^ Locale { String^ get() { return StringUtils::ToClr(_cefSettings->locale); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->locale, value); } } /// /// 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. Also configurable using the "locales-dir-path" /// command-line switch. /// property String^ LocalesDirPath { String^ get() { return StringUtils::ToClr(_cefSettings->locales_dir_path); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->locales_dir_path, value); } } /// /// The fully qualified path for the resources directory. If this value is empty the cef.pak and/or devtools_resources.pak files /// must be located in the module directory. Also configurable using the "resources-dir-path" command-line switch. /// property String^ ResourcesDirPath { String^ get() { return StringUtils::ToClr(_cefSettings->resources_dir_path); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->resources_dir_path, value); } } /// /// 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 /// a "debug.log" file will be written in the main executable directory. Also configurable using the"log-file" command- line /// switch. /// property String^ LogFile { String^ get() { return StringUtils::ToClr(_cefSettings->log_file); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->log_file, value); } } /// /// The log severity. Only messages of this severity level or higher will be logged. When set to /// 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", "error-report" or "disable". /// property CefSharp::LogSeverity LogSeverity { CefSharp::LogSeverity get() { return (CefSharp::LogSeverity)_cefSettings->log_severity; } void set(CefSharp::LogSeverity value) { _cefSettings->log_severity = (cef_log_severity_t)value; } } /// /// 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. /// property String^ JavascriptFlags { String^ get() { return StringUtils::ToClr(_cefSettings->javascript_flags); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->javascript_flags, value); } } /// /// 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. /// property String^ UserAgentProduct { String^ get() { return StringUtils::ToClr(_cefSettings->user_agent_product); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->user_agent_product, value); } } /// /// 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. /// property int RemoteDebuggingPort { int get() { return _cefSettings->remote_debugging_port; } void set(int value) { _cefSettings->remote_debugging_port = value; } } /// /// 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. /// property int UncaughtExceptionStackSize { int get() { return _cefSettings->uncaught_exception_stack_size; } void set(int value) { _cefSettings->uncaught_exception_stack_size = value; } } /// /// 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. /// property String^ UserAgent { String^ get() { return StringUtils::ToClr(_cefSettings->user_agent); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->user_agent, value); } } /// /// 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. /// property bool WindowlessRenderingEnabled { bool get() { return _cefSettings->windowless_rendering_enabled == 1; } void set(bool value) { _cefSettings->windowless_rendering_enabled = value; } } /// /// The directory 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 RootCachePath. If this value is empty then browsers will be created in "incognito mode" /// where in-memory caches are used for storage and no profile-specific data is persisted to disk /// (installation-specific data will still be persisted in RootCachePath). HTML5 databases /// such as localStorage will only persist across sessions if a cache path is specified. /// Can be overridden for individual RequestContext instances via the RequestContextSettings.CachePath value. /// Any child directory value will be ignored and the "default" profile (also a child directory) will be used /// instead. /// property bool PersistSessionCookies { bool get() { return _cefSettings->persist_session_cookies == 1; } void set(bool value) { _cefSettings->persist_session_cookies = value; } } /// /// 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.AcceptLanguageList value. If both values are empty then "en-US,en" will be used. /// /// property String^ AcceptLanguageList { String^ get() { return StringUtils::ToClr(_cefSettings->accept_language_list); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->accept_language_list, value); } } /// /// Background color used for the browser before a document is loaded and when no document color is specified. The alpha /// component must be either fully opaque (0xFF) or fully transparent (0x00). If the alpha component is fully opaque then the RGB /// components will be used as the background color. If the alpha component is fully transparent for a WinForms browser then the /// default value of opaque white be used. If the alpha component is fully transparent for a windowless (WPF/OffScreen) browser /// then transparent painting will be enabled. /// property uint32_t BackgroundColor { uint32_t get() { return _cefSettings->background_color; } void set(uint32_t value) { _cefSettings->background_color = value; } } /// /// Comma delimited list of schemes supported by the associated /// ICookieManager. If CookieableSchemesExcludeDefaults is false the /// default schemes ("http", "https", "ws" and "wss") will also be supported. /// Specifying a CookieableSchemesList value and setting /// CookieableSchemesExcludeDefaults to true will disable all loading /// and saving of cookies for this manager. Can be overridden /// for individual RequestContext instances via the /// RequestContextSettings.CookieableSchemesList and /// RequestContextSettings.CookieableSchemesExcludeDefaults values. /// property String^ CookieableSchemesList { String^ get() { return StringUtils::ToClr(_cefSettings->cookieable_schemes_list); } void set(String^ value) { StringUtils::AssignNativeFromClr(_cefSettings->cookieable_schemes_list, value); } } /// /// If CookieableSchemesExcludeDefaults is false the /// default schemes ("http", "https", "ws" and "wss") will also be supported. /// Specifying a CookieableSchemesList value and setting /// CookieableSchemesExcludeDefaults to true will disable all loading /// and saving of cookies for this manager. Can be overridden /// for individual RequestContext instances via the /// RequestContextSettings.CookieableSchemesList and /// RequestContextSettings.CookieableSchemesExcludeDefaults values. /// property bool CookieableSchemesExcludeDefaults { bool get() { return _cefSettings->cookieable_schemes_exclude_defaults == 1; } void set(bool value) { _cefSettings->cookieable_schemes_exclude_defaults = value; } } /// /// Registers a custom scheme using the provided settings. /// /// The CefCustomScheme which provides the details about the scheme. void RegisterScheme(CefCustomScheme^ cefCustomScheme) { //Scheme names are converted to lowercase cefCustomScheme->SchemeName = cefCustomScheme->SchemeName->ToLower(); _cefCustomSchemes->Add(cefCustomScheme); } }; } }