| Pacchetto | flash.events |
| Classe | public class GestureEvent |
| Ereditarietà | GestureEvent  Event Object |
| Sottoclassi | PressAndTapGestureEvent, TransformGestureEvent |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Utilizzate la classe Multitouch per determinare il supporto dell'ambiente corrente per l'interazione del tocco e per gestire tale interazione se è supportata dall'ambiente corrente.
Nota: quando gli oggetti nell'elenco di visualizzazione sono nidificati, gli eventi di tocco sono destinati all'oggetto con il massimo livello di nidificazione visibile nell'elenco di visualizzazione Questo oggetto è detto nodo target. Per fare in modo che l'antenato di un nodo target (un oggetto contenente il nodo target nell'elenco di visualizzazione) riceva notifica di un evento di tocco, utilizzate EventDispatcher.addEventListener() sul nodo antenato con il parametro type impostato sull'evento di tocco specifico che desiderate rilevare.
Altri esempi
Elementi API correlati
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| altKey : Boolean
Indica se il tasto Alt è attivo (true) o inattivo (false). | GestureEvent | ||
 | bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | |
| cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | |
| commandKey : Boolean
Indica se il tasto Comando è attivato (solo Mac). | GestureEvent | ||
| 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. | GestureEvent | ||
| ctrlKey : Boolean
In Windows o Linux, indica se il tasto Ctrl è attivo (true) o inattivo (false). | GestureEvent | ||
| currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | |
| eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | |
| localX : Number
La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene. | GestureEvent | ||
| localY : Number
La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene. | GestureEvent | ||
| phase : String
Un valore della classe GesturePhase che indica lo stato del gesto di tocco. | GestureEvent | ||
| shiftKey : Boolean
Indica se il tasto Maiusc è attivo (true) o inattivo (false). | GestureEvent | ||
| stageX : Number [sola lettura]
La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. | GestureEvent | ||
| stageY : Number [sola lettura]
La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. | GestureEvent | ||
| target : Object [sola lettura]
Il target dell'evento. | Event | |
| type : String [sola lettura]
Il tipo di evento. | Event | |
| Metodo | Definito da | ||
|---|---|---|---|
GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)
Crea un oggetto Event contenente informazioni sugli eventi multi-tocco, ad esempio la pressione contemporanea di due dita su uno schermo sensibile. | GestureEvent | ||
[override]
Crea una copia dell'oggetto GestureEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale. | GestureEvent | ||
|
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]
Restituisce una stringa che contiene tutte le proprietà dell'oggetto GestureEvent. | GestureEvent | ||
Aggiorna la visualizzazione del runtime Flash dopo l'elaborazione dell'evento gesto, nel caso che l'elenco di visualizzazione sia stato modificato dal gestore di eventi. | GestureEvent | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
| Costante | Definito da | ||
|---|---|---|---|
| GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [statico]
Definisce il valore della proprietà type di un oggetto evento di movimento GESTURE_TWO_FINGER_TAP. | GestureEvent | ||
altKey | proprietà |
altKey:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
Indica se il tasto Alt è attivo (true) o inattivo (false). Supportato solo per i sistemi operativi Windows e Linux.
Implementazione
public function get altKey():Boolean public function set altKey(value:Boolean):void commandKey | proprietà |
commandKey:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 2 |
Indica se il tasto Comando è attivato (solo Mac).
In Mac OS, il valore della proprietà commandKey è uguale al valore della proprietà ctrlKey. Questa proprietà è sempre false in Windows o Linux.
Implementazione
public function get commandKey():Boolean public function set commandKey(value:Boolean):voidcontrolKey | proprietà |
ctrlKey | proprietà |
ctrlKey:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2 |
In Windows o Linux, indica se il tasto Ctrl è attivo (true) o inattivo (false). In Macintosh, indica se il tasto Ctrl o il tasto Comando è attivato.
Implementazione
public function get ctrlKey():Boolean public function set ctrlKey(value:Boolean):voidlocalX | proprietà |
localX:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene.
Implementazione
public function get localX():Number public function set localX(value:Number):voidlocalY | proprietà |
localY:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene.
Implementazione
public function get localY():Number public function set localY(value:Number):voidphase | proprietà |
phase:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Un valore della classe GesturePhase che indica lo stato del gesto di tocco. Per la maggior parte dei gesti, il valore è begin, update o end. Per gli eventi di strisciatura e di tocco a due dita, il valore phase è sempre all una volta che l'evento è stato inviato. Utilizzate questo valore per determinare quando un gestore di eventi risponde a un'interazione utente complessa o risponde in modi diversi a seconda della fase corrente di un gesto multi-tocco (ad esempio, l'espansione, il movimento e il "rilascio" mentre un utente tocca e trascina un oggetto visivo attraverso uno schermo).
Implementazione
public function get phase():String public function set phase(value:String):voidElementi API correlati
shiftKey | proprietà |
stageX | proprietà |
stageX:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. Questa proprietà viene calcolata quando viene impostata la proprietà localX.
Implementazione
public function get stageX():NumberstageY | proprietà |
stageY:Number [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. Questa proprietà viene calcolata quando viene impostata la proprietà localY.
Implementazione
public function get stageY():NumberGestureEvent | () | Funzione di costruzione |
public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Crea un oggetto Event contenente informazioni sugli eventi multi-tocco, ad esempio la pressione contemporanea di due dita su uno schermo sensibile. Gli oggetti evento vengono passati ai listener di eventi come parametri.
Parametritype:String — Il tipo di evento. Il valore supportato è: GestureEvent.GESTURE_TWO_FINGER_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
phase:String (default = null) | |
localX:Number (default = 0) | |
localY:Number (default = 0) | |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) |
Elementi API correlati
clone | () | metodo |
override public function clone():Event| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Crea una copia dell'oggetto GestureEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
RestituisceEvent — Un nuovo oggetto GestureEvent con proprietà dai valori identici a quelli dell'originale.
|
toString | () | metodo |
override public function toString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Restituisce una stringa che contiene tutte le proprietà dell'oggetto GestureEvent. La stringa ha il seguente formato:
[GestureEvent type=valore bubbles=valore cancelable=valore ... ]
String — Una stringa che contiene tutte le proprietà dell'oggetto GestureEvent.
|
updateAfterEvent | () | metodo |
public function updateAfterEvent():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Aggiorna la visualizzazione del runtime Flash dopo l'elaborazione dell'evento gesto, nel caso che l'elenco di visualizzazione sia stato modificato dal gestore di eventi.
GESTURE_TWO_FINGER_TAP | Costante |
public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definisce il valore della proprietà type di un oggetto evento di movimento GESTURE_TWO_FINGER_TAP.
L'oggetto GestureEvent ha le proprietà seguenti:
| Proprietà | Valore |
|---|---|
altKey | true se il tasto Alt è attivo (Windows o Linux). |
bubbles | true |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
commandKey | (Solo AIR) true in Mac se il tasto Comando è attivo; false se è inattivo. Sempre false in Windows. |
controlKey | true se il tasto Ctrl è attivo; false se è inattivo. |
ctrlKey | true in Windows o Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti false. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
phase | La fase attuale del flusso di eventi. Per gli eventi di tocco a due dita, questo valore è sempre all, che corrisponde al valore GesturePhase.ALL una volta che l'evento è stato inviato. |
isRelatedObjectInaccessible | true se la proprietà relatedObject è impostata su null a causa delle regole della funzione di sicurezza sandbox. |
localX | La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene. |
localY | La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto Sprite che lo contiene. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
target | L'istanza InteractiveObject sotto il dispositivo di tocco. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzate la proprietà currentTarget per accedere all'oggetto dell'elenco di visualizzazione che sta elaborando l'evento. |
Elementi API correlati
GESTURE_TWO_FINGER_TAP. Mentre l'utente esegue un gesto di tocco a due dita, mySprite ruota e myTextField esegue la compilazione con la fase all, che è l'unica fase per gli eventi di tocco a due dita. Altri gesti della classe TransformGestureEvent supportano le fasi di inizio, aggiornamento e fine.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onTwoFingerTap(evt:GestureEvent):void {
evt.target.rotation -= 45;
myTextField.text = evt.phase; //"all"
}
Tue Jun 12 2018, 02:44 PM Z