Click or drag to resize
CfxBrowserSettings Class

[This is preliminary documentation and is subject to change.]

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.
Inheritance Hierarchy
SystemObject
  ChromiumCfxObject
    ChromiumCfxStructure
      ChromiumCfxBrowserSettings

Namespace: Chromium
Assembly: ChromiumFX (in ChromiumFX.dll)
Syntax
public sealed class CfxBrowserSettings : CfxStructure

The CfxBrowserSettings type exposes the following members.

Constructors
  NameDescription
Public methodCfxBrowserSettings
Initializes a new instance of the CfxBrowserSettings class
Top
Properties
  NameDescription
Public propertyAcceptLanguageList
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 CfxBrowserSettings.AcceptLanguageList value. If both values are empty then "en-US,en" will be used.
Public propertyApplicationCache
Controls whether the application cache can be used. Also configurable using the "disable-application-cache" command-line switch.
Public propertyBackgroundColor
Opaque background color used for the browser before a document is loaded and when no document color is specified. By default the background color will be the same as CfxSettings.BackgroundColor. Only the RGB compontents of the specified value will be used. The alpha component must greater than 0 to enable use of the background color but will be otherwise ignored.
Public propertyCursiveFontFamily
Public propertyDatabases
Controls whether databases can be used. Also configurable using the "disable-databases" command-line switch.
Public propertyDefaultEncoding
Default encoding for Web content. If empty "ISO-8859-1" will be used. Also configurable using the "default-encoding" command-line switch.
Public propertyDefaultFixedFontSize
Public propertyDefaultFontSize
Public propertyFantasyFontFamily
Public propertyFileAccessFromFileUrls
Controls whether file URLs will have access to other file URLs. Also configurable using the "allow-access-from-files" command-line switch.
Public propertyFixedFontFamily
Public propertyImageLoading
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.
Public propertyImageShrinkStandaloneToFit
Controls whether standalone images will be shrunk to fit the page. Also configurable using the "image-shrink-standalone-to-fit" command-line switch.
Public propertyJavascript
Controls whether JavaScript can be executed. Also configurable using the "disable-javascript" command-line switch.
Public propertyJavascriptAccessClipboard
Controls whether JavaScript can access the clipboard. Also configurable using the "disable-javascript-access-clipboard" command-line switch.
Public propertyJavascriptCloseWindows
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.
Public propertyJavascriptDomPaste
Controls whether DOM pasting is supported in the editor via execCommand("paste"). The |javascriptAccessClipboard| setting must also be enabled. Also configurable using the "disable-javascript-dom-paste" command-line switch.
Public propertyJavascriptOpenWindows
Controls whether JavaScript can be used for opening windows. Also configurable using the "disable-javascript-open-windows" command-line switch.
Public propertyLocalStorage
Controls whether local storage can be used. Also configurable using the "disable-local-storage" command-line switch.
Public propertyMinimumFontSize
Public propertyMinimumLogicalFontSize
Public propertyPlugins
Controls whether any plugins will be loaded. Also configurable using the "disable-plugins" command-line switch.
Public propertyRemoteFonts
Controls the loading of fonts from remote sources. Also configurable using the "disable-remote-fonts" command-line switch.
Public propertySansSerifFontFamily
Public propertySerifFontFamily
Public propertyStandardFontFamily
Font settings.
Public propertyTabToLinks
Controls whether the tab key can advance focus to links. Also configurable using the "disable-tab-to-links" command-line switch.
Public propertyTextAreaResize
Controls whether text areas can be resized. Also configurable using the "disable-text-area-resize" command-line switch.
Public propertyUniversalAccessFromFileUrls
Controls whether file URLs will have access to all URLs. Also configurable using the "allow-universal-access-from-files" command-line switch.
Public propertyWebgl
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.
Public propertyWebSecurity
Controls whether web security restrictions (same-origin policy) will be enforced. Disabling this setting is not recommend as it will allow risky security behavior such as cross-site scripting (XSS). Also configurable using the "disable-web-security" command-line switch.
Public propertyWindowlessFrameRate
The maximum rate in frames per second (fps) that CfxRenderHandler.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 CfxBrowserHost.SetWindowlessFrameRate.
Top
Remarks
See also the original CEF documentation in cef/include/internal/cef_types.h.
See Also