From a065e04d529da1d847b5062a12c46d916408bf32 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 21:46:22 -0500 Subject: update based on https://github.com/mdn/yari/issues/2028 --- files/es/nsidownloadmanager/index.html | 442 --------------------------------- 1 file changed, 442 deletions(-) delete mode 100644 files/es/nsidownloadmanager/index.html (limited to 'files/es/nsidownloadmanager/index.html') diff --git a/files/es/nsidownloadmanager/index.html b/files/es/nsidownloadmanager/index.html deleted file mode 100644 index 95f09bdf4c..0000000000 --- a/files/es/nsidownloadmanager/index.html +++ /dev/null @@ -1,442 +0,0 @@ ---- -title: nsIDownloadManager -slug: nsIDownloadManager -tags: - - Firefox 3 - - Interfaces - - Todas_las_Categorías -translation_of: Mozilla/Tech/XPCOM/Reference/Interface/nsIDownloadManager ---- -

Obsoleto
Esta funcionalidad es obsoleta. Aunque puede aún funcionar en algunos navegadores, se desalienta su uso ya que puede ser removida en cualquier momento. Evite usarla.

El interfaz nsIDownloadManager permite a las aplicaciones y extensiones comunicarse con el Administrador de Descargas, añadiendo y quitando archivos a descargar, recolectando información sobre las descargas y siendo notificado cuando las descargas son finalizadas.

- -


-

-
toolkit/components/downloads/public/nsIDownloadManager.idlScriptable
- - -Please add a summary to this article. - - -
-  -Last changed in Gecko 1.9 (Firefox 3)
-

- -

Deriva desde: nsISupports

- -

Implementado por: @mozilla.org/download-manager;1. Para crear una unidad, usa:

- -
var dm = Components.classes["@mozilla.org/download-manager;1"]
-                   .createInstance(Components.interfaces.nsIDownloadManager);
-
- -

Descripción del método

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
nsIDownload addDownload(aDownloadType para abreviar, en nsIURI aSource, en nsIURI aTarget, en AString aDisplayName, en nsIMIMEInfo aMIMEInfo, en PRTime aStartTime, en nsILocalFile aTempFile, en nsICancelable aCancelable)
nsIDownload getDownload(in unsigned long aID)
void cancelDownload(in unsigned long aID)
void removeDownload(in unsigned long aID)
void pauseDownload(in unsigned long aID)
void resumeDownload(in unsigned long aID)
void retryDownload(in unsigned long aID)
void cleanUp()
void addListener(in nsIDownloadProgressListener aListener)
void removeListener(in nsIDownloadProgressListener aListener)
- -

Atributos

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
AtributoTipoDescripción
DBConnectionmozIStorageConnectionLa conexión de la base de datos con la base de datos de descargas. Sólo lectura
canCleanUpbooleanSi hay o no descargas que se pueden limpiar (quitar) p.e. descargas completadas, fallidas o canceladas. Sólo lectura
activeDownloadCountlongNúmero de archivos actualmente siendo descargados. Sólo lectura
activeDownloadsnsISimpleEnumeratorEnumeración de los nsIDownloads activos. Sólo lectura
defaultDownloadsDirectorynsILocalFileDevuelve el directorio por defecto (dependiendo del SO) para las descargas. Sólo lectura
userDownloadsDirectorynsILocalFileDevuelve el directorio, configurado por el usuario, para las descargas. Sólo lecturaonly. -

El path depende de dos configuraciones del usuario en las preferencias:

- -

browser.download.folderList define la localización por defecto para los archivos:

- -
    -
  • 0: Los archivos se descargan en el Escritorio por defecto.
    • -
  • 1: Los archivos se descargan en el directorio especificado por el OS por defecto.
    • -
  • 2: Los archivos se descargan en el directorio local especificado por la preferencia browser.download.dir. Si esta preferencia es invalida, la descarga se realiza en el sitio por defecto.
    • -
-
- -

Constantes

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ConstaneValorDescripción
DOWNLOAD_NOTSTARTED-1La descarga no ha comenzado aún.
DOWNLOAD_DOWNLOADING0La descarga esta en proceso de ser descargada.
DOWNLOAD_FINISHED1La descarga ha terminado.
DOWNLOAD_FAILED2La descarga ha fallado.
DOWNLOAD_CANCELED3La descarga fue cancelada por el usuario.
DOWNLOAD_PAUSED4La descarga está actualmente en pausa.
DOWNLOAD_QUEUED5La descarga está en cola pero no está siendo descargada.
DOWNLOAD_BLOCKED6La descarga ha sido bloqueada, bien por un control paterno o el escáner de virus ha determinado que el archivo está infectado y no puede limpiarse.
DOWNLOAD_SCANNING7La descarga está siendo escaneada por la utilidad antivirus.
DOWNLOAD_TYPE_DOWNLOAD0¿Qué es esto?
- -

Métodos

- -

addDownload()

- -

Crea un nsIDownload y lo añade para ser manejado por el Administrador de descargas.

- -
nsIDownload addDownload(
-  in short aDownloadType,
-  in nsIURI aSource,
-  in nsIURI aTarget,
-  in AString aDisplayName,
-  in nsIMIMEInfo aMIMEInfo,
-  in PRTime aStartTime,
-  in nsILocalFile aTempFile,
-  in nsICancelable aCancelable
-)
-
- -
Parámetros
- -
-
aDownloadType
-
El tipo de transferencia de descarga.
-
- -
-
aSource
-
El inicio del URI de transferencia. No debe ser null.
-
- -
-
aTarget
-
El destino del URI dónde debe guardarse la transferencia. No debe ser null.
-
- -
-
aDisplayName
-
Una descripción de la transferencia, legible por el usuario. Puede ser una cadena vacía.
-
- -
-
aMIMEInfo
-
La información MIME asociada con el objetivo. Esto puede incluir el tipo MIME y la aplicación de ayuda en caso necesario. Este parámetro es opcional.
-
- -
-
startTime
-
La hora a la que empezó la descarga.
-
- -
-
aTempFile
-
La localización del archivo temporal (un archivo temporal en el que guardar los datos recibidos, que no es igual que el archivo de destino). El archivo será movido a su localización definitiva indicada por aTarget cuando se complete la descarga. Esto puede ser null.
-
- -
-
aCancelable
-
Un objeto que puede ser utilizado para abortar una descarga. No debe ser null.
-
- -
Valor devuelto
- -

El objeto recientemente creado con las propiedades dadas.

- -
Nota: Agregar una descarga no comienza el proceso de transferencia. Si quieres que sea así, necsitas crear un objeto nsIWebBrowserPersist, llamar al método, poner el progressListener al objeto de descarga devuelto y entonces llamar al método saveURI().
- -

getDownload()

- -

Lee una descarga manejada por el administrador de descargas. La descarga puede estra en proceso, o haber terminado y estar almacenada en la base de datos.

- -
nsIDownload getDownload(
-  in unsigned long aID
-)
-
- -
Parámetros
- -
-
aID
-
La ID única de la descarga.
-
- -
Valor devuelto
- -

TLa descarga con el ID único especificado.

- -
Excepciones
- -
-
NS_ERROR_NOT_AVAILABLE
-
La descarga no está en la base de datos.
-
- -

cancelDownload()

- -

Cancela la descarga que tiene el ID único especificado, si se encuentra en progreso. Esto llama a cancel(NS_BINDING_ABORTED) en el nsICancelable dado por la descarga.

- -
 void cancelDownload(
-   in unsigned long aID
- )
-
- -
Parámetros
- -
-
aID
-
El ID único de la descarga.
-
- -
Excepciones
- -
-
NS_ERROR_FAILURE
-
La descarga no está en progreso.
-
- -

removeDownload()

- -

Quita de la lista, la descarga con el ID único especificado, si ésta no está en progreso. Así como cancelDownload() simplemente cancela la transferencia mientras que la información de la descarga se mantiene, removeDownload() borra todos los datos pertenecientes a la descarga.

- -
 void removeDownload(
-   in unsigned long aID
- )
-
- -
Parámetros
- -
-
aID
-
La ID única de la descarga.
-
- -
Excepciones
- -
-
NS_ERROR_FAILURE
-
La descarga está activa (está en proceso de transferencia).
-
- -

pauseDownload()

- -

Pone la descarga especificada en pausa.

- -
 void pauseDownload(
-   in unsigned long aID
- )
-
- -
Parámetros
- -
-
aID
-
La ID única de la descarga a detener.
-
- -
Excepciones
- -
-
NS_ERROR_FAILURE
-
La descarga no está en proceso.
-
- -

resumeDownload()

- -

Reanuda la descarga especificada.

- -
 void resumeDownload(
-   in unsigned long aID
- )
-
- -
Parámetros
- -
-
aID
-
La ID única de la descarga a reanudar.
-
- -
Excepciones
- -
-
NS_ERROR_FAILURE
-
La descarga no está en progreso.
-
- -

retryDownload()

- -

Reintenta una descarga fallida.

- -
 void retryDownload(
-   in unsigned long aID
- )
-
- -
Parámetros
- -
-
aID
-
La ID única de la descarga.
-
- -
Excepciones
- -
-
NS_ERROR_NOT_AVAILALE
-
si la descarga es desconocida.
-
- -

cleanUp()

- -

Quita de la lista las descargas terminadas, fallidas y canceladas.

- -
 void cleanUp()
-
- -
Parámetros
- -

Ninguno.

- -

addListener()

- -

Agrega una escucha al Administrador de Descargas.

- -
 void addListener(
-   in nsIDownloadProgressListener aListener
- )
-
- -
Parámetros
- -
-
aListener
-
El objeto nsIDownloadProgressListener que recibirá la información de estado desde el Administrador de Descargas.
-
- -

removeListener()

- -

Retira una escucha del Administrador de Descargas.

- -
 void removeListener(
-   in nsIDownloadProgressListener aListener
- )
-
- -
Parámetros
- -
-
aListener
-
El objeto nsIDownloadProgressListener dejará de escuchar al Administrador de Descargas.
-
- -

Ver también

- - -- cgit v1.2.3-54-g00ecf