| Pacote | flash.events |
| Classe | public class NativeDragEvent |
| Herança | NativeDragEvent  MouseEvent Event Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O objeto iniciante despacha:
-
nativeDragStart– Quando a operação de arrastar tem início. -
nativeDragUpdate– Enquanto a operação de arrastar está em andamento. -
nativeDragComplete– Quando o usuário libera o item arrastado (com a ação de soltar tendo sido aceita ou não).
O objeto iniciante é o objeto interativo passado que está para o objeto NativeDragManager na chamada a NativeDragManager.doDrag(), que começou a operação de arrastar.
Os objetos interativos de destino em potencial despacham:
-
nativeDragEnter– Quando o gesto de arrastar passa dentro do limite do objeto. -
nativeDragOver– Enquanto o gesto de arrastar permanece dentro do limite do objeto. -
nativeDragExit– Quando o gesto de arrastar sai do limite do objeto. -
nativeDragDrop– Quando o usuário libera o item arrastado sobre o objeto e o objeto aceita a ação de arrastar com uma chamada anterior aNativeDragManager.acceptDragDrop().
Em geral, um manipulador para o evento nativeDragEnter ou nativeDragOver avalia os dados que estão sendo arrastados, junto com as ações de arrastar permitidas, para determinar se um objeto interativo pode aceitar a ação de soltar. Para especificar que um objeto interativo é um destino elegível, o manipulador de evento deve chamar a função NativeDragManager.acceptDrop(), passando em uma referência ao objeto. Se o usuário liberar o botão do mouse sobre o objeto designado, este se torna o destino da ação de soltar e despacha o evento nativeDragDrop.
Qualquer objeto do tipo InteractiveObject pode ser o início da ação de arrastar ou o destino da ação de soltar.
Elementos da API relacionados
flash.desktop.NativeDragManager
flash.desktop.Clipboard
flash.desktop.NativeDragOptions
flash.desktop.NativeDragActions
flash.display.InteractiveObject
flash.desktop.Clipboard
flash.desktop.NativeDragOptions
flash.desktop.NativeDragActions
flash.display.InteractiveObject
Propriedades públicas
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
| allowedActions : NativeDragOptions
O objeto NativeDragOptions especificando as ações que são permitidas pelo objeto de exibição que iniciou esta operação de arrastar. | NativeDragEvent | ||
 | altKey : Boolean
Indica se a tecla Alt está ativa (true) ou inativa (false). | MouseEvent | |
| bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | |
| buttonDown : Boolean
Indica se o botão do mouse principal está pressionado (true) ou não (false). | MouseEvent | |
| cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | |
| clickCount : int [somente leitura]
Indica se o evento mouse down é parte ou não de uma sequência de vários cliques. | MouseEvent | |
| clipboard : Clipboard
O objeto Clipboard contendo os dados nesta operação de arrastar. | NativeDragEvent | ||
| commandKey : Boolean
Indica se a tecla Command está ativada (só no Mac). O valor da propriedade commandKey terá o mesmo valor que a propriedade ctrlKey no Mac. | MouseEvent | |
| constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| controlKey : Boolean
Indica se a tecla Control está ativada no Mac e se a tecla Ctrl está ativada no Windows ou no Linux. | MouseEvent | |
| ctrlKey : Boolean
No Windows ou no Linux, indica se a tecla Ctrl está ativa (true) ou inativa (false). | MouseEvent | |
| currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | |
| delta : int
Indica quantas linhas devem ser roladas para cada unidade em que o usuário gira a roda do mouse. | MouseEvent | |
| dropAction : String
A ação atual. | NativeDragEvent | ||
| eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | |
| isRelatedObjectInaccessible : Boolean
Se verdadeiro, a propriedade relatedObject será definida como nula por motivos relacionados às caixas de proteção de segurança. | MouseEvent | |
| localX : Number
Quando o travamento de mouse está desativado, a coordenada horizontal na qual o evento ocorreu relacionada à entidade gráfica que contém. | MouseEvent | |
| localY : Number
Quando o travamento de mouse está desativado, a coordenada vertical na qual o evento ocorreu relacionada à entidade gráfica que contém. | MouseEvent | |
| movementX : Number
Quando o travamento de mouse é ativado, a alteração na posição do mouse na direção X desde o último evento de mouse. | MouseEvent | |
| movementY : Number
Quando o travamento de mouse é ativado, a alteração na posição do mouse na direção Y desde o último evento de mouse. | MouseEvent | |
| relatedObject : InteractiveObject
Uma referência a um objeto de lista de exibição relacionado ao evento. | MouseEvent | |
| shiftKey : Boolean
Indica se a tecla Shift está ativa (true) ou inativa (false). | MouseEvent | |
| stageX : Number [somente leitura]
A coordenada horizontal na qual o evento ocorreu em coordenadas globais de Palco. | MouseEvent | |
| stageY : Number [somente leitura]
A coordenada vertical na qual o evento ocorreu em coordenadas globais de Palco. | MouseEvent | |
| target : Object [somente leitura]
O destino de evento. | Event | |
| type : String [somente leitura]
O tipo de evento. | Event | |
Métodos públicos
| 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)
Cria um objeto Event com informações específicas relacionadas aos eventos de arrastar e soltar nativos. | NativeDragEvent | ||
[substituir]
Cria uma cópia deste objeto NativeDragEvent. | NativeDragEvent | ||
|
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Verifica se o método preventDefault() foi chamado no evento. | Event | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
|
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Formata as propriedades desse objeto NativeDragEvent como uma string. | NativeDragEvent | ||
|
Instrui o Flash Player ou Adobe AIR a aplicar acabamento após o término do processamento desse evento, se a lista de exibição tiver sido modificada. | MouseEvent | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
Constantes públicas
| Constante | Definido por | ||
|---|---|---|---|
| NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [estático]
O NativeDragEvent.NATIVE_DRAG_COMPLETE define o valor da propriedade type de um objeto de evento nativeDragComplete. | NativeDragEvent | ||
| NATIVE_DRAG_DROP : String = "nativeDragDrop" [estático]
O NativeDragEvent.NATIVE_DRAG_DROP define o valor da propriedade type de um objeto de evento nativeDragDrop. | NativeDragEvent | ||
| NATIVE_DRAG_ENTER : String = "nativeDragEnter" [estático]
O NativeDragEvent.NATIVE_DRAG_ENTER define o valor da propriedade type de um objeto de evento nativeDragEnter. | NativeDragEvent | ||
| NATIVE_DRAG_EXIT : String = "nativeDragExit" [estático]
O NativeDragEvent.NATIVE_DRAG_EXIT define o valor da propriedade type de um objeto de evento nativeDragExit. | NativeDragEvent | ||
| NATIVE_DRAG_OVER : String = "nativeDragOver" [estático]
O NativeDragEvent.NATIVE_DRAG_OVER define o valor da propriedade type de um objeto de evento nativeDragOver. | NativeDragEvent | ||
| NATIVE_DRAG_START : String = "nativeDragStart" [estático]
O NativeDragEvent.NATIVE_DRAG_START define o valor da propriedade type de um objeto de evento nativeDragStart. | NativeDragEvent | ||
| NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [estático]
O NativeDragEvent.NATIVE_DRAG_UPDATE define o valor da propriedade type de um objeto de evento nativeDragUpdate. | NativeDragEvent | ||
Detalhes da propriedade
allowedActions | propriedade |
public var allowedActions:NativeDragOptions| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O objeto NativeDragOptions especificando as ações que são permitidas pelo objeto de exibição que iniciou esta operação de arrastar.
Elementos da API relacionados
clipboard | propriedade |
public var clipboard:Clipboard| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O objeto Clipboard contendo os dados nesta operação de arrastar.
Se o objeto que despacha o evento não estiver no mesmo domínio de segurança que o objeto iniciador, a área de transferência só poderá ser lida no manipulador para um evento nativeDragDrop.
Elementos da API relacionados
dropAction | propriedade |
public var dropAction:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A ação atual. No evento nativeDragComplete, a propriedade dropAction reporta a ação final.
Detalhes do construtor
NativeDragEvent | () | Construtor |
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)| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Cria um objeto Event com informações específicas relacionadas aos eventos de arrastar e soltar nativos.
Objetos Event são transmitidos como parâmetros para ouvintes de eventos. O despacho de um evento nativo de arrastar não dispara o comportamento associado.
Parâmetrostype:String — O tipo de evento. Os valores possíveis são: NativeDragEvent.NATIVE_DRAG_START, NativeDragEvent.NATIVE_DRAG_UPDATE, NativeDragEvent.NATIVE_DRAG_ENTER, NativeDragEvent.NATIVE_DRAG_OVER, NativeDragEvent.NATIVE_DRAG_EXIT, NativeDragEvent.NATIVE_DRAG_DROP e NativeDragEvent.NATIVE_DRAG_COMPLETE.
| |
bubbles:Boolean (default = false) | |
cancelable:Boolean (default = true) | |
localX:Number (default = NaN) | |
localY:Number (default = NaN) | |
relatedObject:InteractiveObject (default = null) | |
clipboard:Clipboard (default = null) | |
allowedActions:NativeDragOptions (default = null) | |
dropAction:String (default = null) | |
controlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) |
Detalhes do método
clone | () | método |
toString | () | método |
override public function toString():String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Formata as propriedades desse objeto NativeDragEvent como uma string.
A string está no seguinte formato:
[NativeDragEvent type=value bubbles=value cancelable=value ... commandKey=value]
String — As propriedades desse objeto NativeDragEvent como uma string.
|
Detalhes da constante
NATIVE_DRAG_COMPLETE | Constante |
public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O NativeDragEvent.NATIVE_DRAG_COMPLETE define o valor da propriedade type de um objeto de evento nativeDragComplete.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
Elementos da API relacionados
NATIVE_DRAG_DROP | Constante |
public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O NativeDragEvent.NATIVE_DRAG_DROP define o valor da propriedade type de um objeto de evento nativeDragDrop.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | true; o cancelamento deste evento cancela a operação de arrastar. |
clipboard | O objeto Clipboard que contém os dados arrastados. Clipboard só pode ser lido se o objeto que está enviando esse evento não estiver no mesmo domínio de segurança do iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
Elementos da API relacionados
NATIVE_DRAG_ENTER | Constante |
public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O NativeDragEvent.NATIVE_DRAG_ENTER define o valor da propriedade type de um objeto de evento nativeDragEnter.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. A área de transferência só poderá ser lida se o objeto que está despachando este evento se encontrar no mesmo domínio de segurança que o iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
Elementos da API relacionados
NATIVE_DRAG_EXIT | Constante |
public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O NativeDragEvent.NATIVE_DRAG_EXIT define o valor da propriedade type de um objeto de evento nativeDragExit.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. A área de transferência só poderá ser lida se o objeto que está despachando este evento se encontrar no mesmo domínio de segurança que o iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
Elementos da API relacionados
NATIVE_DRAG_OVER | Constante |
public static const NATIVE_DRAG_OVER:String = "nativeDragOver"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O NativeDragEvent.NATIVE_DRAG_OVER define o valor da propriedade type de um objeto de evento nativeDragOver.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | true; o cancelamento deste evento cancela a operação de arrastar. |
clipboard | O objeto Clipboard que contém os dados arrastados. A área de transferência só poderá ser lida se o objeto que está despachando este evento se encontrar no mesmo domínio de segurança que o iniciador. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
Elementos da API relacionados
NATIVE_DRAG_START | Constante |
public static const NATIVE_DRAG_START:String = "nativeDragStart"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O NativeDragEvent.NATIVE_DRAG_START define o valor da propriedade type de um objeto de evento nativeDragStart.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | true; o cancelamento deste evento cancela a operação de arrastar. |
clipboard | O objeto Clipboard que contém os dados arrastados. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
Elementos da API relacionados
NATIVE_DRAG_UPDATE | Constante |
public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O NativeDragEvent.NATIVE_DRAG_UPDATE define o valor da propriedade type de um objeto de evento nativeDragUpdate.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
allowedActions | O objeto NativeDragOptions que especifica as ações pertinentes a esta operação de arrastar. |
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
clipboard | O objeto Clipboard que contém os dados arrastados. |
dropAction | A ação escolhida pelo destino da ação de soltar (ou none, se nenhuma ação tiver sido configurada). |
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z