• file
• revisions
• annotate
• diff
• comparison
• raw

dom/interfaces/xul/nsIDOMXULDocument.idl@7e26c7da4463 (annotated)

dom/interfaces/xul/nsIDOMXULDocument.idl

Wed, 31 Dec 2014 06:55:50 +0100

author

Michael Schloh von Bennewitz <michael@schloh.com>

date

Wed, 31 Dec 2014 06:55:50 +0100

changeset 2

7e26c7da4463

permissions

-rw-r--r--

Added tag UPSTREAM_283F7C6 for changeset ca08bd8f51b2

michael@0	1	/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
michael@0	2	/* This Source Code Form is subject to the terms of the Mozilla Public
michael@0	3	* License, v. 2.0. If a copy of the MPL was not distributed with this
michael@0	4	* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
michael@0	5
michael@0	6	#include "domstubs.idl"
michael@0	7	#include "nsIDOMDocument.idl"
michael@0	8
michael@0	9	interface nsIDOMXULCommandDispatcher;
michael@0	10	interface nsIObserver;
michael@0	11	interface nsIBoxObject;
michael@0	12
michael@0	13	[scriptable, uuid(efdb94fb-642f-4a79-ae20-9a5f7cb7f736)]
michael@0	14	interface nsIDOMXULDocument : nsIDOMDocument
michael@0	15	{
michael@0	16	attribute nsIDOMNode popupNode;
michael@0	17
michael@0	18	/**
michael@0	19	* These attributes correspond to trustedGetPopupNode().rangeOffset and
michael@0	20	* rangeParent. They will help you find where in the DOM the popup is
michael@0	21	* happening. Can be accessed from chrome only, and only during a popup
michael@0	22	* event. Accessing any other time will be an error.
michael@0	23	*/
michael@0	24	readonly attribute nsIDOMNode popupRangeParent;
michael@0	25	readonly attribute long popupRangeOffset;
michael@0	26
michael@0	27	attribute nsIDOMNode tooltipNode;
michael@0	28
michael@0	29	readonly attribute nsIDOMXULCommandDispatcher commandDispatcher;
michael@0	30
michael@0	31	readonly attribute long width;
michael@0	32	readonly attribute long height;
michael@0	33
michael@0	34	nsIDOMNodeList getElementsByAttribute(in DOMString name,
michael@0	35	in DOMString value);
michael@0	36
michael@0	37	nsIDOMNodeList getElementsByAttributeNS(in DOMString namespaceURI,
michael@0	38	in DOMString name,
michael@0	39	in DOMString value);
michael@0	40
michael@0	41	void addBroadcastListenerFor(in nsIDOMElement broadcaster,
michael@0	42	in nsIDOMElement observer,
michael@0	43	in DOMString attr);
michael@0	44
michael@0	45	void removeBroadcastListenerFor(in nsIDOMElement broadcaster,
michael@0	46	in nsIDOMElement observer,
michael@0	47	in DOMString attr);
michael@0	48
michael@0	49	void persist(in DOMString id, in DOMString attr);
michael@0	50
michael@0	51	nsIBoxObject getBoxObjectFor(in nsIDOMElement elt);
michael@0	52
michael@0	53	/**
michael@0	54	* Loads a XUL overlay and merges it with the current document, notifying an
michael@0	55	* observer when the merge is complete.
michael@0	56	* @param url
michael@0	57	* The URL of the overlay to load and merge
michael@0	58	* @param observer
michael@0	59	* An object implementing nsIObserver that will be notified with a
michael@0	60	* message of topic "xul-overlay-merged" when the merge is complete.
michael@0	61	* The subject parameter of |observe| will QI to a nsIURI - the URI
michael@0	62	* of the merged overlay. This parameter is optional and may be null.
michael@0	63	*
michael@0	64	* NOTICE: In the 2.0 timeframe this API will change such that the
michael@0	65	* implementation will fire a DOMXULOverlayMerged event upon merge
michael@0	66	* completion rather than notifying an observer. Do not rely on this
michael@0	67	* API's behavior _not_ to change because it will!
michael@0	68	* - Ben Goodger (8/23/2005)
michael@0	69	*/
michael@0	70	void loadOverlay(in DOMString url, in nsIObserver aObserver);
michael@0	71	};