Optional aInstancePtr: objectA run time mechanism for interface discovery.
NS_OK if the interface is supported by the associated instance, NS_NOINTERFACE if it is not.
aInstancePtr must not be null.
[in] A requested interface IID
[out] A pointer to an interface pointer to receive the result.
A method to request that this provider provide a window. The window returned need not to have the right name or parent set on it; setting those is the caller's responsibility. The provider can always return null to have the caller create a brand-new window.
A window the caller should use or null if the caller should just create a new window. The returned window may be newly opened by the nsIWindowProvider implementation or may be a window that already existed.
NS_ERROR_ABORT if the caller should cease its attempt to open a new window.
Must not be null. This is the information the caller wants to be used to construct the new window.
The chrome flags the caller will use to create a new window if this provider returns null. See nsIWebBrowserChrome for the possible values of this field.
The URI to be loaded in the new window (may be NULL). The nsIWindowProvider implementation must not load this URI into the window it returns. This URI is provided solely to help the nsIWindowProvider implementation make decisions; the caller will handle loading the URI in the window returned if provideWindow returns a window.
When making decisions based on aURI, note that even when it's not null, aURI may not represent all relevant information about the load. For example, the load may have extra load flags, POST data, etc.
The name of the window being opened. Setting the name on the return value of provideWindow will be handled by the caller; aName is provided solely to help the nsIWindowProvider implementation make decisions.
The feature string for the window being opened. This may be empty. The nsIWindowProvider implementation is allowed to apply the feature string to the window it returns in any way it sees fit. See the nsIWindowWatcher interface for details on feature strings.
True if this window is opened by window.open with requesting a popup window. This doesn't necessarily mean whether the actual window is shown as minimal popup or not.
Specify setup information of the load in the new window
[out] Whether the window being returned was just created by the window provider implementation. This can be used by callers to keep track of which windows were opened by the user as opposed to being opened programmatically. This should be set to false if the window being returned existed before the provideWindow() call. The value of this out parameter is meaningless if provideWindow() returns null.
Generated using TypeDoc
The nsIWindowProvider interface exists so that the window watcher's default behavior of opening a new window can be easly modified. When the window watcher needs to open a new window, it will first check with the nsIWindowProvider it gets from the parent window. If there is no provider or the provider does not provide a window, the window watcher will proceed to actually open a new window.