WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsIWebBrowserSetup

IID:F15398A0-8018-11d3-AF70-00A024FFC08C
Inherits From:nsISupports
Status:FROZEN

The nsIWebBrowserSetup interface lets you set properties on a browser object; you can do so at any time during the life cycle of the browser.

This interface is implemented by the following components:


Constants

Boolean. Enables/disables plugin support for this browser.

PRUint32 SETUP_ALLOW_PLUGINS = 1
Boolean. Enables/disables Javascript support for this browser.

PRUint32 SETUP_ALLOW_JAVASCRIPT = 2
Boolean. Enables/disables meta redirect support for this browser. Meta redirect timers will be ignored if this option is disabled.

PRUint32 SETUP_ALLOW_META_REDIRECTS = 3
Boolean. Enables/disables subframes within the browser

PRUint32 SETUP_ALLOW_SUBFRAMES = 4
Boolean. Enables/disables image loading for this browser window. If you disable the images, load a page, then enable the images, the page will *not* automatically load the images for the previously loaded page. This flag controls the state of a webBrowser at load time and does not automatically re-load a page when the state is toggled. Reloading must be done by hand, or by walking through the DOM tree and re-setting the src attributes.

PRUint32 SETUP_ALLOW_IMAGES = 5
Boolean. Enables/disables whether the document as a whole gets focus before traversing the document's content, or after traversing its content.

NOTE: this property is obsolete and now has no effect

PRUint32 SETUP_FOCUS_DOC_BEFORE_CONTENT = 6
Boolean. Enables/disables the use of global history in the browser. Visited URLs will not be recorded in the global history when it is disabled.

PRUint32 SETUP_USE_GLOBAL_HISTORY = 256
Boolean. A value of PR_TRUE makes the browser a chrome wrapper. Default is PR_FALSE.

PRUint32 SETUP_IS_CHROME_WRAPPER = 7

Methods

void setProperty ( PRUint32 id , PRUint32 value )

void setProperty ( PRUint32 id , PRUint32 value )

Sets an integer or boolean property on the new web browser object. Only PR_TRUE and PR_FALSE are legal boolean values.

Arguments:
id: The identifier of the property to be set.
value: The value of the property.

Reference documentation is generated from Mozilla's source.