[uuid(3aaad312-e09d-4010-a013-78ef653dac99)]
interface nsPIWindowWatcher : nsISupports
Methods
A window has been created. Add it to our list.
@param aWindow the window to add
@param aChrome 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.
void
addWindow(in nsIDOMWindow aWindow, in nsIWebBrowserChrome aChrome)
Find a named docshell tree item amongst all windows registered
with the window watcher. This may be a subframe in some window,
for example.
@param aName the name of the window. Must not be null.
@param aRequestor the tree item immediately making the request.
We should make sure to not recurse down into its findItemWithName
method.
@param aOriginalRequestor the original treeitem that made the request.
Used for security checks.
@return 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.
@see findItemWithName methods on nsIDocShellTreeItem and
nsIDocShellTreeOwner
nsIDocShellTreeItem
findItemWithName(in wstring aName, in nsIDocShellTreeItem aRequestor, in nsIDocShellTreeItem aOriginalRequestor)
Like the public interface's open(), but can deal with openDialog
style arguments.
@param aParent parent window, if any. Null if no parent. If it is
impossible to get to an nsIWebBrowserChrome from aParent, this
method will effectively act as if aParent were null.
@param aURL url to which to open the new window. Must already be
escaped, if applicable. can be null.
@param aName window name from JS window.open. can be null.
@param aFeatures window features from JS window.open. can be null.
@param aDialog use dialog defaults (see nsIDOMWindowInternal::openDialog)
@param argc count of argv arguments
@param argv extra JS arguments, if any
(see nsIDOMWindowInternal::openDialog)
@return the new window
nsIDOMWindow
openWindowJS(in nsIDOMWindow aParent, in string aUrl, in string aName, in string aFeatures, in boolean aDialog, in PRUint32 argc, in jsvalptr argv)
A window has been closed. Remove it from our list.
@param aWindow the window to remove
void
removeWindow(in nsIDOMWindow aWindow)
Compare to: