InteractiveObject  - AS3

L'implementazione di accessibilità corrente (AccessibilityImplementation) di questa istanza InteractiveObject.

Elementi API correlati

Specifica il menu di scelta rapida associato all'oggetto.

Per il contenuto in esecuzione in Flash Player, questa proprietà è un oggetto ContextMenu. Nel runtime di AIR, la classe ContextMenu estende la classe NativeMenu, tuttavia Flash Player supporta solo la classe ContextMenu e non la classe NativeMenu.

Nota: nel menu di scelta rapida degli oggetti TextField è sempre incluso un menu Appunti. Nel menu appunti sono presenti i comandi Taglia, Copia, Incolla, Annulla e Seleziona tutto. Non è possibile rimuovere questi comandi dal menu di scelta rapida per gli oggetti TextField. Per gli oggetti TextField, la selezione di questi comandi (o l'utilizzo dei comandi equivalenti dalla tastiera) non genera un evento clear, copy, cut, paste o selectAll.

var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

Specifica se l'oggetto riceve gli eventi doubleClick. Il valore predefinito è false e indica che, per impostazione predefinita, un'istanza InteractiveObject non riceve gli eventi doubleClick. Se la proprietà doubleClickEnabled è impostata su true, l'istanza riceve gli eventi doubleClick nei propri limiti. Anche la proprietà mouseEnabled dell'istanza InteractiveObject deve essere impostata su true affinché l'oggetto possa ricevere gli eventi doubleClick.

Nessun evento viene inviato impostando questa proprietà. È necessario utilizzare il metodo addEventListener() per aggiungere un listener di eventi per l'evento doubleClick.

Elementi API correlati

Specifica se l'oggetto visualizza un rettangolo di attivazione. Può assumere uno di questi tre valori: true, false o null. I valori true e false funzionano come previsto, specificando se il rettangolo di attivazione viene visualizzato o meno. Il valore null indica che questo oggetto obbedisce alla proprietà stageFocusRect dello stage.

Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. Il valore predefinito è true e indica che, per impostazione predefinita, qualunque istanza InteractiveObject inclusa nell'elenco di visualizzazione riceve gli eventi del mouse o di altri dispositivi di input dell'utente. Se mouseEnabled è impostato su false, l'istanza non riceve alcun evento del mouse (o altri eventi di input dell'utente quali gli eventi della tastiera). L'impostazione non influisce sugli eventuali elementi secondari dell'istanza presenti nell'elenco di visualizzazione. Per cambiare il comportamento mouseEnabled di tutti gli elementi secondari di un oggetto dell'elenco di visualizzazione, utilizzate flash.display.DisplayObjectContainer.mouseChildren.

Nessun evento viene inviato impostando questa proprietà. Dovete utilizzare il metodo addEventListener() per creare la funzionalità interattiva.

Elementi API correlati

Specifica se deve essere visualizzata una tastiera virtuale (una tastiera software a video) quando questa istanza InteractiveObject riceve lo stato di attivazione.

Per impostazione predefinita, il valore è false e l'assegnazione dello stato di attivazione a un'istanza InteractiveObject non determina la visualizzazione di una tastiera virtuale. Se la proprietà needsSoftKeyboard è impostata su true, il runtime visualizza una tastiera software quando l'istanza InteractiveObject è pronta per accettare l'input dell'utente. Un'istanza InteractiveObject è pronta per accettare l'input dell'utente dopo una chiamata programmatica che imposta la proprietà focus dello stage, oppure in seguito a un'azione dell'utente, ad esempio un "tocco" sul display. Se il sistema client è dotato di una tastiera hardware oppure non supporta le tastiere virtuali, la tastiera software non viene visualizzata.

L'istanza InteractiveObject invia gli eventi softKeyboardActivating, softKeyboardActivate e softKeyboardDeactivate quando la tastiera virtuale si alza e si abbassa.

Nota: questa proprietà non è supportata nelle applicazioni AIR su iOS.

Elementi API correlati

Controlla l'aspetto della tastiera software.

I dispositivi con tastiere software consentono di personalizzare i pulsanti della tastiera per farli corrispondere al tipo di input previsto. Ad esempio, se è previsto un input numerico, un dispositivo può utilizzare SoftKeyboardType.NUMBER per visualizzare solo i numeri sulla tastiera software. I valori validi sono definiti come costanti nella classe SoftKeyboardType:

• "default"
• "punctuation"
• "url"
• "number"
• "contact"
• "email"
• "telefono"
• "decimalpad"

Questi valori sono suggerimenti e hanno lo scopo di "aiutare" un dispositivo a visualizzare la tastiera più appropriata per l'operazione corrente.

Il valore predefinito è SoftKeyboardType.DEFAULT.

Elementi API correlati

Definisce l’area che deve rimanere visibile sullo schermo quando è visualizzata una tastiera virtuale (non disponibile in iOS).

Se la proprietà needsSoftKeyboard di questo InteractiveObject è true, il runtime regola la visualizzazione in modo da mantenere l'oggetto in vista mentre l'utente digita. Normalmente, il runtime utilizza i limiti dell'oggetto ottenuti dal metodo DisplayObject.getBounds(). Potete specificare un'area differente utilizzando questa proprietà softKeyboardInputAreaOfInterest.

Specificate l'area softKeyboardInputAreaOfInterest nelle coordinate dello stage.

Nota: inAndroid, l'area softKeyboardInputAreaOfInterest non viene rispettata quando l'orientamento è orizzontale.

Nota: softKeyboardInputAreaOfInterest non è supportato su iOS.

Elementi API correlati

Specifica se questo oggetto è incluso nell'ordine di tabulazione. Se questo oggetto è nell'ordine di tabulazione, il valore è true, in caso contrario è false. Per impostazione predefinita, il valore è false, a eccezione dei casi seguenti:

• Per un oggetto SimpleButton, il valore è true.
• Per un oggetto TextField con type = "input", il valore è true.
• Per un oggetto Sprite o un oggetto MovieClip con buttonMode = true, il valore è true.

Specifica l'ordine di tabulazione degli oggetti in un file SWF. Il valore predefinito di questa proprietà tabIndex è -1 e indica che per l'oggetto non è impostato un indice di tabulazione.

Se un qualunque oggetto visualizzato nel file SWF contiene una proprietà tabIndex, l'ordine di tabulazione automatico viene disabilitato e viene calcolato in base alle proprietà tabIndex degli oggetti presenti nel file SWF. L'ordine di tabulazione personalizzato include solo gli oggetti dotati delle proprietà tabIndex.

La proprietà tabIndex può essere un numero intero non negativo. Gli oggetti vengono ordinati in base alle relative proprietà tabIndex, in ordine ascendente. Un oggetto con un valore tabIndex di 1 precede un oggetto con il valore tabIndex di 2. È sconsigliabile utilizzare lo stesso valore di tabIndex per più oggetti.

L'ordine di tabulazione personalizzato definito dalla proprietà tabIndex è di tipo flat. In altre parole, non viene prestata alcuna attenzione alle relazioni gerarchiche degli oggetti nel file SWF. Tutti gli oggetti del file SWF dotati delle proprietà tabIndex vengono inseriti nell'ordine di tabulazione, il quale viene determinato dall'ordine dei valori tabIndex.

Nota: per impostare l'ordine di tabulazione per le istanze TLFTextField, inserite l'oggetto di visualizzazione secondario del TLFTextField come InteractiveObject, quindi impostate la proprietà tabIndex. Ad esempio:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

Una chiamata alla funzione di costruzione new InteractiveObject() genera un'eccezione ArgumentError. È tuttavia possibile chiamare funzioni di costruzione per le seguenti sottoclassi di InteractiveObject:

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

Alza una tastiera virtuale.

Una chiamata a questo metodo assegna lo stato di attivazione all'istanza InteractiveObject e alza la tastiera virtuale, se necessario. Anche needsSoftKeyboard deve essere true. La tastiera virtuale non viene visualizzata se è disponibile una tastiera hardware, oppure se il sistema client non supporta le tastiere virtuali.

Nota: questo metodo non è supportato nelle applicazioni AIR for iOS.

Elementi API correlati

Inviato quando l'utente sceglie "Cancella" (o "Elimina") dal menu di scelta rapida per il testo. Questo evento viene inviato all'oggetto attivo. Se l'oggetto attualmente attivo è un TextField, il comportamento predefinito di questo evento causa l'eliminazione dell'eventuale testo attualmente selezionato nel campo di testo.

Questo evento ha le seguenti proprietà:

Nota: gli oggetti TextField non inviano gli eventi clear, copy, cut, paste o selectAll. Nel menu di scelta rapida degli oggetti TextField sono sempre presenti i comandi Taglia, Copia, Incolla, Annulla e Seleziona tutto. Non è possibile rimuovere questi comandi dal menu di scelta rapida per gli oggetti TextField. Per gli oggetti TextField, la selezione di questi comandi (o l'utilizzo dei comandi equivalenti dalla tastiera) non genera un evento clear, copy, cut, paste o selectAll. Le altre classi che estendono la classe InteractiveObject, inclusi i componenti creati tramite Flash Text Engine (FTE), invieranno tuttavia questi eventi in risposta alle azioni dell'utente, ad esempio scelte rapide da tastiera e menu contestuali.

Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject. Perché si verifichi un evento click, esso deve seguire sempre questa serie di eventi nell'ordine seguente: evento mouseDown, quindi mouseUp. L'oggetto target deve essere lo stesso per entrambi gli eventi, altrimenti l'evento click non si verifica. Tra gli eventi mouseDown o mouseUp può verificarsi qualsiasi numero di eventi del mouse in qualunque momento; l'evento click si verifica in ogni caso.

Questo evento ha le seguenti proprietà:

Inviato quando un'azione dell'utente causa la visualizzazione del menu di scelta rapida associato a questo oggetto interattivo in un'applicazione AIR.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida per il testo. Questo evento viene inviato all'oggetto attivo. Se l'oggetto attualmente attivo è un TextField, il comportamento predefinito di questo evento copia l'eventuale testo attualmente selezionato nel campo di testo e lo inserisce negli Appunti.

Questo evento ha le seguenti proprietà:

Nota: gli oggetti TextField non inviano gli eventi clear, copy, cut, paste o selectAll. Nel menu di scelta rapida degli oggetti TextField sono sempre presenti i comandi Taglia, Copia, Incolla, Annulla e Seleziona tutto. Non è possibile rimuovere questi comandi dal menu di scelta rapida per gli oggetti TextField. Per gli oggetti TextField, la selezione di questi comandi (o l'utilizzo dei comandi equivalenti dalla tastiera) non genera un evento clear, copy, cut, paste o selectAll. Le altre classi che estendono la classe InteractiveObject, inclusi i componenti creati tramite Flash Text Engine (FTE), invieranno tuttavia questi eventi in risposta alle azioni dell'utente, ad esempio scelte rapide da tastiera e menu contestuali.

Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di tagliare oppure sceglie "Taglia" dal menu di scelta rapida testuale. Questo evento viene inviato all'oggetto attivo. Se l'oggetto attualmente attivo è un TextField, il comportamento predefinito di questo evento taglia l'eventuale testo attualmente selezionato nel campo di testo e lo inserisce negli Appunti.

Questo evento ha le seguenti proprietà:

Nota: gli oggetti TextField non inviano gli eventi clear, copy, cut, paste o selectAll. Nel menu di scelta rapida degli oggetti TextField sono sempre presenti i comandi Taglia, Copia, Incolla, Annulla e Seleziona tutto. Non è possibile rimuovere questi comandi dal menu di scelta rapida per gli oggetti TextField. Per gli oggetti TextField, la selezione di questi comandi (o l'utilizzo dei comandi equivalenti dalla tastiera) non genera un evento clear, copy, cut, paste o selectAll. Le altre classi che estendono la classe InteractiveObject, inclusi i componenti creati tramite Flash Text Engine (FTE), invieranno tuttavia questi eventi in risposta alle azioni dell'utente, ad esempio scelte rapide da tastiera e menu contestuali.

Inviato quando l'utente preme e rilascia il pulsante principale di un dispositivo di puntamento due volte in rapida successione sopra la stessa istanza InteractiveObject quando il flag doubleClickEnabled dell'oggetto è impostato su true. Perché si verifichi un evento doubleClick, esso deve seguire immediatamente la serie di eventi seguente: mouseDown, mouseUp, click, mouseDown, mouseUp. Tutti questi eventi devono avere la stessa destinazione dell'evento doubleClick. Il secondo clic, rappresentato dai secondi eventi mouseDown e mouseUp, deve verificarsi entro un intervallo di tempo specifico dopo l'evento click. La lunghezza consentita per questo intervallo varia a seconda del sistema operativo e può essere spesso configurata dall'utente. Se la destinazione è un campo di testo selezionabile, il comportamento predefinito è la selezione della parola che si trova sotto il puntatore. Se l'oggetto InteractiveObject di destinazione non ha il flag doubleClickEnabled impostato su true, riceve due eventi click.

La proprietà doubleClickEnabled è false per impostazione predefinita.

Il comportamento di selezione del testo mediante doppio clic di un oggetto TextField non è correlato all'evento doubleClick. Utilizzate TextField.doubleClickEnabled per controllare le selezioni TextField.

Questo evento ha le seguenti proprietà:

Elementi API correlati

Inviato dopo che un oggetto di visualizzazione ha ricevuto lo stato di attivazione. Questa situazione si verifica quando un utente evidenzia l'oggetto con un dispositivo di puntamento o mediante la tastiera. L'oggetto che riceve lo stato di attivazione è l'oggetto target di questo evento, mentre l'istanza InteractiveObject corrispondente che perde lo stato di attivazione è l'oggetto correlato. Un riferimento all'oggetto correlato viene memorizzato nella proprietà relatedObject dell'oggetto di destinazione. La proprietà shiftKey non viene utilizzata. Questo evento segue l'invio dell'evento focusOut dell'oggetto precedente.

Questo evento ha le seguenti proprietà:

Inviato dopo che un oggetto di visualizzazione ha perso lo stato di attivazione. Questa situazione si verifica quando un utente evidenzia un oggetto diverso con un dispositivo di puntamento o mediante la tastiera. L'oggetto che perde lo stato di attivazione è l'oggetto target di questo evento, mentre l'istanza InteractiveObject corrispondente che riceve lo stato di attivazione è l'oggetto correlato. Un riferimento all'oggetto correlato viene memorizzato nella proprietà relatedObject dell'oggetto target. La proprietà shiftKey non viene utilizzata. Questo evento precede l'invio dell'evento focusIn da parte dell'oggetto correlato.

Questo evento ha le seguenti proprietà:

Inviato quanto l’utente crea un punto di contatto lungo il bordo della superficie di contatto con un’istanza di InteractiveObject (ad esempio toccando bordo della superficie di contatto in Siri Remote per Apple TV). Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di più eventi touch.

In particolare, se un utente appoggia un dito su un InteractiveObject e quindi lo allontana, l’istanza di InteractiveObject può inviare un evento touchBegin e un evento touchEnd (tra gli altri), oltre all’evento gestureDirectionalTap, oppure tutti, se l’ambiente corrente supporta questa funzionalità. Scegliete in che modo desiderate gestire l'interazione dell'utente. Utilizzate la classe flash.ui.Multitouch per controllare la gestione dell'evento touch (abilitate la gestione dell'evento touch gesture o dell'evento touch point oppure disabilitate gli eventi touch in modo che vengano inviati solo gli eventi del mouse). Se scegliete di gestire l’evento touchBegin, su un dispositivo abilitato per il tocco viene eseguito lo stesso gestore di eventi. In ogni caso, se scegliete di gestire l’evento gestureDirectionalTap, potete progettare il gestore di eventi in modo che risponda alle esigenze specifiche di un ambiente abilitato per il tocco e migliorare l’esperienza utente. Potete anche gestire entrambi gli eventi separatamente, in modo da fornire una risposta diversa per un evento gesto rispetto a un evento touch. Spetta tuttavia alla classe flash.ui.Multitouch determinare se attivare un evento touch o un evento gesto.

Quando gestite le proprietà dell’oggetto evento, ricordate che le proprietà localX e localY vengono impostate sul punto di contatto principale (per Apple TV è il centro dello schermo). Le proprietà offsetX e offsetY corrispondono alla direzione del gesto.

Nota: questa API supporta il tocco direzionale esclusivamente con un solo dito.

L'oggetto TransformGestureEvent ha le proprietà seguenti:

Elementi API correlati

Inviato quanto l'utente preme due punti di contatto sulla stessa istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia due dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). Alcuni dispositivi possono inoltre interpretare questo contatto come un evento doubleClick.

In particolare, se un utente tocca con due dita su InteractiveObject, l'istanza InteractiveObject potrebbe inviare un evento doubleClick o un evento gestureTwoFingerTap oppure entrambi se l'ambiente corrente supporta questa funzionalità. Scegliete in che modo desiderate gestire l'interazione dell'utente. Utilizzate la classe flash.ui.Multitouch per controllare la gestione dell'evento touch (abilitate la gestione dell'evento touch gesture o dell'evento touch point oppure disabilitate gli eventi touch in modo che vengano inviati solo gli eventi del mouse). Se scegliete di gestire l'evento doubleClick, lo stesso gestore di eventi verrà eseguito sia su un dispositivo abilitato per il tocco che su un dispositivo abilitato per il mouse. Se, tuttavia, scegliete di gestire l'evento gestureTwoFingerTap, potete progettare il gestore di eventi in modo che risponda alle esigenze specifiche di un ambiente abilitato per il tocco e migliorare l'esperienza utente. Potete anche gestire entrambi gli eventi separatamente, in modo da fornire una risposta diversa per un evento touch rispetto a un evento del mouse.

Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.

Elementi API correlati

Inviato quanto l'utente sposta un punto di contatto sull'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, sposta un dito da sinistra a destra su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). Alcuni dispositivi possono inoltre interpretare questo contatto come un evento mouseOver e un evento touchOver.

In particolare, se un utente sposta un dito su InteractiveObject, l'istanza InteractiveObject potrebbe inviare un evento mouseOver o un evento touchOver o gesturePan oppure tutti se l'ambiente corrente supporta questa funzionalità. Scegliete in che modo desiderate gestire l'interazione dell'utente. Utilizzate la classe flash.ui.Multitouch per controllare la gestione dell'evento touch (abilitate la gestione dell'evento touch gesture o dell'evento touch point oppure disabilitate gli eventi touch in modo che vengano inviati solo gli eventi del mouse). Se scegliete di gestire l'evento mouseOver, lo stesso gestore di eventi verrà eseguito sia su un dispositivo abilitato per il tocco che su un dispositivo abilitato per il mouse. Se, tuttavia, scegliete di gestire l'evento gesturePan, potete progettare il gestore di eventi in modo che risponda alle esigenze specifiche di un ambiente abilitato per il tocco e migliorare l'esperienza utente. Potete anche gestire entrambi gli eventi separatamente, in modo da fornire una risposta diversa per un evento touch rispetto a un evento del mouse.

Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.

L'oggetto TransformGestureEvent ha le proprietà seguenti:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Elementi API correlati

Inviato quanto l'utente esegue un'operazione di rotazione in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e le ruota su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). La rotazione con due dita è un'operazione comune, ma ogni dispositivo e sistema operativo può avere requisiti specifici per indicare la rotazione. Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di diversi eventi del mouse.

In particolare, se un utente sposta un dito su InteractiveObject, l'istanza InteractiveObject potrebbe inviare un evento mouseOver e (tra gli altri) un evento click oltre all'evento gestureRotate oppure tutti se l'ambiente corrente supporta questa funzionalità. Scegliete in che modo desiderate gestire l'interazione dell'utente. Utilizzate la classe flash.ui.Multitouch per controllare la gestione dell'evento touch (abilitate la gestione dell'evento touch gesture o dell'evento touch point oppure disabilitate gli eventi touch in modo che vengano inviati solo gli eventi del mouse). Se scegliete di gestire l'evento mouseOver, lo stesso gestore di eventi verrà eseguito sia su un dispositivo abilitato per il tocco che su un dispositivo abilitato per il mouse. Se, tuttavia, scegliete di gestire l'evento gestureRotate, potete progettare il gestore di eventi in modo che risponda alle esigenze specifiche di un ambiente abilitato per il tocco e migliorare l'esperienza utente. Potete anche gestire entrambi gli eventi separatamente, in modo da fornire una risposta diversa per un evento touch rispetto a un evento del mouse.

Quando gestite le proprietà dell'oggetto evento, tenete presente che le proprietà localX e localY vengono impostate sul primo punto di contatto. Le proprietà offsetX e offsetY corrispondono alla distanza dal punto di contatto dove si completa l'operazione di rotazione.

Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.

Durante questo evento, la proprietà rotation contiene l’angolo di rotazione. I valori di rotazione sono i seguenti:

• Da 0 a 180 gradi per la rotazione in senso orario
• Da -180 a 0 gradi per la rotazione in senso antiorario

L'oggetto TransformGestureEvent ha le proprietà seguenti:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Elementi API correlati

Inviato quanto l'utente esegue un'operazione di tocco in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con tre dita e quindi le sposta parallelamente su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). Lo spostamento di più dita parallelamente è un'operazione di tocco comune, ma ogni dispositivo e sistema operativo può avere requisiti specifici per indicare un tocco. Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di diversi eventi del mouse.

In particolare, se un utente sposta un dito su InteractiveObject e quindi sposta le dita insieme, l'istanza InteractiveObject potrebbe inviare un evento rollOver e (tra gli altri) un evento rollOut, oltre all'evento gestureSwipe oppure tutti se l'ambiente corrente supporta questa funzionalità. Scegliete in che modo desiderate gestire l'interazione dell'utente. Se scegliete di gestire l'evento rollOver, lo stesso gestore di eventi verrà eseguito sia su un dispositivo abilitato per il tocco che su un dispositivo abilitato per il mouse. Se, tuttavia, scegliete di gestire l'evento gestureSwipe, potete progettare il gestore di eventi in modo che risponda alle esigenze specifiche di un ambiente abilitato per il tocco e migliorare l'esperienza utente. Potete anche gestire entrambi gli eventi separatamente, in modo da fornire una risposta diversa per un evento touch rispetto a un evento del mouse.

Quando gestite le proprietà dell'oggetto evento, tenete presente che le proprietà localX e localY vengono impostate sul primo punto di contatto. Le proprietà offsetX e offsetY corrispondono alla distanza dal punto di contatto dove si completa l'operazione di tocco.

Nota: mentre alcuni dispositivi che utilizzano il sistema operativo Mac OS possono interpretare un tocco con quattro dita, questa API supporta solo un tocco con tre dita.

L'oggetto TransformGestureEvent ha le proprietà seguenti:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

Elementi API correlati

Inviato quanto l'utente crea un punto di contatto con un'istanza InteractiveObject, quindi tocca un dispositivo abilitato per il tocco (ad esempio, posiziona più dita su un oggetto di visualizzazione per aprire un menu e quindi tocca con un dito per selezionare una voce di menu su un cellulare o su un Tablet PC con touch screen). Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di diversi eventi del mouse.

In particolare, se un utente sposta un dito su InteractiveObject e quindi utilizza un tocco secondario, l'istanza InteractiveObject potrebbe inviare un evento mouseOver e (tra gli altri) un evento click, oltre all'evento gesturePressAndTap oppure tutti se l'ambiente corrente supporta questa funzionalità. Scegliete in che modo desiderate gestire l'interazione dell'utente. Utilizzate la classe flash.ui.Multitouch per controllare la gestione dell'evento touch (abilitate la gestione dell'evento touch gesture o dell'evento touch point oppure disabilitate gli eventi touch in modo che vengano inviati solo gli eventi del mouse). Se scegliete di gestire l'evento mouseOver, lo stesso gestore di eventi verrà eseguito sia su un dispositivo abilitato per il tocco che su un dispositivo abilitato per il mouse. Se, tuttavia, scegliete di gestire l'evento gesturePressAndTap, potete progettare il gestore di eventi in modo che risponda alle esigenze specifiche di un ambiente abilitato per il tocco e migliorare l'esperienza utente. Potete anche gestire entrambi gli eventi separatamente, in modo da fornire una risposta diversa per un evento touch rispetto a un evento del mouse.

Quando gestite le proprietà dell'oggetto evento, tenete presente che le proprietà localX e localY vengono impostate sul punto di contatto principale (l'azione "push"). Le proprietà offsetX e offsetY corrispondono alla distanza dal punto di contatto secondario (l'azione "tap").

Elementi API correlati

Inviato quanto l'utente esegue un'operazione di zoom in corrispondenza di un punto di contatto con un'istanza InteractiveObject (ad esempio, tocca lo schermo con due dita e allontana velocemente le dita su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). L'allontanamento delle dita è un'operazione di zoom comune, ma ogni dispositivo e sistema operativo può avere requisiti specifici per indicare lo zoom. Alcuni dispositivi possono inoltre interpretare questo contatto come una combinazione di diversi eventi del mouse.

In particolare, se un utente sposta un dito su InteractiveObject e quindi allontana le dita, l'istanza InteractiveObject potrebbe inviare un evento mouseOver e (tra gli altri) un evento click, oltre all'evento gestureZoom oppure tutti se l'ambiente corrente supporta questa funzionalità. Scegliete in che modo desiderate gestire l'interazione dell'utente. Utilizzate la classe flash.ui.Multitouch per controllare la gestione dell'evento touch (abilitate la gestione dell'evento touch gesture o dell'evento touch point oppure disabilitate gli eventi touch in modo che vengano inviati solo gli eventi del mouse). Se scegliete di gestire l'evento mouseOver, lo stesso gestore di eventi verrà eseguito sia su un dispositivo abilitato per il tocco che su un dispositivo abilitato per il mouse. Se, tuttavia, scegliete di gestire l'evento gestureZoom, potete progettare il gestore di eventi in modo che risponda alle esigenze specifiche di un ambiente abilitato per il tocco e migliorare l'esperienza utente. Potete anche gestire entrambi gli eventi separatamente, in modo da fornire una risposta diversa per un evento touch rispetto a un evento del mouse.

Quando gestite le proprietà dell'oggetto evento, tenete presente che le proprietà localX e localY vengono impostate sul primo punto di contatto. Le proprietà offsetX e offsetY corrispondono alla distanza dal punto di contatto dove si completa l'operazione di zoom.

Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.

L'oggetto TransformGestureEvent ha le proprietà seguenti:

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Elementi API correlati

Questo evento viene inviato a qualsiasi applicazione client che supporti input in linea con un IME.

Inviato quando l'utente preme un tasto. Le mappature tra tasti e caratteri specifici variano a seconda del dispositivo e del sistema operativo. Questo tipo di evento viene generato dopo una tale mappatura ma prima dell'elaborazione di un IME (input method editor). Gli IME vengono utilizzati per immettere caratteri particolari, ad esempio gli ideogrammi cinesi, che la tastiera QWERTY standard non è adatta a produrre. Questo evento si verifica prima dell'evento keyUp.

In AIR, l'annullamento di questo evento impedisce l'immissione del carattere in un campo di testo.

Questo evento ha le seguenti proprietà:

Altri esempi

Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando la tastiera. Il comportamento predefinito di questo evento è la modifica dello stato di attivazione e l'invio degli eventi focusIn e focusOut corrispondenti.

Questo evento viene inviato all'oggetto attivo. L'oggetto correlato a questo evento è l'istanza InteractiveObject che riceve l'attivazione se non si disabilita il comportamento predefinito. La modifica dello stato di attivazione può essere evitata chiamando il metodo preventDefault() su un listener di eventi correttamente registrato con l'oggetto target. Cambia l'elemento attivo e gli eventi focusIn e focusOut vengono inviati per impostazione predefinita.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente rilascia un tasto. Le mappature tra tasti e caratteri specifici variano a seconda del dispositivo e del sistema operativo. Questo tipo di evento viene generato dopo una tale mappatura ma prima dell'elaborazione di un IME (input method editor). Gli IME vengono utilizzati per immettere caratteri particolari, ad esempio gli ideogrammi cinesi, che la tastiera QWERTY standard non è adatta a produrre. Questo evento si verifica dopo un evento keyDown e ha le seguenti caratteristiche:

Questo evento ha le seguenti proprietà:

Inviato quando l'utente preme e rilascia il pulsante centrale del dispositivo di puntamento sopra lo stesso InteractiveObject. Perché si verifichi un evento middleClick, esso deve seguire sempre questa serie di eventi nell'ordine seguente: evento middleMouseDown, quindi middleMouseUp L'oggetto target deve essere lo stesso per entrambi gli eventi, altrimenti l'evento middleClick non si verifica. Tra gli eventi middleMouseDown o middleMouseUp può verificarsi qualsiasi numero di eventi del mouse in qualunque momento; l'evento middleClick si verifica in ogni caso.

Questo evento ha le seguenti proprietà:

Inviato quando un utente preme il pulsante centrale del dispositivo di puntamento su un'istanza InteractiveObject.

Questo evento ha le seguenti proprietà:

Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.

Questo evento ha le seguenti proprietà:

Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. Se la destinazione è un'istanza SimpleButton, il comportamento predefinito dell'istanza è la visualizzazione dell'oggetto di visualizzazione downState. Se la destinazione è un campo di testo selezionabile, il comportamento predefinito è l'inizio della selezione nel campo di testo.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando un dispositivo di puntamento. Il comportamento predefinito di questo evento è la modifica dello stato di attivazione e l'invio degli eventi focusIn e focusOut corrispondenti.

Questo evento viene inviato all'oggetto attivo. L'oggetto correlato a questo evento è l'istanza InteractiveObject che riceve l'attivazione se non si disabilita il comportamento predefinito. La modifica dello stato di attivazione può essere evitata chiamando preventDefault() su un listener di eventi correttamente registrato con l'oggetto target. La proprietà shiftKey non viene utilizzata. Cambia l'elemento attivo e gli eventi focusIn e focusOut vengono inviati per impostazione predefinita.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente sposta il dispositivo di puntamento mentre si trova sopra un'istanza InteractiveObject. Se la destinazione è un campo di testo che l'utente sta selezionando, il comportamento predefinito è l'aggiornamento della selezione.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject. La destinazione dell'evento è l'oggetto precedente che si trovava sotto il dispositivo di puntamento. relatedObject è l'oggetto sul quale si è spostato il dispositivo di puntamento. Se la destinazione è un'istanza SimpleButton, il comportamento predefinito dell'oggetto è la visualizzazione dell'oggetto di visualizzazione upState.

L'evento mouseOut viene inviato ogni volta che il mouse esce dall'area di qualunque oggetto secondario del contenitore di oggetto di visualizzazione, anche se il mouse rimane sopra un altro oggetto secondario del contenitore. Si tratta di un comportamento che non si addice allo scopo dell'evento rollOut, che è quello di semplificare la codifica dei comportamenti di rollover per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando il mouse esce dall'area di un oggetto di visualizzazione o dall'area di uno dei suoi elementi secondari per passare a un oggetto che non è uno dei suoi elementi secondari, l'oggetto di visualizzazione invia l'evento rollOut. Gli eventi rollOut vengono inviati consecutivamente verso l'alto lungo la catena di elementi superiori dell'oggetto, a partire da quell'oggetto e fino ad arrivare all'elemento superiore più alto che non sia né l'elemento principale né un antenato di relatedObject.

Questo evento ha le seguenti proprietà:

Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject. relatedObject è l'oggetto precedente che si trovava sotto il dispositivo di puntamento. Se la destinazione è un'istanza SimpleButton, il comportamento predefinito dell'oggetto è la visualizzazione dell'oggetto di visualizzazione overState o upState, a seconda che il pulsante del mouse sia premuto o meno.

L'evento mouseOver viene inviato ogni volta che il mouse entra nell'area di qualunque oggetto secondario del contenitore di oggetto di visualizzazione, anche se il mouse si trovava già sopra un altro oggetto secondario del contenitore. Si tratta di un comportamento che non si addice allo scopo dell'evento rollOver, che è quello di semplificare la codifica dei comportamenti di rollout per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando il mouse entra nell'area di un oggetto di visualizzazione o di qualsiasi suo elemento secondario da un oggetto che non è un suo elemento secondario, l'oggetto di visualizzazione invia l'evento rollOver. Gli eventi rollOver vengono inviati consecutivamente verso il basso lungo la catena di elementi superiori dell'oggetto, a partire dall'elemento superiore più alto che non sia né l'elemento principale né un antenato di relatedObject e fino ad arrivare a quell'oggetto.

Questo evento ha le seguenti proprietà:

Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. Se la destinazione è un'istanza SimpleButton, l'oggetto visualizza l'oggetto di visualizzazione upState. Se la destinazione è un campo di testo selezionabile, il comportamento predefinito è la fine della selezione nel campo di testo.

Questo evento ha le seguenti proprietà:

Inviato quando si fa ruotare la rotella del mouse su un'istanza InteractiveObject. Se la destinazione è un campo di testo, il comportamento predefinito del testo è lo scorrimento. Disponibile solo nei sistemi operativi Microsoft Windows.

Questo evento ha le seguenti proprietà:

Inviato dall'iniziatore del trascinamento InteractiveObject quando l'utente rilascia il trascinamento.

La proprietà dropAction dell'evento indica l'azione impostata dall'oggetto di destinazione del trascinamento; il valore "none" (DragActions.NONE) indica che il rilascio è stato annullato o non è stato accettato.

Il gestore di eventi nativeDragComplete è comodo per aggiornare lo stato dell'oggetto di visualizzazione che ha iniziato l'azione, ad esempio, rimuovendo una voce da un elenco (in un'azione di trascinamento di tipo "move") o modificando le proprietà visive.

Questo evento ha le seguenti proprietà:

Inviato dall'InteractiveObject di destinazione quando un oggetto trascinato viene rilasciato su di esso e il rilascio è stato accettato con una chiamata a DragManager.acceptDragDrop().

Accedete ai dati rilasciati mediante la proprietà clipboard dell'oggetto evento.

Il gestore di questo evento deve impostare la proprietà DragManager.dropAction per fornire feedback all'oggetto initiator riguardo all'azione di trascinamento effettuata. Se non è impostato alcun valore, DragManager seleziona un valore predefinito dall'elenco di azioni consentite.

Questo evento ha le seguenti proprietà: