1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/dom/interfaces/xul/nsIDOMXULDocument.idl Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,71 @@
1.4 +/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
1.5 +/* This Source Code Form is subject to the terms of the Mozilla Public
1.6 + * License, v. 2.0. If a copy of the MPL was not distributed with this
1.7 + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
1.8 +
1.9 +#include "domstubs.idl"
1.10 +#include "nsIDOMDocument.idl"
1.11 +
1.12 +interface nsIDOMXULCommandDispatcher;
1.13 +interface nsIObserver;
1.14 +interface nsIBoxObject;
1.15 +
1.16 +[scriptable, uuid(efdb94fb-642f-4a79-ae20-9a5f7cb7f736)]
1.17 +interface nsIDOMXULDocument : nsIDOMDocument
1.18 +{
1.19 + attribute nsIDOMNode popupNode;
1.20 +
1.21 + /**
1.22 + * These attributes correspond to trustedGetPopupNode().rangeOffset and
1.23 + * rangeParent. They will help you find where in the DOM the popup is
1.24 + * happening. Can be accessed from chrome only, and only during a popup
1.25 + * event. Accessing any other time will be an error.
1.26 + */
1.27 + readonly attribute nsIDOMNode popupRangeParent;
1.28 + readonly attribute long popupRangeOffset;
1.29 +
1.30 + attribute nsIDOMNode tooltipNode;
1.31 +
1.32 + readonly attribute nsIDOMXULCommandDispatcher commandDispatcher;
1.33 +
1.34 + readonly attribute long width;
1.35 + readonly attribute long height;
1.36 +
1.37 + nsIDOMNodeList getElementsByAttribute(in DOMString name,
1.38 + in DOMString value);
1.39 +
1.40 + nsIDOMNodeList getElementsByAttributeNS(in DOMString namespaceURI,
1.41 + in DOMString name,
1.42 + in DOMString value);
1.43 +
1.44 + void addBroadcastListenerFor(in nsIDOMElement broadcaster,
1.45 + in nsIDOMElement observer,
1.46 + in DOMString attr);
1.47 +
1.48 + void removeBroadcastListenerFor(in nsIDOMElement broadcaster,
1.49 + in nsIDOMElement observer,
1.50 + in DOMString attr);
1.51 +
1.52 + void persist(in DOMString id, in DOMString attr);
1.53 +
1.54 + nsIBoxObject getBoxObjectFor(in nsIDOMElement elt);
1.55 +
1.56 + /**
1.57 + * Loads a XUL overlay and merges it with the current document, notifying an
1.58 + * observer when the merge is complete.
1.59 + * @param url
1.60 + * The URL of the overlay to load and merge
1.61 + * @param observer
1.62 + * An object implementing nsIObserver that will be notified with a
1.63 + * message of topic "xul-overlay-merged" when the merge is complete.
1.64 + * The subject parameter of |observe| will QI to a nsIURI - the URI
1.65 + * of the merged overlay. This parameter is optional and may be null.
1.66 + *
1.67 + * NOTICE: In the 2.0 timeframe this API will change such that the
1.68 + * implementation will fire a DOMXULOverlayMerged event upon merge
1.69 + * completion rather than notifying an observer. Do not rely on this
1.70 + * API's behavior _not_ to change because it will!
1.71 + * - Ben Goodger (8/23/2005)
1.72 + */
1.73 + void loadOverlay(in DOMString url, in nsIObserver aObserver);
1.74 +};
