NativeDragEvent

Paquete	flash.events
Clase	public class NativeDragEvent
Herencia	NativeDragEvent MouseEvent Event Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Los objetos NativeDragEvents se distribuyen mediante objetos interactivos involucrados en una operación de arrastrar y soltar.

El objeto iniciador distribuye:

nativeDragStart: cuando comienza la operación de arrastrar.
nativeDragUpdate: mientras la operación de arrastrar está en curso.
nativeDragComplete: cuando el usuario suelta el elemento arrastrado (se acepte o no la operación de soltar).

El objeto iniciador es el objeto interactivo transferido a objeto NativeDragManager en la llamada a NativeDragManager.doDrag() que inició la operación de arrastrar.

Los objetos interactivos potenciales de destino distribuyen:

nativeDragEnter: cuando el gesto de arrastrar no sale de los límites del objeto.
nativeDragOver: mientras el gesto de arrastrar permanece dentro de los límites del objeto.
nativeDragExit: cuando el gesto de arrastrar sale de los límites del objeto.
nativeDragDrop: cuando el usuario suelta el elemento sobre el objeto y éste ha aceptado previamente la operación de soltar mediante una llamada a NativeDragManager.acceptDragDrop().

Normalmente, un controlador de los eventos nativeDragEnter o nativeDragOver evalúa los datos que se están arrastrando y las acciones permitidas para determinar si el objeto interactivo debe aceptar o no la acción de soltar. Para especificar que un objeto interactivo puede elegirse como destino, el controlador de eventos debe llamar a la función NativeDragManager.acceptDrop() y transferir una referencia al objeto. Si el usuario suelta el botón del ratón sobre el objeto designado, éste se convierte en destino de la acción de soltar y distribuye el evento nativeDragDrop.

Un objeto de tipo InteractiveObject puede ser un iniciador de arrastre o un destino de la acción soltar.

Elementos de API relacionados

flash.desktop.NativeDragManager
flash.desktop.Clipboard
flash.desktop.NativeDragOptions
flash.desktop.NativeDragActions
flash.display.InteractiveObject

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		allowedActions : NativeDragOptions Objeto NativeDragOptions que especifica las acciones permitidas en el objeto de visualización que inició la operación de arrastrar.	NativeDragEvent
		altKey : Boolean Indica si la tecla Alt está activa (true) o inactiva (false).	MouseEvent
		bubbles : Boolean [solo lectura] Indica si un evento es un evento de propagación.	Event
		buttonDown : Boolean Indica si se pulsa el botón principal del ratón (true) o no (false).	MouseEvent
		cancelable : Boolean [solo lectura] Indica si se puede evitar el comportamiento asociado al evento.	Event
		clickCount : int [solo lectura] Indica si el evento MouseDown forma parte o no de una secuencia de varios clics.	MouseEvent
		clipboard : Clipboard Objeto Clipboard que contiene los datos de esta operación de arrastrar.	NativeDragEvent
		commandKey : Boolean Indica si la tecla Comando está activada (sólo en Mac). El valor de la propiedad commandKey tiene el mismo valor que la propiedad ctrlKey en Mac.	MouseEvent
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		controlKey : Boolean Indica si la tecla Control está activada en Mac y si la tecla Ctrl está activada en Windows o Linux.	MouseEvent
		ctrlKey : Boolean En Windows o Linux, indica si la tecla Ctrl está activa (true) o inactiva (false).	MouseEvent
		currentTarget : Object [solo lectura] Objeto que procesa de forma activa el objeto de evento con un detector de eventos.	Event
		delta : int Indica el número de líneas que debe desplazarse la visualización por cada vuelta de la rueda del ratón.	MouseEvent
		dropAction : String La acción actual.	NativeDragEvent
		eventPhase : uint [solo lectura] La fase actual en el flujo del evento.	Event
		isRelatedObjectInaccessible : Boolean Si es true, la propiedad relatedObject se establece como null por motivos relacionados con entornos limitados de seguridad.	MouseEvent
		localX : Number Cuando el bloqueo del ratón está desactivado, la coordenada horizontal en la que se produce el evento relativo a la clase Sprite contenida.	MouseEvent
		localY : Number Cuando el bloqueo del ratón está desactivado, la coordenada vertical en la que se produce el evento relativo a la clase Sprite contenida.	MouseEvent
		movementX : Number Cuando el bloqueo del ratón está activado, el cambio en la posición del ratón en la dirección X desde el último evento de ratón.	MouseEvent
		movementY : Number Cuando el bloqueo del ratón está activado, el cambio en la posición del ratón en la dirección Y desde el último evento de ratón.	MouseEvent
		relatedObject : InteractiveObject Referencia a un objeto de la lista de visualización relacionado con el evento.	MouseEvent
		shiftKey : Boolean Indica si la tecla Mayús está activa (true) o inactiva (false).	MouseEvent
		stageX : Number [solo lectura] La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario.	MouseEvent
		stageY : Number [solo lectura] La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario.	MouseEvent
		target : Object [solo lectura] El destino del evento.	Event
		type : String [solo lectura] El tipo de evento.	Event

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false) Crea un objeto de evento con información específica relacionada con los eventos de arrastrar y soltar.	NativeDragEvent
		clone():Event [override] Crea una copia de este objeto NativeDragEvent.	NativeDragEvent
		formatToString(className:String, ... arguments):String Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isDefaultPrevented():Boolean Comprueba si se ha llamado a preventDefault() en el evento.	Event
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		preventDefault():void Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.	Event
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		stopImmediatePropagation():void Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.	Event
		stopPropagation():void Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.	Event
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String [override] Da formato a las propiedades de este objeto NativeDragEvent como una cadena.	NativeDragEvent
		updateAfterEvent():void Si se ha modificado la lista de visualización, da instrucciones a Flash Player o a Adobe AIR para que muestre la representación tras finalizar el procesamiento del evento.	MouseEvent
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Constantes públicas

Ocultar constantes públicas heredadas

Mostrar constantes públicas heredadas

	Constante		Definido por
		NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [estática] NativeDragEvent.NATIVE_DRAG_COMPLETE define el valor de la propiedad type de un objeto de evento nativeDragComplete.	NativeDragEvent
		NATIVE_DRAG_DROP : String = "nativeDragDrop" [estática] NativeDragEvent.NATIVE_DRAG_DROP define el valor de la propiedad type de un objeto de evento nativeDragDrop.	NativeDragEvent
		NATIVE_DRAG_ENTER : String = "nativeDragEnter" [estática] NativeDragEvent.NATIVE_DRAG_ENTER define el valor de la propiedad type de un objeto de evento nativeDragEnter.	NativeDragEvent
		NATIVE_DRAG_EXIT : String = "nativeDragExit" [estática] NativeDragEvent.NATIVE_DRAG_EXIT define el valor de la propiedad type de un objeto de evento nativeDragExit.	NativeDragEvent
		NATIVE_DRAG_OVER : String = "nativeDragOver" [estática] NativeDragEvent.NATIVE_DRAG_OVER define el valor de la propiedad type de un objeto de evento nativeDragOver.	NativeDragEvent
		NATIVE_DRAG_START : String = "nativeDragStart" [estática] NativeDragEvent.NATIVE_DRAG_START define el valor de la propiedad type de un objeto de evento nativeDragStart.	NativeDragEvent
		NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [estática] NativeDragEvent.NATIVE_DRAG_UPDATE define el valor de la propiedad type de un objeto de evento nativeDragUpdate.	NativeDragEvent

Información sobre propiedades

allowedActions

propiedad

public var allowedActions:NativeDragOptions

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Objeto NativeDragOptions que especifica las acciones permitidas en el objeto de visualización que inició la operación de arrastrar.

Elementos de API relacionados

flash.desktop.NativeDragOptions

clipboard

propiedad

public var clipboard:Clipboard

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Objeto Clipboard que contiene los datos de esta operación de arrastrar.

Si el objeto que distribuye el evento no se encuentra en el mismo dominio de seguridad que el objeto iniciador, sólo se puede leer el contenido del portapapeles en el controlador de un evento nativeDragDrop.

Elementos de API relacionados

flash.desktop.Clipboard

dropAction

propiedad

public var dropAction:String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

La acción actual. En el evento nativeDragComplete, la propiedad dropAction informa sobre la acción final.

Información sobre constructores

()

Información sobre

public function NativeDragEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = true, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, clipboard:Clipboard = null, allowedActions:NativeDragOptions = null, dropAction:String = null, controlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false)

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Crea un objeto de evento con información específica relacionada con los eventos de arrastrar y soltar.

Los objetos de evento se transfieren como parámetros a los detectores de eventos. Distribuir un evento drag nativo no desencadena el comportamiento asociado.

Parámetros

	`type:String` — El tipo de evento. Los valores posibles son: `NativeDragEvent.NATIVE_DRAG_START`, `NativeDragEvent.NATIVE_DRAG_UPDATE`, `NativeDragEvent.NATIVE_DRAG_ENTER`, `NativeDragEvent.NATIVE_DRAG_OVER`, `NativeDragEvent.NATIVE_DRAG_EXIT`, `NativeDragEvent.NATIVE_DRAG_DROP` y `NativeDragEvent.NATIVE_DRAG_COMPLETE`.

	`bubbles:Boolean` (default = `false`) — Indica si el objeto de evento participa en la fase de propagación del flujo del evento.

	`cancelable:Boolean` (default = `true`) — Indica si se puede cancelar el objeto Event.

	`localX:Number` (default = `NaN`) — La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida.

	`localY:Number` (default = `NaN`) — La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida.

	`relatedObject:InteractiveObject` (default = `null`) — Objeto de visualización interactivo relacionado.

	`clipboard:Clipboard` (default = `null`) — Objeto Clipboard que contiene los datos que se van a transferir.

	`allowedActions:NativeDragOptions` (default = `null`) — Objeto NativeDragOptions que define las acciones permitidas (mover, copiar y vincular).

	`dropAction:String` (default = `null`) — La acción actual.

	`controlKey:Boolean` (default = `false`) — Indica si la tecla Control está activada.

	`altKey:Boolean` (default = `false`) — Indica si la tecla Alt está activada.

	`shiftKey:Boolean` (default = `false`) — Indica si la tecla Mayús está activada.

	`commandKey:Boolean` (default = `false`) — Indica si la tecla Comando está activada.

Información sobre métodos

clone

()

método

override public function clone():Event

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Crea una copia de este objeto NativeDragEvent.

Valor devuelto

Event — Un nuevo objeto NativeDragEvent con valores de propiedades que coinciden con los del objeto original.

toString

()

método

override public function toString():String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Da formato a las propiedades de este objeto NativeDragEvent como una cadena.

La cadena tiene el siguiente formato:

[NativeDragEvent type=valor bubbles=valor cancelable=valor ... commandKey=valor]

Valor devuelto

String — Propiedades de este objeto NativeDragEvent como una cadena.

Información sobre constantes

NATIVE_DRAG_COMPLETE

Constante

public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_COMPLETE define el valor de la propiedad type de un objeto de evento nativeDragComplete.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`allowedActions`	Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar.
`bubbles`	`true`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`clipboard`	Objeto Clipboard que contiene los datos arrastrados.
`dropAction`	Acción elegida por el destino de la acción de soltar (`none` si no se ha definido ninguna).

Elementos de API relacionados

flash.display.InteractiveObject.nativeDragComplete
flash.desktop.NativeDragActions

NATIVE_DRAG_DROP

Constante

public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_DROP define el valor de la propiedad type de un objeto de evento nativeDragDrop.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`allowedActions`	Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar.
`bubbles`	`true`
`cancelable`	`true`; si se cancela este evento, se cancela la operación de arrastrar.
`clipboard`	Objeto Clipboard que contiene los datos arrastrados. Se puede leer el contenido del portapapeles incluso si el objeto que distribuye este evento no se encuentra en el mismo dominio de seguridad que el iniciador.
`dropAction`	Acción elegida por el destino de la acción de soltar (`none` si no se ha definido ninguna).

Elementos de API relacionados

flash.display.InteractiveObject.nativeDragDrop

NATIVE_DRAG_ENTER

Constante

public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_ENTER define el valor de la propiedad type de un objeto de evento nativeDragEnter.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`allowedActions`	Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar.
`bubbles`	`true`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`clipboard`	Objeto Clipboard que contiene los datos arrastrados. Sólo se puede leer el contenido del portapapeles si el objeto que distribuye este evento se encuentra en el mismo dominio de seguridad que el iniciador.
`dropAction`	Acción elegida por el destino de la acción de soltar (`none` si no se ha definido ninguna).

Elementos de API relacionados

flash.display.InteractiveObject.nativeDragEnter

NATIVE_DRAG_EXIT

Constante

public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_EXIT define el valor de la propiedad type de un objeto de evento nativeDragExit.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`allowedActions`	Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar.
`bubbles`	`true`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`clipboard`	Objeto Clipboard que contiene los datos arrastrados. Sólo se puede leer el contenido del portapapeles si el objeto que distribuye este evento se encuentra en el mismo dominio de seguridad que el iniciador.
`dropAction`	Acción elegida por el destino de la acción de soltar (`none` si no se ha definido ninguna).

Elementos de API relacionados

flash.display.InteractiveObject.nativeDragExit

NATIVE_DRAG_OVER

Constante

public static const NATIVE_DRAG_OVER:String = "nativeDragOver"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_OVER define el valor de la propiedad type de un objeto de evento nativeDragOver.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`allowedActions`	Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar.
`bubbles`	`true`
`cancelable`	`true`; si se cancela este evento, se cancela la operación de arrastrar.
`clipboard`	Objeto Clipboard que contiene los datos arrastrados. Sólo se puede leer el contenido del portapapeles si el objeto que distribuye este evento se encuentra en el mismo dominio de seguridad que el iniciador.
`dropAction`	Acción elegida por el destino de la acción de soltar (`none` si no se ha definido ninguna).

Elementos de API relacionados

flash.display.InteractiveObject.nativeDragOver

NATIVE_DRAG_START

Constante

public static const NATIVE_DRAG_START:String = "nativeDragStart"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_START define el valor de la propiedad type de un objeto de evento nativeDragStart.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`allowedActions`	Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar.
`bubbles`	`true`
`cancelable`	`true`; si se cancela este evento, se cancela la operación de arrastrar.
`clipboard`	Objeto Clipboard que contiene los datos arrastrados.
`dropAction`	Acción elegida por el destino de la acción de soltar (`none` si no se ha definido ninguna).

Elementos de API relacionados

flash.display.InteractiveObject.nativeDragStart

NATIVE_DRAG_UPDATE

Constante

public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

NativeDragEvent.NATIVE_DRAG_UPDATE define el valor de la propiedad type de un objeto de evento nativeDragUpdate.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`allowedActions`	Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar.
`bubbles`	`true`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`clipboard`	Objeto Clipboard que contiene los datos arrastrados.
`dropAction`	Acción elegida por el destino de la acción de soltar (`none` si no se ha definido ninguna).

Elementos de API relacionados

flash.display.InteractiveObject.nativeDragUpdate

Avisos legales | Política de privacidad en línea

NativeDragEvent - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete flash.events

allowedActions

clipboard

dropAction