nsIWebProgressListener2

An extended version of nsIWebProgressListener.

Please add a summary to this article.
Last changed in Gecko 1.9 (Firefox 3)

Inherits from: nsIWebProgressListener

Method overview

void onProgressChange64(in nsIWebProgress aWebProgress, in nsIRequest aRequest, in long long aCurSelfProgress, in long long aMaxSelfProgress, in long long aCurTotalProgress, in long long aMaxTotalProgress);
boolean onRefreshAttempted(in nsIWebProgress aWebProgress, in nsIURI aRefreshURI, in long aMillis, in boolean aSameURI);

Methods

onProgressChange64()

Notification that the progress has changed for one of the requests associated with aWebProgress. Progress totals are reset to zero when all requests in aWebProgress complete (corresponding to onStateChange being called with aStateFlags 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.

void onProgressChange64(
  in nsIWebProgress aWebProgress,
  in nsIRequest aRequest,
  in long long aCurSelfProgress,
  in long long aMaxSelfProgress,
  in long long aCurTotalProgress,
  in long long aMaxTotalProgress
);
Parameters
aWebProgress
The nsIWebProgress instance that fired the notification.
aRequest
The nsIRequest that has new progress.
aCurSelfProgress
The current progress for aRequest.
aMaxSelfProgress
The maximum progress for aRequest.
aCurTotalProgress
The current progress for all requests associated with aWebProgress.
aMaxTotalProgress
The total progress for all requests associated with aWebProgress.

onRefreshAttempted()

Notification that a refresh or redirect has been requested in aWebProgress. For example, via a <meta http-equiv="refresh"> or an HTTP Refresh: header.

boolean onRefreshAttempted(
  in nsIWebProgress aWebProgress,
  in nsIURI aRefreshURI,
  in long aMillis,
  in boolean aSameURI
);
Parameters
aWebProgress
The nsIWebProgress instance that fired the notification.
aRefreshURI
The new URI that aWebProgress has requested redirecting to.
aMillis
The delay (in milliseconds) before refresh.
aSameURI
True if aWebProgress is requesting a refresh of the current URI. False if aWebProgress is requesting a redirection to a different URI.
Return value

True if the refresh may proceed. False if the refresh should be aborted.