Please note, this is a STATIC archive of website developer.mozilla.org from November 2016, cach3.com does not collect or store any user information, there is no "phishing" involved.

nsIDownloadProgressListener

 

Imagen:traduccion-pendiente.png 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.


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
<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() en nsIWebProgressListener para más detalles. También puede ser una constante de nsIDownloadManager 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.

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
<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() en nsIWebProgressListener 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()

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
<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

 

Etiquetas y colaboradores del documento

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