Pacchettoflash.events
Classepublic class FocusEvent
EreditarietàFocusEvent Inheritance Event Inheritance Object

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Flash® Player invia oggetti FocusEvent quando l'attivazione viene spostata da un oggetto all'altro nell'elenco di visualizzazione. Esistono quattro tipi di eventi di attivazione:

Vedere gli esempi



Proprietà pubbliche
 ProprietàDefinito da
 Inheritedbubbles: Boolean
[sola lettura] Indica se un evento è un evento di bubbling.
Event
 Inheritedcancelable: Boolean
[sola lettura] Indica se il comportamento associato all'evento può essere impedito.
Event
 Inheritedconstructor: Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.
Object
 InheritedcurrentTarget: Object
[sola lettura] L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
Event
 InheritedeventPhase: uint
[sola lettura] La fase attuale del flusso di eventi.
Event
  keyCode: uint
Il valore del codice tasto del tasto premuto per attivare un evento keyFocusChange.
FocusEvent
 Inheritedprototype: Object
[statico] Un riferimento all'oggetto prototipo di un oggetto classe o funzione.
Object
  relatedObject: InteractiveObject
Un riferimento all'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione.
FocusEvent
  shiftKey: Boolean
Indica se il modificatore del tasto Maiusc è attivato; in questo caso il valore è true.
FocusEvent
 Inheritedtarget: Object
[sola lettura] Il target dell'evento.
Event
 Inheritedtype: String
[sola lettura] Il tipo di evento.
Event
Metodi pubblici
 MetodoDefinito da
  
FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)
Crea un oggetto Event con informazioni specifiche relative agli eventi di attivazione.
FocusEvent
  
Crea una copia dell'oggetto FocusEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.
FocusEvent
 Inherited
formatToString(className:String, ... arguments):String
Una funzione di utilità per l'implementazione del metodo toString() nella classe Event personalizzata.
Event
 Inherited
Indica se per un oggetto è definita una proprietà specifica.
Object
 Inherited
Verifica se sull'evento è stato chiamato il metodo preventDefault().
Event
 Inherited
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.
Object
 Inherited
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato.
Event
 Inherited
Indica se la proprietà specificata esiste ed è enumerabile.
Object
 Inherited
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.
Object
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi.
Event
 Inherited
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente.
Event
  
Restituisce una stringa che contiene tutte le proprietà dell'oggetto FocusEvent.
FocusEvent
 Inherited
Restituisce il valore di base dell'oggetto specificato.
Object
Costanti pubbliche
 CostanteDefinito da
 InheritedACTIVATE: String = "activate"
[statico] Definisce il valore della proprietà type di un oggetto evento activate.
Event
 InheritedADDED: String = "added"
[statico] Definisce il valore della proprietà type di un oggetto evento added.
Event
 InheritedADDED_TO_STAGE: String = "addedToStage"
[statico] Definisce il valore della proprietà type di un oggetto evento addedToStage.
Event
 InheritedCANCEL: String = "cancel"
[statico] Definisce il valore della proprietà type di un oggetto evento cancel.
Event
 InheritedCHANGE: String = "change"
[statico] Definisce il valore della proprietà type di un oggetto evento change.
Event
 InheritedCLOSE: String = "close"
[statico] Definisce il valore della proprietà type di un oggetto evento close.
Event
 InheritedCOMPLETE: String = "complete"
[statico] Definisce il valore della proprietà type di un oggetto evento complete.
Event
 InheritedCONNECT: String = "connect"
[statico] Definisce il valore della proprietà type di un oggetto evento connect.
Event
 InheritedDEACTIVATE: String = "deactivate"
[statico] Definisce il valore della proprietà type di un oggetto evento deactivate.
Event
 InheritedENTER_FRAME: String = "enterFrame"
[statico] Definisce il valore della proprietà type di un oggetto evento enterFrame.
Event
  FOCUS_IN: String = "focusIn"
[statico] Definisce il valore della proprietà type di un oggetto evento focusIn.
FocusEvent
  FOCUS_OUT: String = "focusOut"
[statico] Definisce il valore della proprietà type di un oggetto evento focusOut.
FocusEvent
 InheritedFULLSCREEN: String = "fullScreen"
[statico] Definisce il valore della proprietà type di un oggetto evento fullScreen.
Event
 InheritedID3: String = "id3"
[statico] Definisce il valore della proprietà type di un oggetto evento id3.
Event
 InheritedINIT: String = "init"
[statico] Definisce il valore della proprietà type di un oggetto evento init.
Event
  KEY_FOCUS_CHANGE: String = "keyFocusChange"
[statico] Definisce il valore della proprietà type di un oggetto evento keyFocusChange.
FocusEvent
  MOUSE_FOCUS_CHANGE: String = "mouseFocusChange"
[statico] Definisce il valore della proprietà type di un oggetto evento mouseFocusChange.
FocusEvent
 InheritedMOUSE_LEAVE: String = "mouseLeave"
[statico] Definisce il valore della proprietà type di un oggetto evento mouseLeave.
Event
 InheritedOPEN: String = "open"
[statico] Definisce il valore della proprietà type di un oggetto evento open.
Event
 InheritedREMOVED: String = "removed"
[statico] Definisce il valore della proprietà type di un oggetto evento removed.
Event
 InheritedREMOVED_FROM_STAGE: String = "removedFromStage"
[statico] Definisce il valore della proprietà type di un oggetto evento removedFromStage.
Event
 InheritedRENDER: String = "render"
[statico] Definisce il valore della proprietà type di un oggetto evento render.
Event
 InheritedRESIZE: String = "resize"
[statico] Definisce il valore della proprietà type di un oggetto evento resize.
Event
 InheritedSCROLL: String = "scroll"
[statico] Definisce il valore della proprietà type di un oggetto evento scroll.
Event
 InheritedSELECT: String = "select"
[statico] Definisce il valore della proprietà type di un oggetto evento select.
Event
 InheritedSOUND_COMPLETE: String = "soundComplete"
[statico] Definisce il valore della proprietà type di un oggetto evento soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE: String = "tabChildrenChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE: String = "tabEnabledChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE: String = "tabIndexChange"
[statico] Definisce il valore della proprietà type di un oggetto evento tabIndexChange.
Event
 InheritedUNLOAD: String = "unload"
[statico] Definisce il valore della proprietà type di un oggetto evento unload.
Event
Descrizione delle proprietà
keyCodeproprietà
keyCode:uint  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Il valore del codice tasto del tasto premuto per attivare un evento keyFocusChange.


Implementazione
    public function get keyCode():uint
    public function set keyCode(value:uint):void
relatedObjectproprietà 
relatedObject:InteractiveObject  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Un riferimento all'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. Ad esempio, quando si verifica un evento focusOut, la proprietà relatedObject rappresenta l'istanza InteractiveObject che è stata attivata.


Implementazione
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void
shiftKeyproprietà 
shiftKey:Boolean  [lettura-scrittura]

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Indica se il modificatore del tasto Maiusc è attivato; in questo caso il valore è true. In caso contrario, il valore è false. Questa proprietà è utilizzata solo se FocusEvent è di tipo keyFocusChange.


Implementazione
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
Descrizione della funzione di costruzione
FocusEvent()Funzione di costruzione
public function FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea un oggetto Event con informazioni specifiche relative agli eventi di attivazione. Gli oggetti evento vengono passati ai listener di eventi come parametri.

Parametri
type:String — Il tipo di evento. I valori possibili sono: FocusEvent.FOCUS_IN, FocusEvent.FOCUS_OUT, FocusEvent.KEY_FOCUS_CHANGE e FocusEvent.MOUSE_FOCUS_CHANGE.
 
bubbles:Boolean (default = true) — Determina se l'oggetto Event partecipa alla fase di bubbling del flusso di eventi.
 
cancelable:Boolean (default = false) — Determina se l'oggetto Event può essere annullato.
 
relatedObject:InteractiveObject (default = null) — Indica l'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione. Ad esempio, quando si verifica un evento focusIn, la proprietà relatedObject rappresenta l'istanza InteractiveObject che è stata disattivata.
 
shiftKey:Boolean (default = false) — Indica se il modificatore del tasto Maiusc è attivato.
 
keyCode:uint (default = 0) — Indica il codice del tasto premuto per attivare un evento keyFocusChange.

Vedere anche

Descrizione dei metodi
clone()metodo
public override function clone():Event

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Crea una copia dell'oggetto FocusEvent e imposta il valore di ogni proprietà in modo che corrisponda a quello dell'originale.

Restituisce
Event — Un nuovo oggetto FocusEvent con proprietà dai valori identici a quelli dell'originale.
toString()metodo 
public override function toString():String

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Restituisce una stringa che contiene tutte le proprietà dell'oggetto FocusEvent. La stringa ha il seguente formato:

[FocusEvent type=value bubbles=value cancelable=value relatedObject=value shiftKey=value]

Restituisce
String — Una stringa che contiene tutte le proprietà dell'oggetto FocusEvent.
Descrizione delle costanti
FOCUS_INCostante
public static const FOCUS_IN:String = "focusIn"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento focusIn.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
keyCode0; valido solo per gli eventi keyFocusChange.
relatedObjectL'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione.
shiftKeyfalse; valido solo per gli eventi keyFocusChange.
targetL'istanza InteractiveObject che è appena stata attivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

FOCUS_OUTCostante 
public static const FOCUS_OUT:String = "focusOut"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento focusOut.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelablefalse; non è presente alcun comportamento predefinito da annullare.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
keyCode0; valido solo per gli eventi keyFocusChange.
relatedObjectL'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione.
shiftKeyfalse; valido solo per gli eventi keyFocusChange.
targetL'istanza InteractiveObject che è appena stata disattivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

KEY_FOCUS_CHANGECostante 
public static const KEY_FOCUS_CHANGE:String = "keyFocusChange"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento keyFocusChange.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelabletrue; chiama il metodo preventDefault() per annullare il comportamento predefinito.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
keyCodeIl valore del codice tasto del tasto premuto per attivare un evento keyFocusChange.
relatedObjectL'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione.
shiftKeytrue se il modificatore del tasto Maiusc è attivato; false in caso contrario.
targetL'istanza corrente di InteractiveObject attivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

MOUSE_FOCUS_CHANGECostante 
public static const MOUSE_FOCUS_CHANGE:String = "mouseFocusChange"

Versione linguaggio: ActionScript 3.0
Versione lettore: Flash Player 9

Definisce il valore della proprietà type di un oggetto evento mouseFocusChange.

Questo evento ha le seguenti proprietà:

ProprietàValore
bubblestrue
cancelabletrue; chiama il metodo preventDefault() per annullare il comportamento predefinito.
currentTargetL'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
keyCode0; valido solo per gli eventi keyFocusChange.
relatedObjectL'istanza complementare di InteractiveObject che è interessata dal cambiamento di attivazione.
shiftKeyfalse; valido solo per gli eventi keyFocusChange.
targetL'istanza corrente di InteractiveObject attivata. Il target non è sempre l'oggetto nell'elenco di visualizzazione che ha registrato il listener di eventi. Utilizzare la proprietà currentTarget per accedere all'oggetto nell'elenco di visualizzazione, che sta elaborando l'evento.

Vedere anche

Esempi Come utilizzare gli esempi
FocusEventExample.as

Nell'esempio seguente vengono utilizzate le classi FocusEventExample e CustomSprite per mostrare come utilizzare l'attivazione in combinazione con gli elementi disegnati sullo stage per catturare gli eventi e stampare le informazioni. Questo esempio esegue le operazioni seguenti:
  1. Dichiara le proprietà child (di tipo Sprite) e childCount (di tipo uint).
  2. Un ciclo for crea cinque quadrati blu chiaro in corrispondenza delle coordinate (0,0). Inizia dall'assegnazione di child a una nuova istanza CustomSprite. Ogni volta che viene creato un oggetto CustomSprite, vengono eseguite le seguenti operazioni:
    • La proprietà size di tipo uint viene impostata su 50 pixel e bgColor su blu chiaro.
    • Le proprietà buttonMode e useHandCursor della classe Sprite vengono impostate su true all'interno della funzione di costruzione.
    • Viene istanziato un listener di eventi di tipo click unitamente al sottoscrittore clickHandler() associato. Il metodo subscriber crea una variabile locale target di tipo Sprite e la assegna a qualsiasi casella su cui si è fatto clic. Lo stato attivo dello stage viene quindi assegnato a target.
    • Viene chiamato il metodo draw(), che crea un quadrato di 50 x 50 pixel mediante una chiamata ai metodi beginFill(), drawRect() e endFill() della classe Graphics e alle proprietà dell'istanza.
  3. Nel ciclo for viene chiamato il metodo configureListeners(), che crea un'istanza di tre listener/subscriber di eventi:
    • focusIn / focusInHandler() viene inviato dopo l'evento click per qualsiasi oggetto elenco di visualizzazione (casella) su cui viene fatto clic.
    • focusOut / focusOutHandler() viene inviato quando viene fatto clic su un'altra casella o quando lo stato attivo esce dallo stage (ad esempio, facendo clic all'esterno di Flash Player).
    • keyFocusChange / keyFocusChangeHandler() viene inviato se si utilizza il tasto Tab o il tasto Freccia destra o Freccia sinistra per selezionare un oggetto elenco di visualizzazione. Il metodo keyFocusChangeHandler(), tuttavia, intercetta i tasti Freccia sinistra e Freccia destra e chiama il metodo preventDefault() per disattivarli.
  4. Nel ciclo for ogni quadrato viene aggiunto all'elenco di visualizzazione e visualizzato (tutti nella stesa area) mediante addChild().
  5. La funzione di costruzione chiama quindi refreshLayout(), che distribuisce i quadrati arancione nella parte superiore (y = 0) del display, ciascuno separato da 5 pixel.
package {
    import flash.display.Sprite;
    import flash.display.DisplayObject;
    import flash.events.FocusEvent;
    import flash.events.IEventDispatcher;

    public class FocusEventExample extends Sprite {
        private var gutter:uint = 5;
        private var childCount:uint = 5;

        public function FocusEventExample() {
            var child:Sprite;
            for(var i:uint; i < childCount; i++) {
                child = new CustomSprite();
                configureListeners(child);
                addChild(child);
            }
            refreshLayout();
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
            dispatcher.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
            dispatcher.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, keyFocusChangeHandler);
            dispatcher.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, mouseFocusChangeHandler);
        }

        private function refreshLayout():void {
            var ln:uint = numChildren;
            var child:DisplayObject = getChildAt(0);
            var lastChild:DisplayObject = child;
            for(var i:uint = 1; i < ln; i++) {
                child = getChildAt(i);
                child.x = lastChild.x + lastChild.width + gutter;
                lastChild = child;
            }
        }

        private function focusInHandler(event:FocusEvent):void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("focusInHandler: " + target.name);
        }

        private function focusOutHandler(event:FocusEvent):void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("focusOutHandler: " + target.name);
        }

        private function keyFocusChangeHandler(event:FocusEvent):void {
            if(event.keyCode == 39 || event.keyCode == 37){
                event.preventDefault()
            }
            var target:CustomSprite = CustomSprite(event.target);
            trace("keyFocusChangeHandler: " + target.name);
        }
        private function mouseFocusChangeHandler(event:FocusEvent):void {
            var target:CustomSprite = CustomSprite(event.target);
            trace("mouseFocusChangeHandler: " + target.name);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class CustomSprite extends Sprite {
    private var size:uint = 50;
    private var bgColor:uint = 0x00CCFF;

    public function CustomSprite() {
        buttonMode = true;
        useHandCursor = true;
        addEventListener(MouseEvent.CLICK, clickHandler);
        draw(size, size);
    }

    private function draw(w:uint, h:uint):void {
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    private function clickHandler(event:MouseEvent):void {
        var target:Sprite = Sprite(event.target);
        trace("clickHandler: " + target.name);
        stage.focus = target;
    }
}




 

Inviami un messaggio e-mail quando vengono aggiunti dei commenti a questa | Rapporto sui commenti

Pagina corrente: http://livedocs.adobe.com/flash/9.0_it/ActionScriptLangRefV3/flash/events/FocusEvent.html