nsIXULWindow is created as part of the creation of a top-level chrome window. When the window is destroyed, it will fire a "xul-window-destroyed" notification through the global observer service. This signals the application in case it needs to quit.
| || || |
| || || |
| || ||The |
| || ||Indicates if this window is instrinsically sized.|
| || || |
The primary content shell.
Note: That this is aRead only.
| || || Provides access to the |
| || ||One of the Z level constants below. On some platforms, windows with a higher zLevel will be kept above windows with a lower zLevel.|
| || |
| || ||The Z level of an independent window opened with the "alwaysLowered" chrome flag.|
| || ||The default Z level of an independent window.|
| || ||The Z level of an independent window opened with the "alwaysRaised" chrome flag.|
| || |
Tell this window that it has picked up a child XUL window.Note that XUL windows do not currently track child XUL windows.
void addChildWindow( in nsIXULWindow aChild );
- The child window being added.
Back-door method to force application of chrome flags at a particular time. Do NOT call this unless you know what you are doing! In particular, calling this when this XUL window does not yet have a document in its
docshell could cause problems.
assumeChromeFlagsAreFrozen()Requires Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)
chromeFlags do not change hereafter, and assert if they do change. The state change is one-way and idempotent.
Move the window to a centered position.
void center( in nsIXULWindow aRelative, in boolean aScreen, in boolean aAlert );
- If not
null, the window relative to which the window is moved. See
aScreenparameter for details.
centerthe window relative to the screen containing
null. If aRelative is
nullthen relative to the screen of the opener window if it was initialized by passing it to
nsWebShellWindow::Initialize. Failing that relative to the main screen.
centerit relative to
aRelativemust be set in this case.)
trueto move the window to an alert position, generally centered horizontally and 1/3 down from the top.
Create a new window.
nsIXULWindow createNewWindow( in PRInt32 aChromeFlags, in nsIAppShell aAppShell );
- The app shell passed to
The newly minted window. In the case of a content window, the function creates a browser window and waits for it to load. You can then load a document into the window's primary content shell.
The content shell specified by the supplied id.
docshelltree item and therefore can not be assured of what object it is. It could be an editor, a
docshell, or a browser object. Or down the road any other object that supports being a DocShellTreeItem Query accordingly to determine the capabilities.
nsIDocShellTreeItem getContentShellById( in wstring ID );
- The ID of the content shell, which is the same as the "type" attribute on the containing frame element.
The tree item corresponding to the given ID, if any.
Tell this window that it has lost a child XUL window. Note that XUL windows do not currently track child XUL windows.
void removeChildWindow( in nsIXULWindow aChild );
- The child window being removed.
Shows the window as a modal window. That is, ensures that it is visible and runs a local event loop, exiting only once the window has been closed.