aboutsummaryrefslogtreecommitdiff
path: root/files/es/nsidownload/index.html
blob: 3f0ea1bde1add7bd42a37d10391c2ff7f2ac956b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
---
title: nsIDownload
slug: nsIDownload
tags:
  - Firefox 3
  - Interfaces
  - Todas_las_Categorías
  - páginas_a_traducir
translation_of: Mozilla/Tech/XPCOM/Reference/Interface/nsIDownload
---
<div><div class="blockIndicator obsolete obsoleteHeader"><p><strong><span class="icon-only-inline" title="This is an obsolete API and is no longer guaranteed to work."><i class="icon-trash"> </i></span> Obsoleto</strong><br>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.</p></div></div>

<p> La interfaz <code>nsIDownload</code> describe un objeto descarga. Los objetos descarga son usados por el Administrador de Descargas (ver <code><a href="es/NsIDownloadManager">nsIDownloadManager</a></code> para manejar archivos que están en cola para ser descargados, están siendo descargados y han terminado de ser descargados).</p>

<div class="note"><strong>Nota:</strong> Una vez que la descarga esta completada, el Administrador de Descargas deja de actualizar el objeto <code>nsIDownload</code>. Los estdos de completado son: <code>nsIDownloadManager::DOWNLOAD_FINISHED</code>, <code>nsIDownloadManager::DOWNLOAD_FAILED</code>, y <code>nsIDownloadManager::DOWNLOAD_CANCELED</code>.</div>

<p><br>
 </p><div style="border: solid #ddd 2px; margin-bottom: 12px;">
<div style="background: #eee; padding: 2px;"><code><a href="https://dxr.mozilla.org/mozilla-central/source/toolkit/components/downloads/public/nsIDownload.idl" rel="custom">toolkit/components/downloads/public/nsIDownload.idl</a></code><span style="text-align: right; float: right;"><a href="/en-US/docs/Interfaces/About_Scriptable_Interfaces" style="color: #00cc00; font-weight: 700;">Scriptable</a></span></div>
<span style="padding: 4px 2px;">

<i>Please add a summary to this article.</i>
</span>

<div style="background: #eee; padding: 2px;">
<span> </span>
<span style="text-align: right; float: right;">Last changed in Gecko 1.9 (Firefox 3)</span></div>
</div><p></p>

<p>Inherits from: <code><a href="/es/docs/Mozilla/Tech/XPCOM/Reference/Interface/nsITransfer" title="">nsITransfer</a></code></p>

<h2 id="Atributos" name="Atributos">Atributos</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <td class="header">Attribute</td>
   <td class="header">Type</td>
   <td class="header">Description</td>
  </tr>
  <tr>
   <td><code>targetFile</code></td>
   <td><code><a href="es/NsILocalFile">nsILocalFile</a></code></td>
   <td>Indica la localización donde estará el archivo descargado (o está, si la descarga se ha completado).<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>percentComplete</code></td>
   <td><code><a href="es/PRint32">PRint32</a></code></td>
   <td>El porcentaje de la transferencia que se ha completado, o -1 si el tamaño del archivo es desconocido.<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>amountTransferred</code></td>
   <td><code><a href="es/PRUint64">PRUint64</a></code></td>
   <td>El número de bytes que se han descargado hasta ahora.<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>size</code></td>
   <td><code><a href="es/PRUint64">PRUint64</a></code></td>
   <td>El tamaño total del archivo en bytes o <code>LL_MAXUINT</code>, si el tamaño es desconocido.<em>Sólo lectura'<strong>Read only.</strong></em></td>
  </tr>
  <tr>
   <td><code>source</code></td>
   <td><code><a href="es/NsIURI">nsIURI</a></code></td>
   <td>La URI origen del archivo.<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>cancelable</code></td>
   <td><code><a href="es/NsICancelable">nsICancelable</a></code></td>
   <td>Un objeto que puede ser usado para cancelar la descarga. Una vez que la descarga se ha completado, esta valor se pone a <code>null</code>.<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>displayName</code></td>
   <td><code><a href="es/AString">AString</a></code></td>
   <td>Una descripción, legible por el usuario, de la transferencia.<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>startTime</code></td>
   <td><code>long long</code></td>
   <td>La hora a la que empezó la transferencia.<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>speed</code></td>
   <td><code>double</code></td>
   <td>La velocidad de la transferencia en bytes por segundo.<em>Sólo lectura</em></td>
  </tr>
  <tr>
   <td><code>MIMEInfo</code></td>
   <td><code><a href="es/NsIMIMEInfo">nsIMIMEInfo</a></code></td>
   <td>Este atributo opcional ofrece información relevante del MIME del archivo destino incluyendo el tipo MIME, la aplicación de ayuda y si la aplicación de ayuda debe o no ser llamada al terminar la descarga.</td>
  </tr>
  <tr>
   <td><code>id</code></td>
   <td><code>unsigned long</code></td>
   <td>La ID única por la que se identifica en la base de datos.</td>
  </tr>
  <tr>
   <td><code>state</code></td>
   <td><code>short</code></td>
   <td>El estado actual de la transferencia. Ver <a href="es/NsIDownloadManager#Constants">the nsIDownloadManager constants list</a>.</td>
  </tr>
  <tr>
   <td><code>referrer</code></td>
   <td><code><a href="es/NsIURI">nsIURI</a></code></td>
   <td>La URI referente de la descarga. Esto es sólo válido para descargas HTTP y puede ser <code>null</code>.</td>
  </tr>
  <tr>
   <td><code>resumable</code></td>
   <td><code>boolean</code></td>
   <td>Indica si la descarga puede ser reanudada después de haberse puesto en pausa. Esto es sólo aplicable si la descarga se hace sobre HTTP/1.1 o FTP y el servidor lo admite.</td>
  </tr>
 </tbody>
</table>

<h2 id="Ver_tambi.C3.A9n" name="Ver_tambi.C3.A9n">Ver también</h2>

<p><code><a href="es/NsIDownloadManager">nsIDownloadManager</a></code>, <code><a href="es/NsIDownloadProgressListener">nsIDownloadProgressListener</a></code>, <code><a href="es/NsIXPInstallManagerUI">nsIXPInstallManagerUI</a></code></p>