The nsIWebProgress interface is used to add or remove nsIWebProgressListener instances to observe the loading of asynchronous requests (usually in the context of a DOM window).
NsIWebProgress instances may be arranged in a parent-child configuration, corresponding to the parent-child configuration of their respective DOM windows. However, in some cases a nsIWebProgress instance may not have an associated DOM window. The parent-child relationship of nsIWebProgress instances is not made explicit by this interface, but the relationship may exist in some implementations.
A nsIWebProgressListener instance receives notifications for the nsIWebProgress instance to which it added itself, and it may also receive notifications from any nsIWebProgress instances that are children of that nsIWebProgress instance.
This interface is implemented by the following components:
readonly nsIDOMWindow DOMWindow
The DOM window associated with this nsIWebProgress instance.
readonly PRBool isLoadingDocument
Indicates whether or not a document is currently being loaded in the context of this nsIWebProgress instance.
void addProgressListener ( nsIWebProgressListener listener , PRUint32 notifyMask )
Registers a listener to receive web progress events.
- listener: The listener interface to be called when a progress event occurs. This object must also implement nsISupportsWeakReference.
- notifyMask: The types of notifications to receive.
void removeProgressListener ( nsIWebProgressListener listener )
Removes a previously registered listener of progress events.
- listener: The listener interface previously registered with a call to addProgressListener.
This interface is passed as an argument to the following methods:
nsIDownloadProgressListener.onLocationChange, nsIDownloadProgressListener.onProgressChange, nsIDownloadProgressListener.onSecurityChange, nsIDownloadProgressListener.onStateChange, nsIDownloadProgressListener.onStatusChange, nsIWebProgressListener.onLocationChange, nsIWebProgressListener.onProgressChange, nsIWebProgressListener.onSecurityChange, nsIWebProgressListener.onStateChange, nsIWebProgressListener.onStatusChange, nsIWebProgressListener2.onProgressChange64
Reference documentation is generated from Mozilla's source.