mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-08 20:47:44 +00:00
63 lines
2.6 KiB
Plaintext
63 lines
2.6 KiB
Plaintext
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
/**
|
|
* nsIWindowCreator2 is an extension of nsIWindowCreator which allows
|
|
* additional information about the context of the window creation to
|
|
* be passed.
|
|
*
|
|
* @see nsIWindowCreator
|
|
* @see nsIWindowWatcher
|
|
*
|
|
* @status
|
|
*/
|
|
|
|
#include "nsIWindowCreator.idl"
|
|
|
|
interface nsITabParent;
|
|
interface nsIURI;
|
|
interface nsIWebBrowserChrome;
|
|
|
|
[scriptable, uuid(e28f810b-9b49-4927-a4be-62a74fadfe21)]
|
|
|
|
interface nsIWindowCreator2 : nsIWindowCreator {
|
|
|
|
/**
|
|
* Definitions for contextFlags
|
|
*/
|
|
|
|
// Likely that the window is an advertising popup.
|
|
const unsigned long PARENT_IS_LOADING_OR_RUNNING_TIMEOUT = 0x00000001;
|
|
|
|
/** Create a new window. Gecko will/may call this method, if made
|
|
available to it, to create new windows.
|
|
@param parent Parent window, if any. Null if not. The newly created
|
|
window should be made a child/dependent window of
|
|
the parent, if any (and if the concept applies
|
|
to the underlying OS).
|
|
@param chromeFlags Chrome features from nsIWebBrowserChrome
|
|
@param contextFlags Flags about the context of the window being created.
|
|
@param uri The URL for which this window is intended. It can be null
|
|
or zero-length. The implementation of this interface
|
|
may use the URL to help determine what sort of window
|
|
to open or whether to cancel window creation. It will not
|
|
load the URL.
|
|
@param aOpeningTab The TabParent that is trying to open this new chrome
|
|
window. Can be nullptr.
|
|
@param cancel Return |true| to reject window creation. If true the
|
|
implementation has determined the window should not
|
|
be created at all. The caller should not default
|
|
to any possible backup scheme for creating the window.
|
|
@return the new window. Will be null if canceled or an error occurred.
|
|
*/
|
|
nsIWebBrowserChrome createChromeWindow2(in nsIWebBrowserChrome parent,
|
|
in uint32_t chromeFlags,
|
|
in uint32_t contextFlags,
|
|
in nsIURI uri,
|
|
in nsITabParent aOpeningTab,
|
|
out boolean cancel);
|
|
};
|