diff options
Diffstat (limited to 'files/es/nsiwebprogress/index.html')
-rw-r--r-- | files/es/nsiwebprogress/index.html | 233 |
1 files changed, 233 insertions, 0 deletions
diff --git a/files/es/nsiwebprogress/index.html b/files/es/nsiwebprogress/index.html new file mode 100644 index 0000000000..3b9fbb8ff0 --- /dev/null +++ b/files/es/nsiwebprogress/index.html @@ -0,0 +1,233 @@ +--- +title: nsIWebProgress +slug: nsIWebProgress +tags: + - Interfaces + - 'Interfaces:Frozen' + - 'Interfaces:Scriptable' + - Todas_las_Categorías + - páginas_a_traducir +translation_of: Mozilla/Tech/XPCOM/Reference/Interface/nsIWebProgress +--- +<p>« <a href="/en-US/docs/XPCOM_API_Reference">XPCOM API Reference</a></p> + +<h3 id="Resumen" name="Resumen">Resumen</h3> + +<p>El interfaz <code>nsIWebProgress</code> es usado para agregar o quitar instancias <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a> para observar la carga de peticiones asíncronas (usualmente en el contexto DOM).</p> + +<p>Las instancias <code>nsIWebProgress</code> pueden ser dispuestas en una configuración padre-hijo, correspondiente a la configuración padre-hijo de sus respectivas ventanas DOM. Sin embargo, en algunos casos, una instancia <code>nsIWebProgress</code> puede no estar asociada a una ventana DOM. La relación padre-hijo de las instancias <code>nsIWebProgress</code> no está hecha explícitamente para este intefaz, pero la relación puede existir en algunas implementaciones.</p> + +<p>Una instancia <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a> recibe notificaciones la instancia <code>nsIWebProgress</code> a la cual se ha agregado y puede tambien recibir notificaciones de cualquier instancia <code>nsIWebProgress</code> que sea hija de la instancia <code>nsIWebProgress</code>.</p> + +<p></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/uriloader/base/nsIWebProgress.idl" rel="custom">uriloader/base/nsIWebProgress.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.8.0 </span></div> +</div><p></p> + +<h3 id="C.C3.B3digo_del_interfaz" name="C.C3.B3digo_del_interfaz">Código del interfaz</h3> + +<pre>[scriptable, uuid(570F39D0-EFD0-11d3-B093-00A024FFC08C)] +interface nsIWebProgress : nsISupports +{ + const unsigned long NOTIFY_STATE_REQUEST = 0x00000001; + const unsigned long NOTIFY_STATE_DOCUMENT = 0x00000002; + const unsigned long NOTIFY_STATE_NETWORK = 0x00000004; + const unsigned long NOTIFY_STATE_WINDOW = 0x00000008; + const unsigned long NOTIFY_STATE_ALL = 0x0000000f; + + const unsigned long NOTIFY_PROGRESS = 0x00000010; + const unsigned long NOTIFY_STATUS = 0x00000020; + const unsigned long NOTIFY_SECURITY = 0x00000040; + const unsigned long NOTIFY_LOCATION = 0x00000080; + + const unsigned long NOTIFY_ALL = 0x000000ff; + + void addProgressListener(in nsIWebProgressListener aListener, + in unsigned long aNotifyMask); + + void removeProgressListener(in nsIWebProgressListener aListener); + + readonly attribute nsIDOMWindow DOMWindow; + + readonly attribute PRBool isLoadingDocument; +}; +</pre> + +<h3 id="Constantes" name="Constantes">Constantes</h3> + +<p>Estas lineas indican los estados de transición a observar, correspondientes a <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a>::<a href="/es/NsIWebProgressListener#onStateChange" title="es/NsIWebProgressListener#onStateChange">onStateChange</a>.</p> + +<dl> + <dd><code>NOTIFY_STATE_REQUEST</code> + + <dl> + <dd>Sólo recibe el evento <a href="/es/NsIWebProgressListener#onStateChange" title="es/NsIWebProgressListener#onStateChange">onStateChange</a> si el parámetro aStateFlags incluye <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a>::STATE_IS_REQUEST.</dd> + </dl> + </dd> +</dl> + +<dl> + <dd><code>NOTIFY_STATE_DOCUMENT</code> + + <dl> + <dd>Sólo recibe el evento <a href="/es/NsIWebProgressListener#onStateChange" title="es/NsIWebProgressListener#onStateChange">onStateChange</a> si el parámetro aStateFlags incluye <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a>::STATE_IS_DOCUMENT.</dd> + </dl> + </dd> +</dl> + +<dl> + <dd><code>NOTIFY_STATE_NETWORK</code> + + <dl> + <dd>Sólo recibe el evento <a href="/es/NsIWebProgressListener#onStateChange" title="es/NsIWebProgressListener#onStateChange">onStateChange</a> si el parámetro aStateFlags incluye <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a>::STATE_IS_NETWORK.</dd> + </dl> + </dd> +</dl> + +<dl> + <dd><code>NOTIFY_STATE_WINDOW</code> + + <dl> + <dd>Sólo recibe el evento <a href="/es/NsIWebProgressListener#onStateChange" title="es/NsIWebProgressListener#onStateChange">onStateChange</a> si el parámetro aStateFlags incluye <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a>::STATE_IS_WINDOW.</dd> + </dl> + </dd> +</dl> + +<dl> + <dd><code>NOTIFY_STATE_ALL</code> + + <dl> + <dd>Recibe todos los eventos onStateChange.</dd> + </dl> + </dd> +</dl> + +<p>Estas lineas indican los otros eventos a observar, correspondientes a los otros métodos definidos en <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a>.</p> + +<dl> + <dd><code>NOTIFY_PROGRESS</code> + + <dl> + <dd>Recibe eventos <a href="/es/NsIWebProgressListener#onProgressChange" title="es/NsIWebProgressListener#onProgressChange">onProgressChange</a>.</dd> + </dl> + </dd> +</dl> + +<dl> + <dd><code>NOTIFY_STATUS</code> + + <dl> + <dd>Recibe eventos <a href="/es/NsIWebProgressListener#onStatusChange" title="es/NsIWebProgressListener#onStatusChange">onStatusChange</a>.</dd> + </dl> + </dd> +</dl> + +<dl> + <dd><code>NOTIFY_SECURITY</code> + + <dl> + <dd>Recibe eventos <a href="/es/NsIWebProgressListener#onSecurityChange" title="es/NsIWebProgressListener#onSecurityChange">onSecurityChange</a>.</dd> + </dl> + </dd> +</dl> + +<dl> + <dd><code>NOTIFY_LOCATION</code> + + <dl> + <dd>Recibe eventos <a href="/es/NsIWebProgressListener#onLocationChange" title="es/NsIWebProgressListener#onLocationChange">onLocationChange</a>.</dd> + </dl> + </dd> +</dl> + +<h3 id="M.C3.A9todos" name="M.C3.A9todos">Métodos</h3> + +<h4 id="addProgressListener" name="addProgressListener">addProgressListener</h4> + +<pre class="eval"><code>void addProgressListener(in <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a> aListener, + in unsigned long aNotifyMask);</code> +</pre> + +<p>Registra un escucha que recibirá los eventos del progreso web.</p> + +<h5 id="Par.C3.A1metros" name="Par.C3.A1metros">Parámetros</h5> + +<p><code>aListener</code></p> + +<dl> + <dd>El interfaz de escucha que será llamado cuando ocurra un evento de progreso.</dd> + <dd>Este objeto debe también implementar <a href="/es/NsISupportsWeakReference" title="es/NsISupportsWeakReference">nsISupportsWeakReference</a>.</dd> +</dl> + +<p><code>aNotifyMask</code></p> + +<dl> + <dd>Los tipos de notificaciones a recibir.</dd> +</dl> + +<h5 id="Excepciones" name="Excepciones">Excepciones</h5> + +<p><code>NS_ERROR_INVALID_ARG</code></p> + +<dl> + <dd>Indica que aListener fue bien <em>null</em> o que no soporta referencias débiles.</dd> +</dl> + +<p><code>NS_ERROR_FAILURE</code></p> + +<dl> + <dd>Indica que aListener ya fué registrado.</dd> +</dl> + +<h4 id="removeProgressListener" name="removeProgressListener">removeProgressListener</h4> + +<pre class="eval"><code> void removeProgressListener(in <a href="/es/NsIWebProgressListener" title="es/NsIWebProgressListener">nsIWebProgressListener</a> aListener); +</code> +</pre> + +<h5 id="Par.C3.A1metros_2" name="Par.C3.A1metros_2">Parámetros</h5> + +<p><code>aListener</code></p> + +<dl> + <dd>El interfaz e escucha anteriormente registrado con un llamado a <a href="#addProgressListener">addProgressListener</a>.</dd> +</dl> + +<h5 id="Excepciones_2" name="Excepciones_2">Excepciones</h5> + +<p><code>NS_ERROR_FAILURE</code></p> + +<dl> + <dd>Indica que aListener no fué registrado.</dd> +</dl> + +<h3 id="Attributes" name="Attributes">Atributos</h3> + +<h4 id="DOMWindow" name="DOMWindow">DOMWindow</h4> + +<pre class="eval"><code>atributo de sólo lectura <a href="/es/NsIDOMWindow" title="es/NsIDOMWindow">nsIDOMWindow</a> DOMWindow;</code> +</pre> + +<p>La ventana DOM asociada con esta instancia nsIWebProgress.</p> + +<h5 id="Exceptions" name="Exceptions">Exceptions</h5> + +<p><code>NS_ERROR_FAILURE</code></p> + +<dl> + <dd>Indica que no hay un ventana DOM asociada.</dd> +</dl> + +<h4 id="isLoadingDocument" name="isLoadingDocument">isLoadingDocument</h4> + +<pre class="eval"><code>readonly attribute PRBool isLoadingDocument;</code> +</pre> + +<p>Indica si un documento está siendo cargado o no en el contexto de esta instancia nsIWebProgress.</p> |