We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

nsIDownloadProgressListener

Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

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.


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

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
aState
El estado previo de la descarga. Ver nsIDownloadManager para una lista de valores posibles.
aDownload
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
aWebProgress
La instancia nsIWebProgress que usa el Administrador de Descargas para vigilar la descarga.
aRequest
El nsIChannel cuyo estado cambia. Éste parámetro no será NULL.
aStateFlags
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.
aStatus
La información del nuevo estado de la descarga. Ver The new state information for the download. See onStateChange() en nsIWebProgressListener para más detalles. También puede ser una constante de nsIDownloadManager state constants.
aDownload
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
aWebProgress
La instancia nsIWebProgress usada por el Administrador de Descargas para vigilar las descargas.
aRequest
El nsIChannel que ha cambiado de estado. Este parámetro no será NULL.
aCurSelfProgress
La cantidad actual de progreso de la descarga especificada por aDownload.
aMaxSelfProgress
El valor de progreso que debe alcanzarse para dar por finalizada la descarga.
aCurTotalProgress
La cantidad actual de progreso que se ha hecho en todas las descargas.
aMaxTotalProgress
El valor que necesita alcanzar el progreso total para determinar que todas las descargas están completadas.
aDownload
El objeto nsIDownload cuyo progreso está representado por los parámetros aCurSelfProgress y aMaxSelfProgress.

onStatusChange()

Llamado cuando el estado de una descarga solicita un cambio. El mensaje de estado recibido se quiere que sea bien visible al usuario.

Atención: Este método ya no está en Firefox 3 (Gecko 1.9). En versiones anteriores, este método nunca fue usado.
 void onStatusChange(
   in nsIWebProgress aWebProgress,
   in nsIRequest aRequest,
   in nsresult aStatus,
   in wstring aMessage,
   in nsIDownload aDownload
 );
Parámetros
aWebProgress
La instancia nsIWebProgress usada por el Administrador de Descargas para vigilar las descargas.
nsIChannel
El nsIRequest que cambia de estado. Este parámetro no será NULL.
aStatus
La información del nuevo estado de la descarga. Ver onStateChange() en nsIWebProgressListener para más detalles.
aMessage
Un mensaje de estado legible por el usuario, que se quiere presentar muy visible en la pantalla.
aDownload
La descarga cuyo estado ha cambiado.

onLocationChange()

Atención: Este método ya no está en Firefox 3 (Gecko 1.9). En versiones anteriores, este método nunca fue usado.
 void onLocationChange(
   in nsIWebProgress aWebProgress,
   in nsIRequest aRequest,
   in nsIURI aLocation,
   in nsIDownload aDownload
 );

 

Parámetros
aWebProgress
La instancia nsIWebProgress usada por el Administrador de Descargas para vigilar las descargas.
aRequest
El nsIChannel que ha cambiado de estado. Este parámetro no será NULL.
aLocation
La URI del archivo que se está descargando.
aDownload
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
aWebProgress
La instancia nsIWebProgress usada por el Administrador de Descargas para vigilar las descargas.
aRequest
El nsIChannel que cambia de estado. Este parámetro no será NULL.
aState
El nuevo estado de la descarga. Ver nsIDownloadManager para una lista de valores posibles.
aDownload
La descarga cuyo nivel de seguridad ha cambiado.

Ver también

nsIDownloadManager, nsIDownload, nsIWebProgressListener

Etiquetas y colaboradores del documento

Colaboradores en esta página: SphinxKnight, teoli, HenryGR, Mgjbot
Última actualización por: SphinxKnight,