// Copyright © 2015 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.
using System;
namespace CefSharp
{
///
/// Use this static class to configure some CefSharp specific settings like WcfTimeout
///
public static class CefSharpSettings
{
///
/// Set default values for CefSharpSettings
///
static CefSharpSettings()
{
ShutdownOnExit = true;
#if !NETCOREAPP
WcfTimeout = TimeSpan.FromSeconds(2);
#endif
SubprocessExitIfParentProcessClosed = true;
}
#if !NETCOREAPP
///
/// WCF is used by JavascriptObjectRepository.Register(isAsync: false) feature for
/// Javascript Binding. It's recomended that anyone developing a new application use
/// the JavascriptObjectRepository.Register(isAsync: true) version which communicates
/// using native Chromium IPC.
///
public static bool WcfEnabled { get; set; }
///
/// Change the Close timeout for the WCF channel used by the sync JSB binding.
/// The default value is currently 2 seconds. Changing this to
/// will result on Abort() being called on the WCF Channel Host
///
public static TimeSpan WcfTimeout { get; set; }
#endif
///
/// For the WinForms and WPF instances of ChromiumWebBrowser the relevant Application Exit event
/// is hooked and Cef.Shutdown() called by default. Set this to false to disable this behaviour.
/// This value needs to be set before the first instance of ChromiumWebBrowser is created as
/// the event handlers are hooked in the static constructor for the ChromiumWebBrowser class
///
public static bool ShutdownOnExit { get; set; }
///
/// CefSharp.BrowserSubprocess will monitor the parent process and exit if the parent process closes
/// before the subprocess. This currently defaults to true.
/// See https://github.com/cefsharp/CefSharp/issues/2359 for more information.
///
public static bool SubprocessExitIfParentProcessClosed { get; set; }
///
/// The proxy options that will be used for all connections
///
/// If set before the call to Cef.Initialize, command line arguments will be set for you
/// If a username and password is provided and the IPs match authentication is done automatically
///
/// NOTE: GetAuthCredentials won't be called for a proxy server that matches the IP
/// NOTE: It isn't possble to change the proxy after the call to Cef.Initialize
///
public static ProxyOptions Proxy { get; set; }
///
/// This influences the behavior of how methods are executed for objects registered using
/// .
/// By default the queues Tasks for execution in a sequential order.
/// A single method is exeucted at a time. Setting this property to true allows for concurrent task execution.
/// Method calls are executed on (ThreadPool).
///
public static bool ConcurrentTaskExecution { get; set; }
///
/// If true a message will be sent from the render subprocess to the
/// browser when a DOM node (or no node) gets focus. The default is
/// false.
///
public static bool FocusedNodeChangedEnabled { get; set; }
///
/// CefSharp.WinForms and CefSharp.Wpf.HwndHost ONLY!
/// The default is to create
/// styled browsers, those wanting to use
/// styled browsers can set this property.
///
///
/// Sets the property.
/// You can customise this yourself on a per browser basis
/// by overriding the ChromiumWebBrowser.CreateBrowserWindowInfo
/// property.
///
public static CefRuntimeStyle? RuntimeStyle { get; set; }
}
}