| Pacchetto | flash.events |
| Classe | public class NativeDragEvent |
| Ereditarietà | NativeDragEvent  MouseEvent Event Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
L'oggetto iniziatore invia:
-
nativeDragStart: quando ha inizio l'operazione di trascinamento. -
nativeDragUpdate: quando l'operazione di trascinamento è in corso. -
nativeDragComplete: quando l'utente rilascia l'ottetto trascinato (a prescindere dall'accettazione o meno del rilascio).
L'oggetto iniziatore è l'oggetto interattivo passato all'oggetto NativeDragManager nella chiamata a NativeDragManager.doDrag() cha ha dato inizio all'operazione di trascinamento.
I potenziali oggetti interattivi target inviano:
-
nativeDragEnter: quando la manovra di trascinamento passa entro i contorni dell'oggetto. -
nativeDragOver: mentre la manovra di trascinamento rimane entro i contorni dell'oggetto. -
nativeDragExit: quando la manovra di trascinamento esce dai contorni dell'oggetto. -
nativeDragDrop: quando l'utente rilascia l'elemento trascinato sopra l'oggetto e l'oggetto ha accettato il rilascio con una precedente chiamata al metodoNativeDragManager.acceptDragDrop().
Generalmente, il gestore dell'evento nativeDragEnter o dell'evento nativeDragOver valuta i dati che vengono trascinati, insieme alle azioni di trascinamento consentite, per determinare se un oggetto interattivo può accettare o meno il rilascio. Per specificare che un oggetto interattivo è un target idoneo, il gestore di eventi deve chiamare la funzione NativeDragManager.acceptDrop(), passando un riferimento all'oggetto. Se l'utente rilascia il pulsante del mouse, l'oggetto designato, diventa il target di rilascio e invia l'evento nativeDragDrop.
Qualsiasi oggetto di tipo InteractiveObject può essere un iniziatore di trascinamento o un target di rilascio.
Elementi API correlati
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
Proprietà pubbliche
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| allowedActions : NativeDragOptions
L'oggetto NativeDragOptions che specifica le azioni consentite dall'oggetto di visualizzazione che ha avviato l'operazione di trascinamento. | NativeDragEvent | ||
 | altKey : Boolean
Indica se il tasto Alt è attivo (true) o inattivo (false). | MouseEvent | |
| bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | |
| buttonDown : Boolean
Indica se il pulsante principale del mouse è premuto (true) o no (false). | MouseEvent | |
| cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | |
| clickCount : int [sola lettura]
Indica se l'evento mouse down fa parte o meno di una sequenza di più clic. | MouseEvent | |
| clipboard : Clipboard
L'oggetto Clipboard che contiene i dati in questa operazione di trascinamento. | NativeDragEvent | ||
| commandKey : Boolean
Indica se il tasto Comando è attivato (solo Mac). Il valore della proprietà commandKey corrisponde a quello della proprietà ctrlKey in Mac. | MouseEvent | |
| constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| controlKey : Boolean
Indica se il comando Ctrl è attivato in Mac, Windows e Linux. | MouseEvent | |
| ctrlKey : Boolean
In Windows o Linux, indica se il tasto Ctrl è attivo (true) o inattivo (false). | MouseEvent | |
| currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | |
| delta : int
Indica il numero di righe da scorrere per ogni unità di rotazione della rotella del mouse. | MouseEvent | |
| dropAction : String
L'azione corrente. | NativeDragEvent | ||
| eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | |
| isRelatedObjectInaccessible : Boolean
Se è true, la proprietà relatedObject viene impostata su null per motivi riconducibili alle sandbox. | MouseEvent | |
| localX : Number
Quando il blocco del mouse è disattivato, la coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore. | MouseEvent | |
| localY : Number
Quando il blocco del mouse è disattivato, la coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore. | MouseEvent | |
| movementX : Number
Quando il blocco del mouse è attivo, è il cambiamento di posizione del mouse nella direzione X dopo l'ultimo evento del mouse. | MouseEvent | |
| movementY : Number
Quando il blocco del mouse è attivo, è il cambiamento di posizione del mouse nella direzione Y dopo l'ultimo evento del mouse. | MouseEvent | |
| relatedObject : InteractiveObject
Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. | MouseEvent | |
| shiftKey : Boolean
Indica se il tasto Maiusc è attivo (true) o inattivo (false). | MouseEvent | |
| stageX : Number [sola lettura]
La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. | MouseEvent | |
| stageY : Number [sola lettura]
La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. | MouseEvent | |
| target : Object [sola lettura]
Il target dell'evento. | Event | |
| type : String [sola lettura]
Il tipo di evento. | Event | |
Metodi pubblici
| Metodo | Definito da | ||
|---|---|---|---|
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 oggetto Event con informazioni specifiche relative agli eventi di trascinamento e rilascio nativi. | NativeDragEvent | ||
[override]
Crea una copia di questo oggetto NativeDragEvent. | NativeDragEvent | ||
|
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | |
|
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
[override]
Formatta le proprietà di questo oggetto NativeDragEvent come una stringa. | NativeDragEvent | ||
|
Indica a Flash Player o ad Adobe AIR di eseguire il rendering al termine dell'elaborazione dell'evento se l'elenco di visualizzazione è stato modificato. | MouseEvent | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
Costanti pubbliche
| Costante | Definito da | ||
|---|---|---|---|
| NATIVE_DRAG_COMPLETE : String = "nativeDragComplete" [statico]
NativeDragEvent.NATIVE_DRAG_COMPLETE definisce il valore della proprietà type di un oggetto evento nativeDragComplete. | NativeDragEvent | ||
| NATIVE_DRAG_DROP : String = "nativeDragDrop" [statico]
NativeDragEvent.NATIVE_DRAG_DROP definisce il valore della proprietà type di un oggetto evento nativeDragDrop. | NativeDragEvent | ||
| NATIVE_DRAG_ENTER : String = "nativeDragEnter" [statico]
NativeDragEvent.NATIVE_DRAG_ENTER definisce il valore della proprietà type di un oggetto evento nativeDragEnter. | NativeDragEvent | ||
| NATIVE_DRAG_EXIT : String = "nativeDragExit" [statico]
NativeDragEvent.NATIVE_DRAG_EXIT definisce il valore della proprietà type di un oggetto evento nativeDragExit. | NativeDragEvent | ||
| NATIVE_DRAG_OVER : String = "nativeDragOver" [statico]
NativeDragEvent.NATIVE_DRAG_OVER definisce il valore della proprietà type di un oggetto evento nativeDragOver. | NativeDragEvent | ||
| NATIVE_DRAG_START : String = "nativeDragStart" [statico]
NativeDragEvent.NATIVE_DRAG_START definisce il valore della proprietà type di un oggetto evento nativeDragStart. | NativeDragEvent | ||
| NATIVE_DRAG_UPDATE : String = "nativeDragUpdate" [statico]
NativeDragEvent.NATIVE_DRAG_UPDATE definisce il valore della proprietà type di un oggetto evento nativeDragUpdate. | NativeDragEvent | ||
Descrizione delle proprietà
allowedActions | proprietà |
public var allowedActions:NativeDragOptions| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
L'oggetto NativeDragOptions che specifica le azioni consentite dall'oggetto di visualizzazione che ha avviato l'operazione di trascinamento.
Elementi API correlati
clipboard | proprietà |
public var clipboard:Clipboard| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
L'oggetto Clipboard che contiene i dati in questa operazione di trascinamento.
Se l'oggetto che invia l'evento non si trova nello stesso dominio di sicurezza dell'oggetto iniziatore, gli Appunti possono essere letti solo nel gestore di un evento nativeDragDrop.
Elementi API correlati
dropAction | proprietà |
public var dropAction:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
L'azione corrente. Nell'evento nativeDragComplete, la proprietà dropAction riporta l'azione finale.
Descrizione della funzione di costruzione
NativeDragEvent | () | Funzione di costruzione |
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)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Crea un oggetto Event con informazioni specifiche relative agli eventi di trascinamento e rilascio nativi.
Gli oggetti evento vengono passati ai listener di eventi come parametri. L'invio di un evento di trascinamento nativo non attiva il comportamento associato.
Parametritype:String — Il tipo di evento. I valori possibili sono: 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) |
Descrizione dei metodi
clone | () | metodo |
toString | () | metodo |
override public function toString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Formatta le proprietà di questo oggetto NativeDragEvent come una stringa.
La stringa ha il seguente formato:
[NativeDragEvent type=valore bubbles=valore cancelable=valore ... commandKey=valore]
String — Le proprietà di questo oggetto NativeDragEvent sotto forma di stringa.
|
Descrizione delle costanti
NATIVE_DRAG_COMPLETE | Costante |
public static const NATIVE_DRAG_COMPLETE:String = "nativeDragComplete"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_COMPLETE definisce il valore della proprietà type di un oggetto evento nativeDragComplete.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
allowedActions | L'oggetto NativeDragOptions che specifica le azioni relative all'operazione di trascinamento. |
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
clipboard | L'oggetto Clipboard che contiene i dati trascinati. |
dropAction | L'azione scelta dal target di rilascio (o none se non è stata impostata alcuna azione). |
Elementi API correlati
NATIVE_DRAG_DROP | Costante |
public static const NATIVE_DRAG_DROP:String = "nativeDragDrop"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_DROP definisce il valore della proprietà type di un oggetto evento nativeDragDrop.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
allowedActions | L'oggetto NativeDragOptions che specifica le azioni relative all'operazione di trascinamento. |
bubbles | true |
cancelable | true; se si annulla questo evento l'operazione di trascinamento viene annullata. |
clipboard | L'oggetto Clipboard che contiene i dati trascinati. Gli Appunti possono essere letti anche se l'oggetto che invia questo evento non si trova nello stesso dominio di sicurezza dell'oggetto iniziatore. |
dropAction | L'azione scelta dal target di rilascio (o none se non è stata impostata alcuna azione). |
Elementi API correlati
NATIVE_DRAG_ENTER | Costante |
public static const NATIVE_DRAG_ENTER:String = "nativeDragEnter"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_ENTER definisce il valore della proprietà type di un oggetto evento nativeDragEnter.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
allowedActions | L'oggetto NativeDragOptions che specifica le azioni relative all'operazione di trascinamento. |
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
clipboard | L'oggetto Clipboard che contiene i dati trascinati. Gli Appunti possono essere letti unicamente se l'oggetto che invia questo evento si trova nello stesso dominio di sicurezza dell'oggetto iniziatore. |
dropAction | L'azione scelta dal target di rilascio (o none se non è stata impostata alcuna azione). |
Elementi API correlati
NATIVE_DRAG_EXIT | Costante |
public static const NATIVE_DRAG_EXIT:String = "nativeDragExit"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_EXIT definisce il valore della proprietà type di un oggetto evento nativeDragExit.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
allowedActions | L'oggetto NativeDragOptions che specifica le azioni relative all'operazione di trascinamento. |
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
clipboard | L'oggetto Clipboard che contiene i dati trascinati. Gli Appunti possono essere letti unicamente se l'oggetto che invia questo evento si trova nello stesso dominio di sicurezza dell'oggetto iniziatore. |
dropAction | L'azione scelta dal target di rilascio (o none se non è stata impostata alcuna azione). |
Elementi API correlati
NATIVE_DRAG_OVER | Costante |
public static const NATIVE_DRAG_OVER:String = "nativeDragOver"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_OVER definisce il valore della proprietà type di un oggetto eventonativeDragOver.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
allowedActions | L'oggetto NativeDragOptions che specifica le azioni relative all'operazione di trascinamento. |
bubbles | true |
cancelable | true; se si annulla questo evento l'operazione di trascinamento viene annullata. |
clipboard | L'oggetto Clipboard che contiene i dati trascinati. Gli Appunti possono essere letti unicamente se l'oggetto che invia questo evento si trova nello stesso dominio di sicurezza dell'oggetto iniziatore. |
dropAction | L'azione scelta dal target di rilascio (o none se non è stata impostata alcuna azione). |
Elementi API correlati
NATIVE_DRAG_START | Costante |
public static const NATIVE_DRAG_START:String = "nativeDragStart"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_START definisce il valore della proprietà type di un oggetto evento nativeDragStart.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
allowedActions | L'oggetto NativeDragOptions che specifica le azioni relative all'operazione di trascinamento. |
bubbles | true |
cancelable | true; se si annulla questo evento l'operazione di trascinamento viene annullata. |
clipboard | L'oggetto Clipboard che contiene i dati trascinati. |
dropAction | L'azione scelta dal target di rilascio (o none se non è stata impostata alcuna azione). |
Elementi API correlati
NATIVE_DRAG_UPDATE | Costante |
public static const NATIVE_DRAG_UPDATE:String = "nativeDragUpdate"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
NativeDragEvent.NATIVE_DRAG_UPDATE definisce il valore della proprietà type di un oggetto evento nativeDragUpdate.
Questo evento ha le seguenti proprietà:
| Proprietà | Valore |
|---|---|
allowedActions | L'oggetto NativeDragOptions che specifica le azioni relative all'operazione di trascinamento. |
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
clipboard | L'oggetto Clipboard che contiene i dati trascinati. |
dropAction | L'azione scelta dal target di rilascio (o none se non è stata impostata alcuna azione). |
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z