mozilla

Comparar revisiones

Arrastrar y soltar

Change Revisions

Revisión 166488:

Revisión 166488 de Mgjbot el

Revisión 166489:

Revisión 166489 de Dukebody el

Título:
Arrastrar y soltar
Arrastrar y soltar
Enlace amigable (slug):
Arrastrar_y_soltar
Arrastrar_y_soltar
Etiquetas:
XUL, Todas_las_Categorías
XUL, Todas_las_Categorías
Contenido:

Revisión 166488
Revisión 166489
n12      {{template.Next("Drag and Drop JavaScript Wrapper")}} This n12      {{template.Next("Drag and Drop JavaScript Wrapper")}} Esta 
>section describes how to implement objects that can be dragged ar>sección describe cómo implementar objetos que pueden ser arrastra
>ound and dropped onto other objects.>dos y soltados dentro de otros objetos.
n14    <h3 name="The_Drag_and_Drop_Interface">n14    <h3 name="La_interfaz_de_arrastrar_y_soltar">
15      The Drag and Drop Interface15      La interfaz de arrastrar y soltar
n18      Many user interfaces allow one to drag particular objects an18      Muchas interfaces de usuario permiten arrastrar objetos par
>round within the interface. For example, dragging files to other >ticulares dentro de la interfaz. Por ejemplo, arrastrar archivos 
>directories, or dragging an icon to another window to open the do>a otros directorios, o arrastrar un icono a otra ventana para abr
>cument it refers to. Mozilla and <a href="es/XUL">XUL</a> provide>ir el documento que representa. Mozilla y <a href="es/XUL">XUL</a
> a number of events that can handle when the user attempts to dra>> proporcionan varios eventos para gestionar los intentos del usu
>g objects around.>ario arrastrar y soltar objetos.
19    </p>
20    <p>19    </p>
21      A user can start dragging by holding down the mouse button 
>and moving the mouse. The drag stops when the user releases the m 
>ouse. Event handlers are called when the user starts and ends dra 
>gging, and at various points in-between. 
22    </p>20    <p>
21      Un usuario puede empezar a arrastrar un objeto pulsando el 
 >botón del ratón y moviéndolo. Se termina de arrastarar cuando el 
 >usuario suelta el botón del ratón. Los gestores de eventos se lla
 >man cuando el usuario empieza y termina de arrastrar, y también e
 >n varios puntos intermedios.
23    <p>22    </p>
24      Mozilla implements dragging by using a drag session. When a
> user requests to drag something that can be dragged, a drag sess 
>ion should be started. The drag session handles updating the mous 
>e cursor and where the object should be dropped. If something can 
>not be dragged, it should not start a drag session. Because the u 
>ser generally has only one mouse, only one drag session is in use 
> at a time. 
25    </p>23    <p>
24      Mozilla implementa el arrastre por medio de sesiones de arr
 >astre. Cuando un usuario solicita arrastar algo que puede ser arr
 >astrado, se debería iniciar una sesión de arrastre. La sesión de 
 >arrastre gestiona la actualización del puntero del ratón y dónde 
 >debería ser soltado el objeto. Si no se puede arrastrar algo, no 
 >se debería iniciar una sesión de arrastre. Ya que el usuario gene
 >ral sólo tiene un ratón, sólo se utiliza una sesión de arrastre s
 >imultáneamente.
26    <p>25    </p>
27      Note that drag sessions can be created from within Mozilla 
>itself or from other applications. Mozilla will translate the dat 
>a being dragged as needed. 
28    </p>26    <p>
27      Ten en cuenta que las sesiones de arrastre pueden ser cread
 >as desde Mozilla o desde otras aplicaciones. Mozilla traducirá lo
 >s datos que se arrastran si se necesita.
29    <p>28    </p>
30      The list below describes the event handlers that can be cal29    <p>
>led, which may be placed on any element. You only need to put val 
>ues for the handlers where you need to do something when the even 
>t occurs. 
30      La lista inferior describe los gestores de eventos que pued
 >en ser llamados, y que pueden ser asociados cualquier elemento. S
 >ólo necesitas fijar valores para los gestores cuando necesitas qu
 >e pase algo al activarse el evento.
n37        Called periodically throughout the drag and drop operation37        llamado periódicamente a lo largo de la operación de arra
>n.>strar y soltar.
n43        Called when the user starts dragging the element, which nn43        llamado cuando el usuario empieza a arrastrar el elemento
>ormally happens when the user holds down the mouse button and mov>, lo que ocurre normalmente cuando el usuario pulsa el botón del 
>es the mouse. The script in this handler should set up a drag ses>ratón y lo mueve. El script de este gestor debería iniciar y conf
>sion.>igurar una sesión de arrastre.
n49        An alias for <code>ondraggesture</code>; this is the HTMLn49        un alias de <code>ondraggesture</code>; es el nombre de l
> 5 spec name for the event and may be used in HTML or XUL; howeve>a especificación HTML 5 para el evento y puede ser usado en HTML 
>r, for backward compatibility with older versions of Firefox, you>y XUL; sin embargo, para mantener la compatibilidad con versiones
> may wish to continue using <code>ondraggesture</code> in XUL.> más antiguas de Firefox, es posible que quieras continuar usando
 > en XUL <code>ondraggesture</code>.
n55        This event handler is called for an element when somethinn55        este gestor de evento es llamado por un elemento cuando s
>g is being dragged over top of it. If the object can be dropped o>e está arrastrando algo sobre él. Si el objeto puede ser soltado 
>n the element, the drag session should be notified.>sobre el elemento, se debería notificar a la sesión de arrastre.
n61        Called for an element when the mouse pointer first moves n61        es llamado por un elemento cuando el puntero del ratón se
>over the element while something is being dragged. This might be > mueve por primera vez sobre él mientras se está arrastrando algo
>used to change the appearance of the element to indicate to the u>. Se puede usar para cambiar la apariencia del elemento y así ind
>ser that the object can be dropped on it.>icar al usuario que el objeto puede ser soltado en él.
n67        Called for an element when the mouse pointer moves out ofn67        es llamado por un elemento cuando el puntero del ratón ab
> an element while something is being dragged. The is also called >andona el elemento mientras se está arrastrando algo. También es 
>after a drop is complete so that an element has a chance to remov>llamado tras soltar el objeto, para que el elemento pueda elimina
>e any highlighting or other indication.>r cualquier resaltado u otra indicación.
n73        This event handler is called for an element when somethinn73        este gestor de evento es llamado por un elemento cuando s
>g is dropped on the element. At this point, the user has already >e suelta algo en el elemento. En este punto, el usuario ya ha sol
>released the mouse button. The element can simply ignore the even>tado el botón del ratón. El elemento puede simplemente ignorar el
>t or can handle it some way, such as pasting the dragged object i> evento o gestionarlo de alguna manera, tal como pegar el objeto 
>nto itself.>dentro de sí mismo.
n79        Called when the drag operation is finished.n79        se llama cuando se suelta un objeto.
80      </dd>
81    </dl>80      </dd>
82    <p>81    </dl>
83      There are two ways that drag and drop events can be handled
>. This first involves using the drag and drop <a href="es/XPCOM"> 
>XPCOM</a> interfaces directly. The second is to use a <a href="es 
>/Drag_and_Drop_JavaScript_Wrapper">JavaScript wrapper</a> object  
>that handles some of this for you. The code for this wrapper can  
>be found in a file named <a class="external" href="http://lxr.moz 
>illa.org/mozilla/source/toolkit/content/nsDragAndDrop.js">nsDragA 
>ndDrop.js</a> which is contained in the widget-toolkit (or global 
>) package. 
84    </p>82    <p>
85    <h3 name="XPCOM_Drag_and_Drop">83      Hay dos formas de gestionar eventos de arrastrar y soltar. 
 >La primera implica usar las interfaces de arrastrar y soltar de <
 >a href="es/XPCOM">XPCOM</a> directamente. La segunda consiste en 
 >usar un objeto <a href="es/Drag_and_Drop_JavaScript_Wrapper">adap
 >tador JavaScript</a> que gestione algunas de ellas por ti. Puedes
 > encontrar el código de este adaptador en un archivo llamado <a c
 >lass="external" href="http://lxr.mozilla.org/mozilla/source/toolk
 >it/content/nsDragAndDrop.js">nsDragAndDrop.js</a>, que está conte
 >nido en el paquete (o global) widget-toolkit.
86      XPCOM Drag and Drop84    </p>
85    <h3 name="Arrastrar_y_soltar_XPCOM">
86      Arrastrar y soltar XPCOM
n89      Two interfaces are used to support drag and drop. The firstn89      Se utilizan dos interfaces para implementar arrastrar y sol
> is a drag service, <a href="es/NsIDragService">nsIDragService</a>tar. La primera es un servicio de arrastre, <a href="es/NsIDragSe
>> and the second is the drag session, <a href="es/NsIDragSession">rvice">nsIDragService</a>, y la segunda es una sesión de arrastre
>>nsIDragSession</a>.>, <a href="es/NsIDragSession">nsIDragSession</a>.
90    </p>
91    <p>90    </p>
92      The <a href="es/NsIDragService">nsIDragService</a> is respo
>nsible for creating drag sessions when a drag starts, and removin 
>g the drag session when the drag is complete. The function <tt>in 
>vokeDragSession</tt> should be called to start a drag inside an < 
>tt>ondraggesture</tt> event handler. Once this function is called 
>, a drag has started. 
93    </p>91    <p>
92      El <a href="es/NsIDragService">nsIDragService</a> es respon
 >sable de crear sesiones de arrastre cuando se empieza a arrastar,
 > y de eliminar la sesión de arrastre cuando se haya acabado de ar
 >rastrar. Para iniciar un arrastre, se debería llamar a la función
 > <tt>invokeDragSession</tt> dentro de un gestor de eventos <tt>on
 >draggesture</tt>. Cuando se llama a esta función, comienza el arr
 >astre.
94    <p>93    </p>
95      The function invokeDragSession takes four parameters, as de94    <p>
>scribed below: 
95      La función invokeDragSession acepta cuatro parámetros, tal 
 >y como se describe debajo:
n105        A reference to the element that is being dragged. This can105        una referencia al elemento que se está arrastrando. Puede
>n be retrieved by getting the property <tt>event.target</tt> duri> obtenerse a través de la propiedad <tt>event.target</tt> mientra
>ng the event handler.>s dure el gestor de eventos.
n111        An array of <a href="es/NsITransferable">nsITransferable<n111        un vector de objetos <a href="es/NsITransferable">nsITran
>/a> objects, one for each item being dragged. An array is used be>sferable</a>, uno por cada elemento que se está arrastrando. Se u
>cause you might want to drag several objects at once, such as a s>sa un vector para permitir arrastrar varios objetos a la vez, com
>et of files.>o por ejemplo un grupo de archivos.
n117        A region used for feedback indication. This should usualln117        una región usada para indicar retroalimentación. Debería 
>y be set to null.>ser fijada normalmente a null.
n123        The actions that the drag uses. This should be set to onen123        las acciones que usa el arrastre. Suele fijarse como una 
> of the following constants, or several added together. The actio>de las siguientes constantes, o como varias de ellas juntas. La a
>n can be changed during the drag depending on what is being dragg>cción puede cambiarse a lo largo del arrastre dependiendo de sobr
>ed over.>e qué elemento se está arrastrando.
n133            Used to indicate that no drag is valid.n133            se usa para indicar que el arrastre no es válido.
n139            The item being dragged should be copied to its droppen139            el elemento arrastrado se debería copiar al lugar don
>d location.>de se soltó.
n145            The item being dragged should be moved to its droppedn145            el elemento que se arrastra se debería mover al lugar
> location.> donde se soltó.
n151            A link (or shortcut or alias) to the item being draggn151            se debería crear un enlace (o un acceso directo, o un
>ed should be created in the dropped location.> alias) al elemento que se está arrastrando en el lugar donde se 
 >soltó.
n157      The interface <a href="es/NsIDragService">nsIDragService</an157      La interfaz <a href="es/NsIDragService">nsIDragService</a> 
>> also provides the function <tt>getCurrentSession</tt> which can>también proporciona la función <tt>getCurrentSession</tt>, que pu
> be called from within the drag event handlers to get and modify >ede ser llamada desde los gestores de eventos para obtener y modi
>the state of the drag. The function returns an object that implem>ficar el estado del arrastre. La función devuelve un objeto que i
>ents <a href="es/NsIDragSession">nsIDragSession</a>.>mplementa <a href="es/NsIDragSession">nsIDragSession</a>.
158    </p>
159    <p>158    </p>
160      The interface <a href="es/NsIDragSession">nsIDragSession</a159    <p>
>> is used to get and set properties of the drag that is currently 
> occuring. The following properties and methods are available: 
160      La interfaz <a href="es/NsIDragSession">nsIDragSession</a> 
 >se usa para obtener y fijar propiedades del arrastre en curso. Es
 >tán disponibles las siguientes propiedades y métodos:
t167        Set this property to <tt>true</tt> if the element the mout167        fija esta propiedad a <tt>true</tt> si el if the element 
>se is currently over can accept the object currently being dragge>the mouse is currently over can accept the object currently being
>d to be dropped on it. Set the value to <tt>false</tt> if it does> dragged to be dropped on it. Set the value to <tt>false</tt> if 
>n't make sense to drop the object on it. This should be changed i>it doesn't make sense to drop the object on it. This should be ch
>n the <tt>ondragover</tt> and <tt>ondragenter</tt> event handlers>anged in the <tt>ondragover</tt> and <tt>ondragenter</tt> event h
>.>andlers.

Volver al historial