Back to index
|void||addWebBrowserListener (in nsIWeakReference aListener, in nsIIDRef aIID)|
|Registers a listener of the type specified by the iid to receive callbacks. |
|void||removeWebBrowserListener (in nsIWeakReference aListener, in nsIIDRef aIID)|
|Removes a previously registered listener. |
|The chrome object associated with the browser instance. |
|URI content listener parent. |
|readonly attribute nsIDOMWindow||contentDOMWindow|
|The top-level DOM window. |
The nsIWebBrowser interface is implemented by web browser objects.
Embedders use this interface during initialisation to associate the new web browser instance with the embedders chrome and to register any listeners. The interface may also be used at runtime to obtain the content DOM window and from that the rest of the DOM.
Registers a listener of the type specified by the iid to receive callbacks.
The browser stores a weak reference to the listener to avoid any circular dependencies. Typically this method will be called to register an object to receive
nsISHistoryListener notifications in which case the the IID is that of the interface.
|aListener||The listener to be added.|
|aIID||The IID of the interface that will be called on the listener as appropriate.|
NS_OKfor successful registration;
NS_ERROR_INVALID_ARGif aIID is not supposed to be registered using this method;
NS_ERROR_FAILUREeither aListener did not expose the interface specified by the IID, or some other internal error occurred.
NS_OK, listener was successfully added;
NS_ERROR_INVALID_ARG, one of the arguments was invalid or the object did not implement the interface specified by the IID.
Removes a previously registered listener.
|aListener||The listener to be removed.|
|aIID||The IID of the interface on the listener that will no longer be called.|
NS_OK, listener was successfully removed;
NS_ERROR_INVALID_ARGarguments was invalid or the object did not implement the interface specified by the IID.
The chrome object associated with the browser instance.
The embedder must create one chrome object for each browser object that is instantiated. The embedder must associate the two by setting this property to point to the chrome object before creating the browser window via the browser's
The chrome object must also implement
The chrome object may optionally implement
nsIWebProgressListener instead of explicitly calling
removeWebBrowserListener to register a progress listener object. If the implementation does this, it must also implement
nsnullvalue is always valid. The embedder must explicitly set this value back to nsnull if the chrome object is destroyed before the browser object.
URI content listener parent.
The embedder may set this property to their own implementation if they intend to override or prevent how certain kinds of content are loaded.