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.

nsIWebProgressListener2

IID:dde39de0-e4e0-11da-8ad9-0800200c9a66
Inherits From:nsIWebProgressListener

An extended version of nsIWebProgressListener.

This interface is implemented by the following components:


Methods

void onProgressChange64 ( nsIWebProgress webProgress , nsIRequest request , PRInt64 curSelfProgress , PRInt64 maxSelfProgress , PRInt64 curTotalProgress , PRInt64 maxTotalProgress ) PRBool onRefreshAttempted ( nsIWebProgress webProgress , nsIURI refreshURI , PRInt32 millis , PRBool sameURI )

void onProgressChange64 ( nsIWebProgress webProgress , nsIRequest request , PRInt64 curSelfProgress , PRInt64 maxSelfProgress , PRInt64 curTotalProgress , PRInt64 maxTotalProgress )

Notification that the progress has changed for one of the requests associated with webProgress. Progress totals are reset to zero when all requests in webProgress complete (corresponding to onStateChange being called with stateFlags including the STATE_STOP and STATE_IS_WINDOW flags).

This function is identical to nsIWebProgressListener::onProgressChange, except that this function supports 64-bit values.

NOTE: If any progress value is unknown, then its value is replaced with -1.

Arguments:
webProgress: The nsIWebProgress instance that fired the notification.
request: The nsIRequest that has new progress.
curSelfProgress: The current progress for request.
maxSelfProgress: The maximum progress for request.
curTotalProgress: The current progress for all requests associated with webProgress.
maxTotalProgress: The total progress for all requests associated with webProgress.

PRBool onRefreshAttempted ( nsIWebProgress webProgress , nsIURI refreshURI , PRInt32 millis , PRBool sameURI )

Notification that a refresh or redirect has been requested in webProgress For example, via a or an HTTP Refresh: header

Arguments:
webProgress: The nsIWebProgress instance that fired the notification.
refreshURI: The new URI that webProgress has requested redirecting to.
millis: The delay (in milliseconds) before refresh.
sameURI: True if webProgress is requesting a refresh of the current URI. False if webProgress is requesting a redirection to a different URI.
Returns:
True if the refresh may proceed. False if the refresh should be aborted.

References

This interface is passed as an argument to the following methods:

nsIHelperAppLauncher.setWebProgressListener

Reference documentation is generated from Mozilla's source.

Copyright © 1999-2006 XULPlanet.com