nsPIWindowWatcher

IID:3aaad312-e09d-4010-a013-78ef653dac99
Inherits From:nsISupports

Methods

void addWindow ( nsIDOMWindow window , nsIWebBrowserChrome chrome ) nsIDocShellTreeItem findItemWithName ( PRUnichar* name , nsIDocShellTreeItem requestor , nsIDocShellTreeItem originalRequestor ) nsIDOMWindow openWindowJS ( nsIDOMWindow parent , char* url , char* name , char* features , PRBool dialog , PRUint32 argc , jsvalptr* argv ) void removeWindow ( nsIDOMWindow window )

void addWindow ( nsIDOMWindow window , nsIWebBrowserChrome chrome )

A window has been created. Add it to our list.

Arguments:
window: the window to add
chrome: the corresponding chrome window. The DOM window and chrome will be mapped together, and the corresponding chrome can be retrieved using the (not private) method getChromeForWindow. If null, any extant mapping will be cleared.

nsIDocShellTreeItem findItemWithName ( PRUnichar* name , nsIDocShellTreeItem requestor , nsIDocShellTreeItem originalRequestor )

Find a named docshell tree item amongst all windows registered with the window watcher. This may be a subframe in some window, for example.

Arguments:
name: the name of the window. Must not be null.
requestor: the tree item immediately making the request. We should make sure to not recurse down into its findItemWithName method.
originalRequestor: the original treeitem that made the request. Used for security checks.
Returns:
the tree item with aName as the name, or null if there isn't one. "Special" names, like _self, _top, etc, will be treated specially only if aRequestor is null; in that case they will be resolved relative to the first window the windowwatcher knows about.

nsIDOMWindow openWindowJS ( nsIDOMWindow parent , char* url , char* name , char* features , PRBool dialog , PRUint32 argc , jsvalptr* argv )

Like the public interface's open(), but can deal with openDialog style arguments.

Arguments:
parent: parent window, if any. Null if no parent. If it is impossible to get to an nsIWebBrowserChrome from parent, this method will effectively act as if parent were null.
url
name: window name from JS window.open. can be null.
features: window features from JS window.open. can be null.
dialog: use dialog defaults (see nsIDOMWindowInternal::openDialog)
argc: count of argv arguments
argv: extra JS arguments, if any (see nsIDOMWindowInternal::openDialog)
Returns:
the new window

void removeWindow ( nsIDOMWindow window )

A window has been closed. Remove it from our list.

Arguments:
window: the window to remove

Reference documentation is generated from Mozilla's source.

Add a note User Contributed Notes
No comments available

Copyright © 1999 - 2005 XULPlanet.com