WARNING: Most of this content (with the exception of the Mozilla 1.9 XPCOM reference) is very old, and can be expected to be out of date and possibly obsolete. For better XUL documentation, please visit the XUL hub at the Mozilla Developer Center.

nsIDOMXULDocument

IID:9816241b-2a20-44ff-903b-575f40c0ecc5
Inherits From:nsISupports

This interface is implemented by the following components:

Properties

readonly nsIDOMXULCommandDispatcher commandDispatcher

readonly PRInt32 height

nsIDOMNode popupNode

readonly PRInt32 popupRangeOffset

readonly nsIDOMNode popupRangeParent

These attributes correspond to trustedGetPopupNode().rangeOffset and rangeParent. They will help you find where in the DOM the popup is happening. Can be accessed from chrome only, and only during a popup event. Accessing any other time will be an error.

nsIDOMNode tooltipNode

readonly PRInt32 width

Methods

void addBroadcastListenerFor ( nsIDOMElement broadcaster , nsIDOMElement observer , DOMString attr ) nsIDOMNodeList getElementsByAttribute ( DOMString name , DOMString value ) nsIDOMNodeList getElementsByAttributeNS ( DOMString namespaceURI , DOMString name , DOMString value ) void loadOverlay ( DOMString url , nsIObserver observer ) void persist ( DOMString id , DOMString attr ) void removeBroadcastListenerFor ( nsIDOMElement broadcaster , nsIDOMElement observer , DOMString attr ) [noscript] nsIDOMNode trustedGetPopupNode ( ) [noscript] nsIDOMNode trustedGetTooltipNode ( )

void addBroadcastListenerFor ( nsIDOMElement broadcaster , nsIDOMElement observer , DOMString attr )

Arguments:
broadcaster
observer
attr

nsIDOMNodeList getElementsByAttribute ( DOMString name , DOMString value )

Arguments:
name
value

nsIDOMNodeList getElementsByAttributeNS ( DOMString namespaceURI , DOMString name , DOMString value )

Arguments:
namespaceURI
name
value

void loadOverlay ( DOMString url , nsIObserver observer )

Loads a XUL overlay and merges it with the current document, notifying an observer when the merge is complete.

NOTICE: In the 2.0 timeframe this API will change such that the implementation will fire a DOMXULOverlayMerged event upon merge completion rather than notifying an observer. Do not rely on this API's behavior _not_ to change because it will! - Ben Goodger (8/23/2005)

Arguments:
url: The URL of the overlay to load and merge
observer: An object implementing nsIObserver that will be notified with a message of topic "xul-overlay-merged" when the merge is complete. The subject parameter of |observe| will QI to a nsIURI - the URI of the merged overlay. This parameter is optional and may be null.

void persist ( DOMString id , DOMString attr )

Arguments:
id
attr

void removeBroadcastListenerFor ( nsIDOMElement broadcaster , nsIDOMElement observer , DOMString attr )

Arguments:
broadcaster
observer
attr

nsIDOMNode trustedGetPopupNode ( )

Get the popup node from this XUL document without doing a security check to make sure that the caller has access to this node. This is for use from C++ callers that can indirectly be called from content.

nsIDOMNode trustedGetTooltipNode ( )

Like trustedGetPopupNode, but gets the tooltip node instead.

Reference documentation is generated from Mozilla's source.