Pacchetto | flash.display |
Classe | public class InteractiveObject |
Ereditarietà | InteractiveObject DisplayObject EventDispatcher Object |
Sottoclassi | DisplayObjectContainer, SimpleButton, TextField |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Non è possibile creare direttamente un'istanza della classe InteractiveObject. Una chiamata alla funzione di costruzione new InteractiveObject()
genera un'eccezione ArgumentError
.
La classe InteractiveObject stessa non include alcuna API per il rendering del contenuto sullo schermo. Per creare una sottoclasse personalizzata della classe InteractiveObject, potete estendere una delle sue sottoclassi che contengono delle API per il rendering del contenuto sullo schermo, quali Sprite, SimpleButton, TextField o MovieClip.
Altre informazioni
Elementi fondamentali della programmazione degli elementi visivi
Classi di visualizzazione di base
Proprietà | Definito da | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
L'implementazione di accessibilità corrente (AccessibilityImplementation) di questa istanza InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Le opzioni di accessibilità correnti di questo oggetto di visualizzazione. | DisplayObject | ||
alpha : Number
Indica il valore della trasparenza alfa dell'oggetto specificato. | DisplayObject | ||
blendMode : String
Un valore della classe BlendMode che specifica il metodo di fusione da utilizzare. | DisplayObject | ||
blendShader : Shader [sola scrittura]
Imposta uno shader utilizzato per la fusione dei colori di primo piano e sfondo. | DisplayObject | ||
cacheAsBitmap : Boolean
Se è impostata su true, nella cache dei runtime Flash viene memorizzata una rappresentazione bitmap interna dell'oggetto di visualizzazione. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Se il valore è diverso da null, questo oggetto Matrix definisce il modo in cui viene eseguito il rendering di un oggetto di visualizzazione quando cacheAsBitmap è impostato su true. | DisplayObject | ||
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
contextMenu : NativeMenu
Specifica il menu di scelta rapida associato all'oggetto. | InteractiveObject | ||
doubleClickEnabled : Boolean
Specifica se l'oggetto riceve gli eventi doubleClick. | InteractiveObject | ||
filters : Array
Un array indicizzato che contiene ogni oggetto filtro attualmente associato all'oggetto di visualizzazione. | DisplayObject | ||
focusRect : Object
Specifica se l'oggetto visualizza un rettangolo di attivazione. | InteractiveObject | ||
height : Number
Indica l'altezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | ||
loaderInfo : LoaderInfo [sola lettura]
Restituisce un oggetto LoaderInfo contenente informazioni sul caricamento del file al quale questo oggetto di visualizzazione appartiene. | DisplayObject | ||
mask : DisplayObject
L'oggetto di visualizzazione chiamante viene mascherato dall'oggetto mask specificato. | DisplayObject | ||
metaData : Object
Ottiene l’oggetto di metadati dell’istanza DisplayObject se i metadati sono stati memorizzati insieme all’istanza di questo DisplayObject nel file SWF mediante un tag PlaceObject4. | DisplayObject | ||
mouseEnabled : Boolean
Specifica se questo oggetto riceve messaggi del mouse o di altri dispositivi di input dell'utente. | InteractiveObject | ||
mouseX : Number [sola lettura]
Indica la coordinata x del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | ||
mouseY : Number [sola lettura]
Indica la coordinata y del mouse o la posizione del dispositivo di input dell'utente, espressa in pixel. | DisplayObject | ||
name : String
Indica il nome dell'istanza dell'oggetto DisplayObject. | DisplayObject | ||
needsSoftKeyboard : Boolean
Specifica se deve essere visualizzata una tastiera virtuale (una tastiera software a video) quando questa istanza InteractiveObject riceve lo stato di attivazione. | InteractiveObject | ||
opaqueBackground : Object
Specifica se l'oggetto di visualizzazione è opaco con un determinato colore di sfondo. | DisplayObject | ||
parent : DisplayObjectContainer [sola lettura]
Indica l'oggetto DisplayObjectContainer che contiene questo oggetto di visualizzazione. | DisplayObject | ||
root : DisplayObject [sola lettura]
Nel caso di un oggetto di visualizzazione all'interno di un file SWF caricato, la proprietà principale è l'oggetto di visualizzazione più in alto nella porzione della struttura dell'elenco di visualizzazione rappresentata da quel file SWF. | DisplayObject | ||
rotation : Number
Indica la rotazione dell'istanza DisplayObject, espressa in gradi, rispetto alla posizione originale. | DisplayObject | ||
rotationX : Number
Indica la rotazione dell'asse x dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
rotationY : Number
Indica la rotazione dell'asse y dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
rotationZ : Number
Indica la rotazione dell'asse z dell'istanza DisplayObject, espressa in gradi, rispetto all'orientamento originale relativo al contenitore principale 3D. | DisplayObject | ||
scale9Grid : Rectangle
La griglia di modifica in scala attualmente attiva. | DisplayObject | ||
scaleX : Number
Indica la scala orizzontale (percentuale) dell'oggetto applicata dal punto di registrazione. | DisplayObject | ||
scaleY : Number
Indica la scala verticale (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | ||
scaleZ : Number
Indica la scala di profondità (percentuale) di un oggetto applicata dal punto di registrazione dell'oggetto. | DisplayObject | ||
scrollRect : Rectangle
I limiti del rettangolo di scorrimento dell'oggetto di visualizzazione. | DisplayObject | ||
softKeyboard : String
Controlla l'aspetto della tastiera software. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Definisce l’area che deve rimanere visibile sullo schermo quando è visualizzata una tastiera virtuale (non disponibile in iOS). | InteractiveObject | ||
stage : Stage [sola lettura]
Lo stage dell'oggetto di visualizzazione. | DisplayObject | ||
tabEnabled : Boolean
Specifica se questo oggetto è incluso nell'ordine di tabulazione. | InteractiveObject | ||
tabIndex : int
Specifica l'ordine di tabulazione degli oggetti in un file SWF. | InteractiveObject | ||
transform : flash.geom:Transform
Un oggetto con proprietà relative alla matrice, alla trasformazione del colore e ai limiti di pixel di un oggetto di visualizzazione. | DisplayObject | ||
visible : Boolean
Determina se l'oggetto di visualizzazione è visibile o meno. | DisplayObject | ||
width : Number
Indica la larghezza dell'oggetto di visualizzazione espressa in pixel. | DisplayObject | ||
x : Number
Indica la coordinata x dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | ||
y : Number
Indica la coordinata y dell'istanza DisplayObject relativa alle coordinate locali del DisplayObjectContainer principale. | DisplayObject | ||
z : Number
Indica la posizione della coordinata z lungo l'asse z dell'istanza DisplayObject relativa al contenitore principale 3D. | DisplayObject |
Metodo | Definito da | ||
---|---|---|---|
Una chiamata alla nuova funzione di costruzione InteractiveObject() genera un'eccezione ArgumentError. | InteractiveObject | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
Restituisce un rettangolo che definisce l'area dell'oggetto di visualizzazione relativa al sistema di coordinate dell'oggetto targetCoordinateSpace. | DisplayObject | ||
Restituisce un rettangolo che definisce i bordi dell'oggetto di visualizzazione in base al sistema di coordinate definito dal parametro targetCoordinateSpace, esclusi gli eventuali tratti presenti sulle forme. | DisplayObject | ||
Converte le coordinate dello stage (globali) in quelle (locali) dell'oggetto di visualizzazione per l'oggetto Point. | DisplayObject | ||
Converte un punto bidimensionale dalle coordinate dello stage (globali) in quelle (locali) di un oggetto di visualizzazione tridimensionale. | DisplayObject | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Valuta il riquadro di delimitazione dell'oggetto di visualizzazione per verificare se si sovrappone o si interseca con il riquadro di delimitazione dell'oggetto di visualizzazione obj. | DisplayObject | ||
Valuta l'oggetto di visualizzazione per stabilire se si sovrappone o si interseca con il punto specificato dai parametri x e y. | DisplayObject | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Converte un punto tridimensionale delle coordinate (locali) dell'oggetto di visualizzazione tridimensionale in un punto bidimensionale nelle coordinate dello stage (globali). | DisplayObject | ||
Converte le coordinate dell'oggetto di visualizzazione (locali) in quelle dello stage (globali) per l'oggetto Point. | DisplayObject | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | ||
Alza una tastiera virtuale. | InteractiveObject | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher |
Evento | Riepilogo | Definito da | ||
---|---|---|---|---|
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | |||
Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione. | DisplayObject | |||
Inviato quando un oggetto di visualizzazione viene aggiunto all'elenco di visualizzazione sullo stage, sia direttamente o mediante l'aggiunta di una sottostruttura ad albero che contiene l'oggetto di visualizzazione. | DisplayObject | |||
Inviato quando l'utente sceglie "Cancella" (o "Elimina") dal menu di scelta rapida per il testo. | InteractiveObject | |||
Inviato quando l'utente preme e rilascia il pulsante principale del dispositivo di puntamento sopra lo stesso InteractiveObject. | InteractiveObject | |||
Inviato quando un'azione dell'utente causa la visualizzazione del menu di scelta rapida associato a questo oggetto interattivo in un'applicazione AIR. | InteractiveObject | |||
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. | InteractiveObject | |||
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. | InteractiveObject | |||
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | |||
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. | InteractiveObject | |||
[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta entrando in un nuovo fotogramma. | DisplayObject | |||
[evento di trasmissione] Inviato quando l'indicatore di riproduzione sta per uscire dal fotogramma corrente. | DisplayObject | |||
Inviato dopo che un oggetto di visualizzazione ha ricevuto lo stato di attivazione. | InteractiveObject | |||
Inviato dopo che un oggetto di visualizzazione ha perso lo stato di attivazione. | InteractiveObject | |||
[evento di trasmissione] Inviato dopo l'esecuzione delle funzioni di costruzione degli oggetti di visualizzazione dei fotogrammi, ma prima dell'esecuzione degli script di fotogramma. | DisplayObject | |||
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. | InteractiveObject | |||
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). | InteractiveObject | |||
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). | InteractiveObject | |||
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). | InteractiveObject | |||
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). | InteractiveObject | |||
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). | InteractiveObject | |||
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). | InteractiveObject | |||
Questo evento viene inviato a qualsiasi applicazione client che supporti input in linea con un IME. | InteractiveObject | |||
Inviato quando l'utente preme un tasto. | InteractiveObject | |||
Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando la tastiera. | InteractiveObject | |||
Inviato quando l'utente rilascia un tasto. | InteractiveObject | |||
Inviato quando l'utente preme e rilascia il pulsante centrale del dispositivo di puntamento sopra lo stesso InteractiveObject. | InteractiveObject | |||
Inviato quando un utente preme il pulsante centrale del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando l'utente tenta di cambiare l'elemento attivo utilizzando un dispositivo di puntamento. | InteractiveObject | |||
Inviato quando l'utente sposta il dispositivo di puntamento mentre si trova sopra un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando si fa ruotare la rotella del mouse su un'istanza InteractiveObject. | InteractiveObject | |||
Inviato dall'iniziatore del trascinamento InteractiveObject quando l'utente rilascia il trascinamento. | InteractiveObject | |||
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(). | InteractiveObject | |||
Inviato da un InteractiveObject quando un trascinamento entra nei suoi limiti. | InteractiveObject | |||
Inviato da un InteractiveObject quando un trascinamento esce dai propri limiti. | InteractiveObject | |||
Inviato continuamente da un InteractiveObject mentre un'azione di trascinamento rimane all'interno dei suoi limiti. | InteractiveObject | |||
Inviato all'inizio di un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag(). | InteractiveObject | |||
Inviato durante un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag(). | InteractiveObject | |||
Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di incollare oppure sceglie "Incolla" dal menu di scelta rapida testuale. | InteractiveObject | |||
Inviato quando l'utente abbassa uno stilo attivo oltre la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | |||
Inviato quando l'utente solleva uno stilo attivo sopra la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | |||
Inviato quando l'utente sposta uno stilo attivo sullo schermo rimanendo entro la soglia di rilevamento della prossimità. | InteractiveObject | |||
Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | |||
Inviato quando l'utente sposta uno stilo attivo direttamente sopra questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | |||
Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject o da qualsiasi suo elemento secondario rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo. | InteractiveObject | |||
Inviato quando l'utente sposta uno stilo attivo sopra questo InteractiveObject dall'esterno della struttura di discendenti dell'oggetto nell'elenco di visualizzazione (rimanendo entro la soglia di rilevamento della prossimità dello schermo). | InteractiveObject | |||
Inviato quando un utente rilascia il pulsante del dispositivo di puntamento dopo averlo premuto sopra un’istanza InteractiveObject e aver quindi spostato il dispositivo di puntamento fuori dell’istanza stessa. | InteractiveObject | |||
Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione. | DisplayObject | |||
Inviato quando un oggetto di visualizzazione sta per essere rimosso dall'elenco di visualizzazione sullo stage, sia direttamente o mediante la rimozione di una sottostruttura ad albero che contiene l'oggetto di visualizzazione. | DisplayObject | |||
[evento di trasmissione] Inviato quando stanno per essere eseguiti l'aggiornamento e il rendering dell'elenco di visualizzazione. | DisplayObject | |||
Inviato quando l'utente preme e rilascia il pulsante destro del dispositivo di puntamento sopra lo stesso InteractiveObject. | InteractiveObject | |||
Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando l'utente allontana un dispositivo di puntamento da un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject. | InteractiveObject | |||
Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di selezionare tutto oppure sceglie "Seleziona tutto" dal menu di scelta rapida testuale. | InteractiveObject | |||
Inviato immediatamente dopo la visualizzazione della tastiera software. | InteractiveObject | |||
Inviato immediatamente prima della visualizzazione della tastiera software. | InteractiveObject | |||
Inviato immediatamente dopo la chiusura della tastiera software. | InteractiveObject | |||
Inviato quando cambia il valore del flag tabChildren dell'oggetto. | InteractiveObject | |||
Inviato quando cambia il flag tabEnabled dell'oggetto. | InteractiveObject | |||
Inviato quando cambia il valore della proprietà tabIndex dell'oggetto. | InteractiveObject | |||
Inviato quando un utente immette uno o più caratteri di testo. | InteractiveObject | |||
Inviato quanto l'utente stabilisce per la prima volta un contatto con un dispositivo abilitato per il tocco (ad esempio, tocca con un dito un cellulare o un Tablet PC con touch screen). | InteractiveObject | |||
Inviato quanto l'utente rimuove il contatto con un dispositivo abilitato per il tocco (ad esempio, solleva un dito da un cellulare o un Tablet PC con touch screen). | InteractiveObject | |||
Inviato quando l'utente tocca il dispositivo, e viene inviato in modo continuativo finché il punto di contatto non viene rimosso. | InteractiveObject | |||
Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un altro disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | |||
Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | |||
Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un punto esterno a un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | |||
Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto su un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject | |||
Inviato quanto l'utente solleva il punto di contatto sulla stessa istanza InteractiveObject in corrispondenza della quale è stato iniziato il contatto su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia un dito da un oggetto di visualizzazione disponibile su un cellulare o su un Tablet PC con touch screen). | InteractiveObject |
accessibilityImplementation | proprietà |
accessibilityImplementation:AccessibilityImplementation
Versione linguaggio: | ActionScript 3.0 |
L'implementazione di accessibilità corrente (AccessibilityImplementation) di questa istanza InteractiveObject.
Implementazione
public function get accessibilityImplementation():AccessibilityImplementation
public function set accessibilityImplementation(value:AccessibilityImplementation):void
Elementi API correlati
contextMenu | proprietà |
contextMenu:NativeMenu
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
.
Implementazione
public function get contextMenu():NativeMenu
public function set contextMenu(value:NativeMenu):void
Esempio ( Come utilizzare questo esempio )
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(); }
doubleClickEnabled | proprietà |
doubleClickEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
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
.
Implementazione
public function get doubleClickEnabled():Boolean
public function set doubleClickEnabled(value:Boolean):void
Elementi API correlati
focusRect | proprietà |
focusRect:Object
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementazione
public function get focusRect():Object
public function set focusRect(value:Object):void
mouseEnabled | proprietà |
mouseEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implementazione
public function get mouseEnabled():Boolean
public function set mouseEnabled(value:Boolean):void
Elementi API correlati
needsSoftKeyboard | proprietà |
needsSoftKeyboard:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.2, AIR 2.6 |
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.
Implementazione
public function get needsSoftKeyboard():Boolean
public function set needsSoftKeyboard(value:Boolean):void
Elementi API correlati
softKeyboard | proprietà |
softKeyboard:String
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 21.0 |
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.
Implementazione
public function get softKeyboard():String
public function set softKeyboard(value:String):void
Genera
ArgumentError — Se impostato su un valore qualsiasi che non è membro di SoftKeyboardType
|
Elementi API correlati
softKeyboardInputAreaOfInterest | proprietà |
softKeyboardInputAreaOfInterest:Rectangle
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.2, AIR 2.6 |
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.
Implementazione
public function get softKeyboardInputAreaOfInterest():Rectangle
public function set softKeyboardInputAreaOfInterest(value:Rectangle):void
Elementi API correlati
tabEnabled | proprietà |
tabEnabled:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
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
.
Implementazione
public function get tabEnabled():Boolean
public function set tabEnabled(value:Boolean):void
tabIndex | proprietà |
tabIndex:int
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
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;Per invertire l'ordine di tabulazione rispetto all'impostazione predefinita per tre istanze di un oggetto TLFTextField (
tlfInstance1
, tlfInstance2
e tlfInstance3
), utilizzate il codice seguente:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementazione
public function get tabIndex():int
public function set tabIndex(value:int):void
InteractiveObject | () | Funzione di costruzione |
public function InteractiveObject()
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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()
requestSoftKeyboard | () | metodo |
public function requestSoftKeyboard():Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.2, AIR 2.6 |
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.
RestituisceBoolean — Il valore true indica che la richiesta della tastiera virtuale è stata accettata; false indica invece che la tastiera software non è stata aperta.
|
Elementi API correlati
clear | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.CLEAR
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5, Flash Lite 4 |
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.
La costanteEvent.CLEAR
definisce il valore della proprietà type
di un oggetto evento clear
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Qualunque istanza InteractiveObject con un listener registrato per l'evento clear . |
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.
click | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.CLICK
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento click
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | Per gli eventi clic, questo valore è sempre false . |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
contextMenu | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.CONTEXT_MENU
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0 |
Inviato quando un'azione dell'utente causa la visualizzazione del menu di scelta rapida associato a questo oggetto interattivo in un'applicazione AIR.
La costanteMouseEvent.CONTEXT_MENU
definisce il valore della proprietà type
di un oggetto evento contextMenu
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante destro del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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
copy | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.COPY
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
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.
Definisce il valore della proprietàtype
di un oggetto evento copy
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Qualunque istanza InteractiveObject con un listener registrato per l'evento copy . |
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.
cut | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.CUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
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.
Definisce il valore della proprietàtype
di un oggetto evento cut
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Qualunque istanza InteractiveObject con un listener registrato per l'evento cut . |
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.
doubleClick | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.DOUBLE_CLICK
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
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.
type
di un oggetto evento doubleClick
. La proprietà doubleClickEnabled
deve essere true
perché un oggetto possa generare l'evento doubleClick
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | Per gli eventi doppio clic, questo valore è sempre false . |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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
focusIn | Evento |
flash.events.FocusEvent
proprietà FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento focusIn
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | 0; valido solo per gli eventi keyFocusChange . |
relatedObject | L'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. |
shiftKey | false ; valido solo per gli eventi keyFocusChange . |
target | L'istanza InteractiveObject che è appena stata attivata. 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.
|
direction | La direzione dalla quale l'attivazione è stata assegnata. Questa proprietà segnala il valore del parametro direction del metodo assignFocus() dello stage. Se l'attivazione viene modificata mediante altri metodi, il valore sarà sempre FocusDirection.NONE . Valido solo per gli eventi focusIn . Per tutti gli altri eventi di attivazione, il valore sarà FocusDirection.NONE . |
focusOut | Evento |
flash.events.FocusEvent
proprietà FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento focusOut
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | 0; valido solo per gli eventi keyFocusChange . |
relatedObject | L'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. |
shiftKey | false ; valido solo per gli eventi keyFocusChange . |
target | L'istanza InteractiveObject che è appena stata disattivata. 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.
|
gestureDirectionalTap | Evento |
flash.events.TransformGestureEvent
proprietà TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_DIRECTIONAL_TAP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 24, Flash Lite 4 |
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.
Definisce il valore della proprietàtype
di un oggetto evento touch GESTURE_DIRECTIONAL_TAP
.
L'oggetto TransformGestureEvent 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 | 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 strisciatura, questo valore è sempre all , che corrisponde al valore GesturePhase.ALL una volta che l'evento è stato inviato. |
localX | Coordinata orizzontale in cui si è verificato l’evento rispetto all’oggetto Sprite che lo contiene. Per i gesti tocco direzionali questo valore è il centro dello schermo. |
localY | Coordinata verticale in cui si è verificato l’evento rispetto all’oggetto Sprite che lo contiene. Per i gesti tocco direzionali questo valore è il centro dello schermo. |
scaleX | La scala orizzontale dell'oggetto di visualizzazione. Per i gesti tocco direzionali questo valore è 1 |
scaleY | La scala verticale dell'oggetto di visualizzazione. Per i gesti tocco direzionali questo valore è 1 |
rotation | L'angolo di rotazione corrente, espresso in gradi, dell'oggetto di visualizzazione lungo l'asse z. Per i gesti tocco direzionali questo valore è 0 |
offsetX | Indica la direzione orizzontale: 1 per destra e -1 per sinistra. |
offsetY | Indica la direzione verticale: 1 per basso e -1 per alto. |
velocity | Indica la velocità del gesto di strisciatura, in pixel al secondo (solo AIR). |
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
gestureLongPress | Evento |
flash.events.TapGestureEvent
proprietà TapGestureEvent.type =
flash.events.GestureEvent.GESTURE_LONG_PRESS
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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
gesturePan | Evento |
flash.events.TransformGestureEvent
proprietà TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_PAN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco GESTURE_PAN
.
L'oggetto TransformGestureEvent 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 | 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; un valore della classe GesturePhase. |
localX | La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto di visualizzazione che lo contiene. |
localY | La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto di visualizzazione che lo contiene. |
scaleX | La scala orizzontale dell'oggetto di visualizzazione, a partire dall'evento gesto precedente. Per i gesti di panoramica, questo valore è 1 . |
scaleY | La scala verticale dell'oggetto di visualizzazione, a partire dall'evento gesto precedente. Per i gesti di panoramica, questo valore è 1 . |
rotation | L'angolo di rotazione corrente, espresso in gradi, dell'oggetto di visualizzazione lungo l'asse z, a partire dall'evento gesto precedente. Per i gesti di panoramica, questo valore è 0 . |
offsetX | La traslazione orizzontale dell'oggetto di visualizzazione, a partire dalla relativa posizione in corrispondenza dell'evento gesto precedente. |
offsetY | La traslazione verticale dell'oggetto di visualizzazione, a partire dalla relativa posizione in corrispondenza dell'evento gesto precedente. |
velocity | Velocità dell’evento gesto, in pixel al secondo (solo AIR). Per i gesti di panoramica questo valore è 0 |
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. |
Esempio ( Come utilizzare questo esempio )
GESTURE_PAN
. Mentre l'utente esegue un'operazione di panoramica sul dispositivo sensibile al tocco, in myTextField viene inserita la fase corrente.
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
gestureRotate | Evento |
flash.events.TransformGestureEvent
proprietà TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ROTATE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco GESTURE_ROTATE
.
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:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows o Linux). |
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
commandKey | 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; un valore della classe GesturePhase. |
localX | La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto di visualizzazione che lo contiene. |
localY | La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto di visualizzazione che lo contiene. |
scaleX | La scala orizzontale dell'oggetto di visualizzazione, a partire dall'evento gesto precedente. |
scaleY | La scala verticale dell'oggetto di visualizzazione, a partire dall'evento gesto precedente. |
rotation | L'angolo di rotazione corrente, espresso in gradi, dell'oggetto di visualizzazione lungo l'asse z, a partire dall'evento gesto precedente. |
offsetX | La traslazione orizzontale dell'oggetto di visualizzazione, a partire dalla relativa posizione in corrispondenza dell'evento gesto precedente. |
offsetY | La traslazione verticale dell'oggetto di visualizzazione, a partire dalla relativa posizione in corrispondenza dell'evento gesto precedente. |
velocity | Velocità dell’evento gesto, in pixel al secondo (solo AIR). Per i gesti di rotazione questo valore è 0 |
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. |
Esempio ( Come utilizzare questo esempio )
GESTURE_ROTATE
. Mentre l'utente esegue un'operazione di rotazione sul dispositivo sensibile al tocco, mySprite ruota e in myTextField viene inserita la fase corrente.
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
gestureSwipe | Evento |
flash.events.TransformGestureEvent
proprietà TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_SWIPE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco GESTURE_SWIPE
.
L'oggetto TransformGestureEvent 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 | 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 strisciatura, questo valore è sempre all , che corrisponde al valore GesturePhase.ALL una volta che l'evento è stato inviato. |
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. |
scaleX | La scala orizzontale dell'oggetto di visualizzazione. Per i gesti di strisciatura, questo valore è 1 . |
scaleY | La scala verticale dell'oggetto di visualizzazione. Per i gesti di strisciatura, questo valore è 1 . |
rotation | L'angolo di rotazione corrente, espresso in gradi, dell'oggetto di visualizzazione lungo l'asse z. Per i gesti di strisciatura, questo valore è 0 . |
offsetX | Indica la direzione orizzontale: 1 per destra e -1 per sinistra. |
offsetY | Indica la direzione verticale: 1 per basso e -1 per alto. |
velocity | Indica la velocità del gesto di strisciatura, in pixel al secondo (solo AIR). In tutti gli altri casi, questo valore è 0 |
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. |
Esempio ( Come utilizzare questo esempio )
GESTURE_SWIPE
. Mentre l'utente esegue un'operazione di strisciatura sul dispositivo sensibile al tocco, myTextField esegue la compilazione con la fase all
, che è l'unica fase per gli eventi di strisciatura.
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
gestureTap | Evento |
flash.events.TapGestureEvent
proprietà TapGestureEvent.type =
flash.events.PressAndTapGestureEvent.GESTURE_TAP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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
gestureZoom | Evento |
flash.events.TransformGestureEvent
proprietà TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ZOOM
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco GESTURE_ZOOM
.
L'oggetto TransformGestureEvent 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 | 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; un valore della classe GesturePhase. |
localX | La coordinata orizzontale in cui si è verificato l'evento rispetto all'oggetto di visualizzazione che lo contiene. |
localY | La coordinata verticale in cui si è verificato l'evento rispetto all'oggetto di visualizzazione che lo contiene. |
scaleX | La scala orizzontale dell'oggetto di visualizzazione, a partire dall'evento gesto precedente. |
scaleY | La scala verticale dell'oggetto di visualizzazione, a partire dall'evento gesto precedente. |
rotation | L'angolo di rotazione corrente, espresso in gradi, dell'oggetto di visualizzazione lungo l'asse z, a partire dall'evento gesto precedente. |
offsetX | La traslazione orizzontale dell'oggetto di visualizzazione, a partire dalla relativa posizione in corrispondenza dell'evento gesto precedente. |
offsetY | La traslazione verticale dell'oggetto di visualizzazione, a partire dalla relativa posizione in corrispondenza dell'evento gesto precedente. |
velocity | Velocità dell’evento gesto, in pixel al secondo (solo AIR). Per i gesti di zoom questo valore è 0 |
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. |
Esempio ( Come utilizzare questo esempio )
GESTURE_ZOOM
. Mentre l'utente esegue un'operazione di zoom sul dispositivo sensibile al tocco, in myTextField viene inserita la fase corrente.
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
imeStartComposition | Evento |
flash.events.IMEEvent
Versioni runtime: | Flash Lite 4 |
Questo evento viene inviato a qualsiasi applicazione client che supporti input in linea con un IME.
keyDown | Evento |
flash.events.KeyboardEvent
proprietà KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
La costanteKeyboardEvent.KEY_DOWN
definisce il valore della proprietà type
di un oggetto evento keyDown
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | true in AIR, false in Flash Player; in AIR, l'annullamento di questo evento impedisce l'immissione del carattere in un campo di testo. |
charCode | Il valore del codice di carattere del tasto premuto o rilasciato. |
commandKey | true in Mac se il tasto Comando è attivo. Altrimenti false |
controlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl è attivo. Altrimenti false |
ctrlKey | true in Windows e 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. |
keyCode | Il valore del codice tasto del tasto premuto o rilasciato. |
keyLocation | La posizione del tasto sulla tastiera. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
target | L'istanza InteractiveObject attivata. 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. |
Altri esempi
keyFocusChange | Evento |
flash.events.FocusEvent
proprietà FocusEvent.type =
flash.events.FocusEvent.KEY_FOCUS_CHANGE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento keyFocusChange
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | true ; chiama il metodo preventDefault() per annullare il comportamento predefinito. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | Il valore del codice tasto del tasto premuto per attivare un evento keyFocusChange . |
relatedObject | L'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. |
shiftKey | true se il modificatore del tasto Maiusc è attivato; false in caso contrario. |
target | L'istanza corrente di InteractiveObject attivata. 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.
|
keyUp | Evento |
flash.events.KeyboardEvent
proprietà KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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:
KeyboardEvent.KEY_UP
definisce il valore della proprietà type
di un oggetto evento keyUp
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
charCode | Contiene il valore del codice di carattere del tasto premuto o rilasciato. |
commandKey | true in Mac se il tasto Comando è attivo. Altrimenti false |
controlKey | true in Windows e Linux se il tasto Ctrl è attivo. true in Mac se il tasto Ctrl è attivo. Altrimenti false |
ctrlKey | true in Windows 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. |
keyCode | Il valore del codice tasto del tasto premuto o rilasciato. |
keyLocation | La posizione del tasto sulla tastiera. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
target | L'istanza InteractiveObject attivata. 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. |
middleClick | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MIDDLE_CLICK
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
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.
type
di un oggetto evento middleClick
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | Per gli eventi clic con il pulsante centrale, questa proprietà è sempre false . |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
middleMouseDown | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_DOWN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato quando un utente preme il pulsante centrale del dispositivo di puntamento su un'istanza InteractiveObject.
Definisce il valore della proprietàtype
di un oggetto evento middleMouseDown
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante centrale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
middleMouseUp | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_UP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.
Definisce il valore della proprietàtype
di un oggetto evento middleMouseUp
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante centrale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
mouseDown | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MOUSE_DOWN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento mouseDown
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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 e 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
mouseFocusChange | Evento |
flash.events.FocusEvent
proprietà FocusEvent.type =
flash.events.FocusEvent.MOUSE_FOCUS_CHANGE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento mouseFocusChange
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | true ; chiama il metodo preventDefault() per annullare il comportamento predefinito. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
keyCode | 0; valido solo per gli eventi keyFocusChange . |
relatedObject | L'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. |
shiftKey | false ; valido solo per gli eventi keyFocusChange . |
target | L'istanza corrente di InteractiveObject attivata. 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.
|
mouseMove | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MOUSE_MOVE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Definisce il valore della proprietàtype
di un oggetto evento mouseMove
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
mouseOut | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MOUSE_OUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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
.
type
di un oggetto evento mouseOut
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
relatedObject | L'oggetto dell'elenco di visualizzazione a cui punta ora il dispositivo di puntamento. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
mouseOver | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MOUSE_OVER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento mouseOver
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
relatedObject | L'oggetto dell'elenco di visualizzazione a cui puntava il dispositivo di puntamento. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
mouseUp | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MOUSE_UP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
type
di un oggetto evento mouseUp
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
mouseWheel | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.MOUSE_WHEEL
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
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.
Definisce il valore della proprietàtype
di un oggetto evento mouseWheel
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
delta | Il numero di righe a cui corrisponde ogni scatto della rotella del mouse. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
nativeDragComplete | Evento |
flash.events.NativeDragEvent
proprietà NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
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.
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). |
nativeDragDrop | Evento |
flash.events.NativeDragEvent
proprietà NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_DROP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
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.
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). |
nativeDragEnter | Evento |
flash.events.NativeDragEvent
proprietà NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_ENTER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato da un InteractiveObject quando un trascinamento entra nei suoi limiti.
Gestite l'evento nativeDragEnter
o nativeDragOver
per consentire all'oggetto di visualizzazione di diventare la destinazione del rilascio.
Per determinare se l'oggetto di visualizzazione che invia gli eventi è in grado di accettare il rilascio, verificate l'adeguatezza dei dati nella proprietà clipboard
dell'oggetto evento e le azioni di trascinamento consentite nella proprietà allowedActions
.
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). |
nativeDragExit | Evento |
flash.events.NativeDragEvent
proprietà NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_EXIT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato da un InteractiveObject quando un trascinamento esce dai propri limiti.
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). |
nativeDragOver | Evento |
flash.events.NativeDragEvent
proprietà NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_OVER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato continuamente da un InteractiveObject mentre un'azione di trascinamento rimane all'interno dei suoi limiti.
Gli eventi nativeDragOver
vengono inviati ogni volta che si muove il mouse. In Windows e Mac, vengono inoltre inviati dopo un breve intervallo anche se il mouse non viene mosso.
Gestite l'evento nativeDragOver
o nativeDragEnter
per consentire all'oggetto di visualizzazione di diventare la destinazione del rilascio.
Per determinare se l'oggetto di visualizzazione che invia gli eventi è in grado di accettare il rilascio, verificate l'adeguatezza dei dati nella proprietà clipboard
dell'oggetto evento e le azioni di trascinamento consentite nella proprietà allowedActions
.
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). |
nativeDragStart | Evento |
flash.events.NativeDragEvent
proprietà NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_START
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato all'inizio di un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag().
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). |
nativeDragUpdate | Evento |
flash.events.NativeDragEvent
proprietà NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato durante un'operazione di trascinamento dall'InteractiveObject che è specificato come iniziatore del trascinamento nella chiamata a DragManager.doDrag().
Gli eventi nativeDragUpdate
non vengono inviati in Linux.
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). |
paste | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.PASTE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di incollare oppure sceglie "Incolla" 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 incolla il contenuto degli Appunti nel campo di testo in corrispondenza del punto di inserimento corrente, sostituendo l'eventuale testo attualmente selezionato nel campo di testo.
La costanteEvent.PASTE
definisce il valore della proprietà type
di un oggetto evento paste
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true (false per il runtime AIR). |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Qualunque istanza InteractiveObject con un listener registrato per l'evento paste . |
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.
proximityBegin | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_BEGIN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3 |
Inviato quando l'utente abbassa uno stilo attivo oltre la soglia di rilevamento della prossimità dello schermo.
La sequenza tipica di eventi che si verifica quando un utente abbassa uno stilo sullo schermo, lo muove sullo schermo e quindi lo allontana è la seguente:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.
Definisce il valore della proprietàtype
di un oggetto evento PROXIMITY_BEGIN
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
timestamp | (Solo in AIR) Il marcatore temporale dell'evento in millisecondi, relativo all'avvio dell'applicazione. |
touchIntent | (Solo in AIR) Un valore della classe TouchEventIntent. |
isTouchPointCanceled | (Solo in AIR) true se l'evento di tocco viene annullato a causa della logica di rifiuto tocchi del dispositivo. |
Elementi API correlati
proximityEnd | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_END
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3 |
Inviato quando l'utente solleva uno stilo attivo sopra la soglia di rilevamento della prossimità dello schermo.
Un evento proximityEnd non viene inviato quando lo stilo tocca lo schermo.
La sequenza tipica di eventi che si verifica quando un utente abbassa uno stilo sullo schermo, lo muove sullo schermo e quindi lo allontana è la seguente:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.
Definisce il valore della proprietàtype
di un oggetto evento PROXIMITY_END
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
timestamp | (Solo in AIR) Il marcatore temporale dell'evento in millisecondi, relativo all'avvio dell'applicazione. |
touchIntent | (Solo in AIR) Un valore della classe TouchEventIntent. |
isTouchPointCanceled | (Solo in AIR) true se l'evento di tocco viene annullato a causa della logica di rifiuto tocchi del dispositivo. |
Elementi API correlati
proximityMove | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_MOVE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3 |
Inviato quando l'utente sposta uno stilo attivo sullo schermo rimanendo entro la soglia di rilevamento della prossimità.
La sequenza tipica di eventi che si verifica quando un utente abbassa uno stilo sullo schermo, lo muove sullo schermo e quindi lo allontana è la seguente:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.
Definisce il valore della proprietàtype
di un oggetto evento PROXIMITY_MOVE
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
timestamp | (Solo in AIR) Il marcatore temporale dell'evento in millisecondi, relativo all'avvio dell'applicazione. |
touchIntent | (Solo in AIR) Un valore della classe TouchEventIntent. |
isTouchPointCanceled | (Solo in AIR) true se l'evento di tocco viene annullato a causa della logica di rifiuto tocchi del dispositivo. |
Elementi API correlati
proximityOut | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3 |
Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.
Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.
Definisce il valore della proprietàtype
di un oggetto evento PROXIMITY_OUT
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
timestamp | (Solo in AIR) Il marcatore temporale dell'evento in millisecondi, relativo all'avvio dell'applicazione. |
touchIntent | (Solo in AIR) Un valore della classe TouchEventIntent. |
isTouchPointCanceled | (Solo in AIR) true se l'evento di tocco viene annullato a causa della logica di rifiuto tocchi del dispositivo. |
Elementi API correlati
proximityOver | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OVER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3 |
Inviato quando l'utente sposta uno stilo attivo direttamente sopra questo InteractiveObject rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.
Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.
Definisce il valore della proprietàtype
di un oggetto evento PROXIMITY_OVER
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
timestamp | (Solo in AIR) Il marcatore temporale dell'evento in millisecondi, relativo all'avvio dell'applicazione. |
touchIntent | (Solo in AIR) Un valore della classe TouchEventIntent. |
isTouchPointCanceled | (Solo in AIR) true se l'evento di tocco viene annullato a causa della logica di rifiuto tocchi del dispositivo. |
Elementi API correlati
proximityRollOut | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3 |
Inviato quando l'utente allontana uno stilo attivo da questo InteractiveObject o da qualsiasi suo elemento secondario rimanendo tuttavia entro la soglia di rilevamento della prossimità dello schermo.
La destinazione dell'evento è l'oggetto che si trovava precedentemente sotto lo stilo o un elemento principale di tale oggetto. relatedObject
è l'oggetto sopra il quale si è spostato lo stilo. Gli eventi proximityRollOut
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
.
Lo scopo dell'evento proximityRollOut
è di semplificare la codifica dei comportamenti di rollover per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando lo stilo esce dall'area di un oggetto di visualizzazione o di qualsiasi suo elemento secondario per spostarsi su un oggetto che non è un suo elemento secondario, l'oggetto di visualizzazione invia l'evento proximityRollOut
. Si tratta di un comportamento diverso da quello dell'evento proximityOut
, che 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.
Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.
Definisce il valore della proprietàtype
di un oggetto evento PROXIMITY_ROLL_OUT
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
timestamp | (Solo in AIR) Il marcatore temporale dell'evento in millisecondi, relativo all'avvio dell'applicazione. |
touchIntent | (Solo in AIR) Un valore della classe TouchEventIntent. |
isTouchPointCanceled | (Solo in AIR) true se l'evento di tocco viene annullato a causa della logica di rifiuto tocchi del dispositivo. |
Elementi API correlati
proximityRollOver | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OVER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3 |
Inviato quando l'utente sposta uno stilo attivo sopra questo InteractiveObject dall'esterno della struttura di discendenti dell'oggetto nell'elenco di visualizzazione (rimanendo entro la soglia di rilevamento della prossimità dello schermo).
La destinazione dell'evento è l'oggetto che si trova sotto lo stilo o un elemento principale di tale oggetto. relatedObject
è l'oggetto precedente che si trovava sotto lo stilo. Gli eventi proximityRollOver
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.
Lo scopo dell'evento proximityRollOver
è di semplificare la codifica dei comportamenti di rollout per i contenitori di oggetti di visualizzazione che includono elementi secondari. Quando lo stilo entra nell'area sopra un oggetto di visualizzazione o sopra qualsiasi suo elemento secondario da un oggetto che non è un suo elemento secondario, l'oggetto di visualizzazione invia l'evento proximityRollOver
. Si tratta di un comportamento diverso da quello dell'evento proximityOver
, che 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.
Nota: per informazioni sulla compatibilità dell'ambiente, fate riferimento alla classe Multitouch.
Definisce il valore della proprietàtype
di un oggetto evento PROXIMITY_ROLL_OVER
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
timestamp | (Solo in AIR) Il marcatore temporale dell'evento in millisecondi, relativo all'avvio dell'applicazione. |
touchIntent | (Solo in AIR) Un valore della classe TouchEventIntent. |
isTouchPointCanceled | (Solo in AIR) true se l'evento di tocco viene annullato a causa della logica di rifiuto tocchi del dispositivo. |
Elementi API correlati
releaseOutside | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.RELEASE_OUTSIDE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 3.3, Flash Player 11.3 |
Inviato quando un utente rilascia il pulsante del dispositivo di puntamento dopo averlo premuto sopra un’istanza InteractiveObject e aver quindi spostato il dispositivo di puntamento fuori dell’istanza stessa. 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.
type
di un oggetto evento releaseOutside
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | false |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L’oggetto InteractiveObject sul quale il pulsante del dispositivo di puntamento è stato prima premuto e poi, una volta allontanato il dispositivo di puntamento dall’oggetto, rilasciato. 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. |
rightClick | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.RIGHT_CLICK
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato quando l'utente preme e rilascia il pulsante destro del dispositivo di puntamento sopra lo stesso InteractiveObject. Perché si verifichi un evento rightClick
, esso deve seguire sempre questa serie di eventi nell'ordine seguente: evento rightMouseDown
, quindi rightMouseUp
L'oggetto target deve essere lo stesso per entrambi gli eventi, altrimenti l'evento rightClick
non si verifica. Tra gli eventi mouseDown
o mouseUp
può verificarsi qualsiasi numero di eventi del mouse in qualunque momento; l'evento rightClick
si verifica in ogni caso.
type
di un oggetto evento rightClick
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | Per gli eventi clic con il pulsante destro, questa proprietà è sempre false . |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
rightMouseDown | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_DOWN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato quando un utente preme il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.
Definisce il valore della proprietàtype
di un oggetto evento rightMouseDown
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | Per gli eventi clic con il pulsante destro, questa proprietà è sempre true . |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
rightMouseUp | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_UP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Lite 4 |
Inviato quando un utente rilascia il pulsante del dispositivo di puntamento su un'istanza InteractiveObject.
Definisce il valore della proprietàtype
di un oggetto evento rightMouseUp
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | true |
buttonDown | true se viene premuto il pulsante destro del mouse; false in caso contrario. |
cancelable | false ; il comportamento predefinito non può essere annullato. |
commandKey | 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. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
clickCount | Conteggio del numero di clic del mouse per indicare se l'evento è parte di una sequenza di più clic. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
rollOut | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.ROLL_OUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 o un elemento principale di tale oggetto. relatedObject
è l'oggetto sul quale si è spostato il dispositivo di puntamento. 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
.
Lo scopo dell'evento rollOut
è 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 di qualsiasi suo elemento secondario per spostarsi su un oggetto che non è un suo elemento secondario, l'oggetto di visualizzazione invia l'evento rollOut
. Si tratta di un comportamento diverso da quello dell'evento mouseOut
, che 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.
type
di un oggetto evento rollOut
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | false |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
commandKey | 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. |
relatedObject | L'oggetto dell'elenco di visualizzazione a cui punta ora il dispositivo di puntamento. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
rollOver | Evento |
flash.events.MouseEvent
proprietà MouseEvent.type =
flash.events.MouseEvent.ROLL_OVER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato quando l'utente sposta un dispositivo di puntamento sopra un'istanza InteractiveObject. La destinazione dell'evento è l'oggetto che si trova sotto il dispositivo di puntamento o un elemento principale di tale oggetto. relatedObject
è l'oggetto precedente che si trovava sotto il dispositivo di puntamento. 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.
Lo scopo dell'evento rollOver
è 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
. Si tratta di un comportamento diverso da quello dell'evento mouseOver
, che 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.
type
di un oggetto evento rollOver
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
altKey | true se il tasto Alt è attivo (Windows). |
bubbles | false |
buttonDown | true se viene premuto il pulsante principale del mouse; false in caso contrario. |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
commandKey | 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. |
relatedObject | L'oggetto dell'elenco di visualizzazione a cui puntava il dispositivo di puntamento. |
localX | La coordinata orizzontale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
localY | La coordinata verticale in corrispondenza della quale l'evento si è verificato in relazione allo sprite contenitore, se il blocco del mouse è disattivato. |
movementX | Il cambiamento delle coordinate orizzontali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
movementY | Il cambiamento delle coordinate verticali della posizione del mouse rispetto all'ultimo evento del mouse, se il blocco del mouse è attivato. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
target | L'istanza InteractiveObject sotto il dispositivo di puntamento. 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. |
selectAll | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.SELECT_ALL
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10, AIR 1.5 |
Inviato quando l'utente attiva la combinazione di tasti di scelta rapida specifici della piattaforma per un'operazione che consente di selezionare tutto oppure sceglie "Seleziona tutto" 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 causa la selezione di tutto il contenuto del campo di testo.
La costanteEvent.SELECT_ALL
definisce il valore della proprietà type
di un oggetto evento selectAll
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Qualunque istanza InteractiveObject con un listener registrato per l'evento selectAll . |
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.
softKeyboardActivate | Evento |
flash.events.SoftKeyboardEvent
proprietà SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.2, AIR 2.6 |
Inviato immediatamente dopo la visualizzazione della tastiera software.
La costanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE
definisce il valore della proprietà type
dell'oggetto SoftKeyboardEvent quando viene visualizzata una tastiera software. Per questo evento, cancellable = false
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
relatedObjectVal | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
triggerTypeVal | Indica se l'evento keyboard è stato inviato da un'applicazione o un utente. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
Elementi API correlati
softKeyboardActivating | Evento |
flash.events.SoftKeyboardEvent
proprietà SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.2, AIR 2.6 |
Inviato immediatamente prima della visualizzazione della tastiera software.
La costanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING
definisce il valore della proprietà type
dell'oggetto SoftKeyboardEvent immediatamente prima della visualizzazione di una tastiera software. Per questo evento, cancellable = true
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true a meno che l'evento non venga inviato da un oggetto StageText. Per gli oggetti StageText, l'evento non è annullabile. |
relatedObjectVal | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
triggerTypeVal | Indica se l'evento keyboard è stato inviato da un'applicazione o un utente. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
Elementi API correlati
softKeyboardDeactivate | Evento |
flash.events.SoftKeyboardEvent
proprietà SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.2, AIR 2.6 |
Inviato immediatamente dopo la chiusura della tastiera software.
La costanteSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE
definisce il valore della proprietà type
dell'oggetto SoftKeyboardEvent quando una tastiera software viene chiusa o nascosta. Per questo evento, cancellable = false
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
relatedObjectVal | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
triggerTypeVal | Indica se l'evento keyboard è stato inviato da un'applicazione o un utente. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
Elementi API correlati
tabChildrenChange | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.TAB_CHILDREN_CHANGE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Inviato quando cambia il valore del flag tabChildren
dell'oggetto.
Event.TAB_CHILDREN_CHANGE
definisce il valore della proprietà type
di un oggetto evento tabChildrenChange
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto il cui flag tabChildren è stato modificato. 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. |
tabEnabledChange | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.TAB_ENABLED_CHANGE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Inviato quando cambia il flag tabEnabled
dell'oggetto.
Event.TAB_ENABLED_CHANGE
definisce il valore della proprietà type
di un oggetto evento tabEnabledChange
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'istanza InteractiveObject il cui flag tabEnabled è stato modificato. 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. |
tabIndexChange | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.TAB_INDEX_CHANGE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9 |
Inviato quando cambia il valore della proprietà tabIndex
dell'oggetto.
Event.TAB_INDEX_CHANGE
definisce il valore della proprietà type
di un oggetto evento tabIndexChange
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto il cui tabIndex è stato modificato. 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. |
textInput | Evento |
flash.events.TextEvent
proprietà TextEvent.type =
flash.events.TextEvent.TEXT_INPUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Inviato quando un utente immette uno o più caratteri di testo. Questo evento può essere generato da vari metodi di immissione del testo, quali tastiere, IME, sistemi di riconoscimento vocale o del contenuto parlato, e persino dalle operazioni Incolla di testo normale privo di informazioni di formattazione e stile.
Definisce il valore della proprietàtype
di un oggetto evento textInput
.
Nota: questo evento non viene inviato per il tasto Canc o Backspace.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | true |
cancelable | true ; chiama il metodo preventDefault() per annullare il comportamento predefinito. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | Il campo di testo in cui vengono immessi i caratteri. Il target non è sempre l'oggetto contenuto 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. |
text | Il carattere o la sequenza di caratteri immessi dall'utente. |
touchBegin | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_BEGIN
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quanto l'utente stabilisce per la prima volta un contatto con un dispositivo abilitato per il tocco (ad esempio, tocca con un dito un cellulare o un Tablet PC con touch screen). Alcuni dispositivi possono inoltre interpretare questo contatto come un evento mouseDown
.
In particolare, se un utente tocca con un dito un touch screen, l'istanza InteractiveObject potrebbe inviare un evento mouseDown
o un evento touchBegin
oppure entrambi questi eventi 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 mouseDown
, 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 touchBegin
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_BEGIN
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Esempio ( Come utilizzare questo esempio )
TOUCH_BEGIN
, TOUCH_MOVE
e TOUCH_END
. Mentre il punto di contatto si sposta attraverso lo schermo (onTouchMove
), la coordinata x relativa allo stage viene tracciata nell'output. Per i parametri Sprite.startTouchDrag
nella funzione onTouchBegin
, il valore per touchPointID è quello assegnato all'oggetto evento. Il parametro bounds è il rettangolo che definisce i limiti dell'oggetto di visualizzazione principale (bg è un oggetto di visualizzazione che contiene MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); function onTouchBegin(eBegin:TouchEvent) { eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this)); trace("touch begin"); } function onTouchMove(eMove:TouchEvent) { trace(eMove.stageX); } function onTouchEnd(eEnd:TouchEvent) { eEnd.target.stopTouchDrag(eEnd.touchPointID); trace("touch end"); }
Elementi API correlati
touchEnd | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_END
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quanto l'utente rimuove il contatto con un dispositivo abilitato per il tocco (ad esempio, solleva un dito da un cellulare o un Tablet PC con touch screen). Alcuni dispositivi possono inoltre interpretare questo contatto come un evento mouseUp
.
In particolare, se un utente solleva un dito da un touch screen, l'istanza InteractiveObject potrebbe inviare un evento mouseUp
o un evento touchEnd
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 mouseUp
, 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 touchEnd
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_END
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Esempio ( Come utilizzare questo esempio )
TOUCH_BEGIN
, TOUCH_MOVE
e TOUCH_END
. Mentre il punto di contatto si sposta attraverso lo schermo (onTouchMove
), la coordinata x relativa allo stage viene tracciata nell'output. Per i parametri Sprite.startTouchDrag
nella funzione onTouchBegin
, il valore per touchPointID è quello assegnato all'oggetto evento. Il parametro bounds è il rettangolo che definisce i limiti dell'oggetto di visualizzazione principale (bg è un oggetto di visualizzazione che contiene MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); function onTouchBegin(eBegin:TouchEvent) { eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this)); trace("touch begin"); } function onTouchMove(eMove:TouchEvent) { trace(eMove.stageX); } function onTouchEnd(eEnd:TouchEvent) { eEnd.target.stopTouchDrag(eEnd.touchPointID); trace("touch end"); }
Elementi API correlati
touchMove | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_MOVE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quando l'utente tocca il dispositivo, e viene inviato in modo continuativo finché il punto di contatto non viene rimosso. Questo evento non richiede l'invio di uno spostamento effettivo del punto di contatto.
Alcuni dispositivi potrebbero interpretare questo contatto come un evento mouseMove
. In particolare, se un utente sposta un dito attraverso un touch screen, l'istanza InteractiveObject potrebbe inviare un evento mouseMove
o un evento touchMove
oppure entrambi questi eventi 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 mouseMove
, 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 touchMove
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_MOVE
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Esempio ( Come utilizzare questo esempio )
TOUCH_BEGIN
, TOUCH_MOVE
e TOUCH_END
. Mentre il punto di contatto si sposta attraverso lo schermo (onTouchMove
), la coordinata x relativa allo stage viene tracciata nell'output. Per i parametri Sprite.startTouchDrag
nella funzione onTouchBegin
, il valore per touchPointID è quello assegnato all'oggetto evento. Il parametro bounds è il rettangolo che definisce i limiti dell'oggetto di visualizzazione principale (bg è un oggetto di visualizzazione che contiene MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); function onTouchBegin(eBegin:TouchEvent) { eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this)); trace("touch begin"); } function onTouchMove(eMove:TouchEvent) { trace(eMove.stageX); } function onTouchEnd(eEnd:TouchEvent) { eEnd.target.stopTouchDrag(eEnd.touchPointID); trace("touch end"); }
Elementi API correlati
touchOut | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_OUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un altro disponibile su un cellulare o su un Tablet PC con touch screen). Alcuni dispositivi possono inoltre interpretare questo contatto come un evento mouseOut
.
In particolare, se un utente sposta un dito attraverso un touch screen, l'istanza InteractiveObject potrebbe inviare un evento mouseOut
o un evento touchOut
oppure entrambi questi eventi 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 mouseOut
, 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 touchOut
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_OUT
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Elementi API correlati
touchOver | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_OVER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto 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
.
In particolare, se un utente sposta un dito su InteractiveObject, l'istanza InteractiveObject potrebbe inviare un evento mouseOver
o un evento touchOver
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 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 touchOver
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_OVER
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Elementi API correlati
touchRollOut | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OUT
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quanto l'utente sposta il punto di contatto lontano da un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un oggetto di visualizzazione a un punto esterno a 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 rollOut
.
In particolare, se un utente sposta un dito su InteractiveObject, l'istanza InteractiveObject potrebbe inviare un evento rollOut
o un evento touchRollOut
oppure entrambi questi eventi 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 rollOut
, 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 touchRollOut
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_ROLL_OUT
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Elementi API correlati
touchRollOver | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OVER
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quanto l'utente sposta il punto di contatto su un'istanza InteractiveObject su un dispositivo abilitato per il tocco (ad esempio, trascina un dito da un punto esterno a un oggetto di visualizzazione a un punto 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 rollOver
.
In particolare, se un utente sposta un dito su InteractiveObject, l'istanza InteractiveObject potrebbe inviare un evento rollOver
o un evento touchRollOver
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 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 touchRollOver
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_ROLL_OVER
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Elementi API correlati
touchTap | Evento |
flash.events.TouchEvent
proprietà TouchEvent.type =
flash.events.TouchEvent.TOUCH_TAP
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Inviato quanto l'utente solleva il punto di contatto sulla stessa istanza InteractiveObject in corrispondenza della quale è stato iniziato il contatto su un dispositivo abilitato per il tocco (ad esempio, preme e rilascia un dito da 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 click
.
In particolare, se un utente tocca con un dito su InteractiveObject, l'istanza InteractiveObject potrebbe inviare un evento click
o un evento touchTap
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 click
, 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 touchTap
, 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.
Definisce il valore della proprietàtype
di un oggetto evento di tocco TOUCH_TAP
.
L'oggetto TouchEvent 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 | 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. |
eventPhase | La fase attuale del flusso di eventi. |
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. |
pressure | Un valore compreso tra 0.0 e 1.0 che indica la forza del contatto con il dispositivo. Se il dispositivo non supporta il rilevamento della pressione, il valore è 1.0 . |
relatedObject | Un riferimento a un oggetto dell'elenco di visualizzazione relativo all'evento. |
shiftKey | true se il tasto Maiusc è attivo; false se è inattivo. |
sizeX | Larghezza dell'area di contatto. |
sizeY | Altezza dell'area di contatto. |
stageX | La coordinata orizzontale in cui si è verificato l'evento nelle coordinate globali dello stage. |
stageY | La coordinata verticale in cui si è verificato l'evento nelle coordinate globali dello stage. |
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. |
touchPointID | Un numero di identificazione univoco (ad esempio un int) assegnato al punto di contatto. |
Esempio ( Come utilizzare questo esempio )
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); var myTextField:TextField = new TextField(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler); function taphandler(e:TouchEvent): void { myTextField.text = "I've been tapped"; myTextField.y = 50; addChild(myTextField); }
Elementi API correlati
InteractiveObjectExample
, che a propria volta utilizza la classe ChildSprite
per disegnare un rettangolo e successivamente manipolarlo in base a diversi eventi del mouse. Questa operazione viene eseguita mediante la procedura seguente:
- Nella funzione di costruzione
InteractiveObjectExample
viene creato un nuovo oggetto ChildSprite di tipo Sprite di nomechild
, che chiama il metodo di costruzione ChildSprite per disegnare la forma e aggiungere degli eventi del mouse per la forma (come illustrato nella procedura seguente). L'oggettochild
viene aggiunto in cima all'elenco di visualizzazione in corrispondenza delle coordinate x = 0, y = 0. - Nella classe
ChildSprite
, dichiarate le proprietàsize
eoverSize
che vengono successivamente utilizzate nel metododraw()
e nei metodi MouseEvent. - Dichiarate le proprietà che impostano l'arancione come colore dello sfondo, il giallo scuro come colore dello stato attivo di passaggio del mouse (mouse over) e il blu chiaro come colore dello stato premuto del mouse (mouse down).
- Nella funzione di costruzione
ChildSprite
viene disegnato un quadrato arancione mediante i metodi della classe Graphics e il metododraw()
. - La funzione di costruzione aggiunge quattro metodi del listener di eventi MouseEvent:
mouseOverHandler
: ridisegna un quadrato più grande con una dimensione di 60 x 60 pixel di colore giallo scuro in corrispondenza delle coordinate originali.mouseOutHandler
: ripristina le dimensioni e il colore originali del quadrato.mouseDownHandler
: ridisegna un quadrato più grande con una dimensione di 60 x 60 pixel di colore blu chiaro in corrispondenza delle coordinate originali.mouseUpHandler
: comemouseOverHandler
.
package { import flash.display.Sprite; public class InteractiveObjectExample extends Sprite { public function InteractiveObjectExample() { var child:Sprite = new ChildSprite(); addChild(child); } } } import flash.display.Sprite; import flash.events.MouseEvent; class ChildSprite extends Sprite { private var size:uint = 50; private var overSize:uint = 60; private var backgroundColor:uint = 0xFFCC00; private var overColor:uint = 0xCCFF00; private var downColor:uint = 0x00CCFF; public function ChildSprite() { buttonMode = true; draw(size, size, backgroundColor); addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler); addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler); addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler); addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler); } private function draw(w:uint, h:uint, bgColor:uint):void { graphics.clear(); graphics.beginFill(bgColor); graphics.drawRect(0, 0, w, h); graphics.endFill(); } public function mouseOverHandler(event:MouseEvent):void { trace("mouseOverHandler"); draw(overSize, overSize, overColor); } public function mouseOutHandler(event:MouseEvent):void { trace("mouseOutHandler"); draw(size, size, backgroundColor); } public function mouseDownHandler(event:MouseEvent):void { trace("mouseDownHandler"); draw(overSize, overSize, downColor); } public function mouseUpHandler(event:MouseEvent):void { trace("mouseUpHandler"); draw(overSize, overSize, overColor); } }
Tue Jun 12 2018, 02:44 PM Z