Esta página está traduciéndose a partir del artículo nsIDownloadProgressListener, razón por la cual puede haber algunos errores sintácticos o partes sin traducir. Puedes colaborar continuando con la traducción
El interfaz nsIDownloadProgressListener
da a las aplicaciones y extensiones una manera de vigilar el estado de las descargas que están siendo procesadas por el Administrador de Descargas. Simplemente implementa este interfaz en tu código y llama a la función addListener()
del nsIDownloadManager
para empezar a escuchar.
Cuando no necesites escuchar más al Administrador de Descargas, llama a la función removeListener()
del nsIDownloadManager
para detener la escucha.
Al momento en que los estados de las descargan cambian, los métodos descritos aquí son llamados por el Administrador de Descargas para que tu código realice cualquier acción que necesite.
Esta interfaz trabaja de forma similar a la interfaz nsIWebProgress
.
Inherits from: nsISupports
Descripción del método
void onDownloadStateChange(in short aState, in nsIDownload aDownload) |
void onProgressChange(in nsIWebProgress aWebProgress, in nsIRequest aRequest, in long long aCurSelfProgress, in long long aMaxSelfProgress, in long long aCurTotalProgress, in long long aMaxTotalProgress, in nsIDownload aDownload) |
void onStatusChange(in nsIWebProgress aWebProgress, in nsIRequest aRequest, in nsresult aStatus, in wstring aMessage, in nsIDownload aDownload) |
void onLocationChange(in nsIWebProgress aWebProgress, in nsIRequest aRequest, in nsIURI aLocation, in nsIDownload aDownload) x |
void onSecurityChange(in nsIWebProgress aWebProgress, in nsIRequest aRequest, in unsigned long aState, in nsIDownload aDownload) |
Atributos
Atributo | Tipo | Descripción |
document |
nsIDOMDocument |
El objeto documento que representa la ventana del Administrador de Descargas. |
Métodos
onDownloadStateChange()
Es llamado cuando el estado de una descarga en particular cambia.
void onDownloadStateChange( in short aState, in nsIDownload aDownload );
Parámetros
- <tt>aState</tt>
-
El estado previo de la descarga. Ver
nsIDownloadManager
para una lista de valores posibles.
- <tt>aDownload</tt>
-
El objeto
nsIDownload
que representa el archivo cuyo estado de descarga ha cambiado. Puedes obtener el nuevo estado de la descarga con este método.
onStateChange()
Llamado cuando cambia el estado de una descarga en particular.
void onStateChange( in nsIWebProgress aWebProgress, in nsIRequest aRequest, in unsigned long aStateFlags, in nsresult aStatus, in nsIDownload aDownload );
Parámetros
- <tt>aWebProgress</tt>
-
La instancia
nsIWebProgress
que usa el Administrador de Descargas para vigilar la descarga.
- <tt>aRequest</tt>
-
El
nsIChannel
cuyo estado cambia. Éste parámetro no seráNULL
.
- <tt>aStateFlags</tt>
-
Flags indicandoel nuevo estado de la descarga. Este valores una combinación de uno de los state transition flags documentados en la sección
nsIWebProgressListener
.
- <tt>aStatus</tt>
-
La información del nuevo estado de la descarga. Ver The new state information for the download. See
onStateChange()
ennsIWebProgressListener
para más detalles. También puede ser una constante densIDownloadManager
state constants.
- <tt>aDownload</tt>
- La descarga cuyo estado ha cambiado.
onProgressChange()
Llamado cuando el nivel de progreso de la descarga cambia.
void onProgressChange( in nsIWebProgress aWebProgress, in nsIRequest aRequest, in long long aCurSelfProgress, in long long aMaxSelfProgress, in long long aCurTotalProgress, in long long aMaxTotalProgress, in nsIDownload aDownload );
Parámetros
- <tt>aWebProgress</tt>
-
La instancia
nsIWebProgress
usada por el Administrador de Descargas para vigilar las descargas.
- <tt>aRequest</tt>
-
El
nsIChannel
que ha cambiado de estado. Este parámetro no seráNULL
.
- <tt>aCurSelfProgress</tt>
- La cantidad actual de progreso de la descarga especificada por <tt>aDownload</tt>.
- <tt>aMaxSelfProgress</tt>
- El valor de progreso que debe alcanzarse para dar por finalizada la descarga.
- <tt>aCurTotalProgress</tt>
- La cantidad actual de progreso que se ha hecho en todas las descargas.
- <tt>aMaxTotalProgress</tt>
- El valor que necesita alcanzar el progreso total para determinar que todas las descargas están completadas.
- <tt>aDownload</tt>
-
El objeto
nsIDownload
cuyo progreso está representado por los parámetros <tt>aCurSelfProgress</tt> y <tt>aMaxSelfProgress</tt>.
onStatusChange()
Llamado cuando el estado de una descarga solicita un cambio. El mensaje de estado recibido se quiere que sea bien visible al usuario.
void onStatusChange( in nsIWebProgress aWebProgress, in nsIRequest aRequest, in nsresult aStatus, in wstring aMessage, in nsIDownload aDownload );
Parámetros
- <tt>aWebProgress</tt>
-
La instancia
nsIWebProgress
usada por el Administrador de Descargas para vigilar las descargas.
- <tt>nsIChannel</tt>
-
El
nsIRequest
que cambia de estado. Este parámetro no seráNULL
.
- <tt>aStatus</tt>
-
La información del nuevo estado de la descarga. Ver
onStateChange()
ennsIWebProgressListener
para más detalles.
- <tt>aMessage</tt>
- Un mensaje de estado legible por el usuario, que se quiere presentar muy visible en la pantalla.
- <tt>aDownload</tt>
- La descarga cuyo estado ha cambiado.
onLocationChange()
void onLocationChange( in nsIWebProgress aWebProgress, in nsIRequest aRequest, in nsIURI aLocation, in nsIDownload aDownload );
Parámetros
- <tt>aWebProgress</tt>
-
La instancia
nsIWebProgress
usada por el Administrador de Descargas para vigilar las descargas.
- <tt>aRequest</tt>
-
El
nsIChannel
que ha cambiado de estado. Este parámetro no seráNULL
.
- <tt>aLocation</tt>
- La URI del archivo que se está descargando.
- <tt>aDownload</tt>
-
El objeto
nsIDownload
que representa el archivo que se está descargando.
onSecurityChange()
Llamado cuando el nivel de seguridad usado mientras se hace la descarga cambia. Por ejemplo, si la petición inicial se ha hecho en un servidor HTTPS pero la descarga cambia a un servidor HTTP, esta función es llamada para avisar de la transición
void onSecurityChange( in nsIWebProgress aWebProgress, in nsIRequest aRequest, in unsigned long aState, in nsIDownload aDownload );
Parámetros
- <tt>aWebProgress</tt>
-
La instancia
nsIWebProgress
usada por el Administrador de Descargas para vigilar las descargas.
- <tt>aRequest</tt>
-
El
nsIChannel
que cambia de estado. Este parámetro no seráNULL
.
- <tt>aState</tt>
-
El nuevo estado de la descarga. Ver
nsIDownloadManager
para una lista de valores posibles.
- <tt>aDownload</tt>
- La descarga cuyo nivel de seguridad ha cambiado.
Ver también
nsIDownloadManager
, nsIDownload
, nsIWebProgressListener