Paketflash.events
Klassepublic class FocusEvent
VererbungFocusEvent Inheritance Event Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Flash® Player löst FocusEvent-Objekte aus, wenn der Benutzer den Fokus von einem Objekt in der Anzeigeliste zum Nächsten bewegt. Es gibt vier Arten von focus-Ereignissen:

Beispiele anzeigen



Öffentliche Eigenschaften
 EigenschaftDefiniert von
 Inheritedbubbles : Boolean
[read-only] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[read-only] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[read-only] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : uint
[read-only] Die aktuelle Phase im Ereignisablauf.
Event
  keyCode : uint
Der Tastencodewert der Taste, die zum Auslösen eines "keyFocusChange"-Ereignisses gedrückt wird.
FocusEvent
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  relatedObject : InteractiveObject
Ein Verweis auf die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.
FocusEvent
  shiftKey : Boolean
Gibt an, ob der Umschalttastenmodifizierer aktiviert ist. In diesem Fall lautet der Wert "true".
FocusEvent
 Inheritedtarget : Object
[read-only] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[read-only] Der Typ des Ereignisses.
Event
Öffentliche Methoden
 MethodeDefiniert von
  
FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)
Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für Fokus-Ereignisse wichtig sind.
FocusEvent
  
Erstellt eine Kopie des FocusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
FocusEvent
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion, mit der die toString()-Methode in Ihrer benutzerdefinierten Event-Klasse implementiert wird.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob "preventDefault()" im Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
  
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des FocusEvent-Objekts enthält.
FocusEvent
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert von
 InheritedACTIVATE : String = "activate"
[static] Definiert den Wert der Eigenschaft "type" eines activate-Ereignisobjekts.
Event
 InheritedADDED : String = "added"
[static] Definiert den Wert der Eigenschaft "type" eines added-Ereignisobjekts.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[static] Definiert den Wert der Eigenschaft "type" eines addedToStage-Ereignisobjekts.
Event
 InheritedCANCEL : String = "cancel"
[static] Definiert den Wert der Eigenschaft type eines cancel-Ereignisobjekts.
Event
 InheritedCHANGE : String = "change"
[static] Definiert den Wert der Eigenschaft "type" eines change-Ereignisobjekts.
Event
 InheritedCLOSE : String = "close"
[static] Definiert den Wert der Eigenschaft "type" eines close-Ereignisobjekts.
Event
 InheritedCOMPLETE : String = "complete"
[static] Definiert den Wert der Eigenschaft "type" eines complete-Ereignisobjekts.
Event
 InheritedCONNECT : String = "connect"
[static] Definiert den Wert der Eigenschaft "type" eines connect-Ereignisobjekts.
Event
 InheritedDEACTIVATE : String = "deactivate"
[static] Definiert den Wert der Eigenschaft "type" eines deactivate-Ereignisobjekts.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[static] Definiert den Wert der Eigenschaft "type" eines enterFrame-Ereignisobjekts.
Event
  FOCUS_IN : String = "focusIn"
[static] Definiert den Wert der Eigenschaft "type" eines focusIn-Ereignisobjekts.
FocusEvent
  FOCUS_OUT : String = "focusOut"
[static] Definiert den Wert der Eigenschaft "type" eines focusOut-Ereignisobjekts.
FocusEvent
 InheritedFULLSCREEN : String = "fullScreen"
[static] Definiert den Wert der Eigenschaft "type" eines fullScreen-Ereignisobjekts.
Event
 InheritedID3 : String = "id3"
[static] Definiert den Wert der Eigenschaft "type" eines id3-Ereignisobjekts.
Event
 InheritedINIT : String = "init"
[static] Definiert den Wert der Eigenschaft "type" eines init-Ereignisobjekts.
Event
  KEY_FOCUS_CHANGE : String = "keyFocusChange"
[static] Definiert den Wert der Eigenschaft "type" eines keyFocusChange-Ereignisobjekts.
FocusEvent
  MOUSE_FOCUS_CHANGE : String = "mouseFocusChange"
[static] Definiert den Wert der Eigenschaft "type" eines mouseFocusChange-Ereignisobjekts.
FocusEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[static] Definiert den Wert der Eigenschaft "type" eines mouseLeave-Ereignisobjekts.
Event
 InheritedOPEN : String = "open"
[static] Definiert den Wert der Eigenschaft "type" eines open-Ereignisobjekts.
Event
 InheritedREMOVED : String = "removed"
[static] Definiert den Wert der Eigenschaft type eines removed-Ereignisobjekts.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[static] Definiert den Wert der Eigenschaft "type" eines removedFromStage-Ereignisobjekts.
Event
 InheritedRENDER : String = "render"
[static] Definiert den Wert der Eigenschaft "type" eines render-Ereignisobjekts.
Event
 InheritedRESIZE : String = "resize"
[static] Definiert den Wert der Eigenschaft type eines resize-Ereignisobjekts.
Event
 InheritedSCROLL : String = "scroll"
[static] Definiert den Wert der Eigenschaft type eines scroll-Ereignisobjekts.
Event
 InheritedSELECT : String = "select"
[static] Definiert den Wert der Eigenschaft type eines select-Ereignisobjekts.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[static] Definiert den Wert der Eigenschaft "type" eines soundComplete-Ereignisobjekts.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabChildrenChange-Ereignisobjekts.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[static] Definiert den Wert der Eigenschaft type eines tabEnabledChange-Ereignisobjekts.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[static] Definiert den Wert der Eigenschaft "type" eines tabIndexChange-Ereignisobjekts.
Event
 InheritedUNLOAD : String = "unload"
[static] Definiert den Wert der Eigenschaft "type" eines unload-Ereignisobjekts.
Event
Eigenschaftsdetail
keyCodeEigenschaft
keyCode:uint  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der Tastencodewert der Taste, die zum Auslösen eines keyFocusChange-Ereignisses gedrückt wird.


Implementierung
    public function get keyCode():uint
    public function set keyCode(value:uint):void
relatedObjectEigenschaft 
relatedObject:InteractiveObject  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein Verweis auf die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. Wenn beispielsweise ein focusOut-Ereignis auftritt, stellt relatedObject die InteractiveObject-Instanz dar, die den Fokus erhalten hat.


Implementierung
    public function get relatedObject():InteractiveObject
    public function set relatedObject(value:InteractiveObject):void
shiftKeyEigenschaft 
shiftKey:Boolean  [read-write]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt an, ob der Umschalttastenmodifizierer aktiviert ist. In diesem Fall lautet der Wert true. Andernfalls ist der Wert false. Diese Eigenschaft wird nur dann verwendet, wenn "FocusEvent" den Typ keyFocusChange hat.


Implementierung
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
Konstruktordetail
FocusEvent()Konstruktor
public function FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für Fokus-Ereignisse wichtig sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.

Parameter
type:String — Der Ereignistyp. Folgende Werte sind möglich: FocusEvent.FOCUS_IN, FocusEvent.FOCUS_OUT, FocusEvent.KEY_FOCUS_CHANGE und FocusEvent.MOUSE_FOCUS_CHANGE.
 
bubbles:Boolean (default = true) — Legt fest, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
 
cancelable:Boolean (default = false) — Legt fest, ob das Ereignisobjekt abgebrochen werden kann.
 
relatedObject:InteractiveObject (default = null) — Gibt die andere InteractiveObject-Instanz an, die von dem Fokuswechsel betroffen ist. Wenn beispielsweise ein focusIn-Ereignis auftritt, stellt relatedObject das InteractiveObject dar, das den Fokus verloren hat.
 
shiftKey:Boolean (default = false) — Gibt an, ob der Umschalttasten-Modifizierer aktiviert ist.
 
keyCode:uint (default = 0) — Gibt den Tastencodewert der Taste an, die zum Auslösen eines keyFocusChange-Ereignisses gedrückt wird.

Siehe auch

Methodendetail
clone()Methode
public override function clone():Event

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Erstellt eine Kopie des FocusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.

Rückgabewerte
Event — Ein neues FocusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
toString()Methode 
public override function toString():String

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Gibt eine Zeichenfolge zurück, die alle Eigenschaften des FocusEvent-Objekts enthält. Der String liegt im folgenden Format vor:

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

Rückgabewerte
String — Eine Zeichenfolge, die alle Eigenschaften des FocusEvent-Objekts enthält.
Konstantendetail
FOCUS_INKonstante
public static const FOCUS_IN:String = "focusIn"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type eines focusIn-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
keyCode0; gilt nur für keyFocusChange-Ereignisse.
relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.
shiftKeyfalse; gilt nur für keyFocusChange-Ereignisse.
targetDie InteractiveObject-Instanz, die gerade den Fokus erhalten hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Siehe auch

FOCUS_OUTKonstante 
public static const FOCUS_OUT:String = "focusOut"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type eines focusOut-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
keyCode0; gilt nur für keyFocusChange-Ereignisse.
relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.
shiftKeyfalse; gilt nur für keyFocusChange-Ereignisse.
targetDie InteractiveObject-Instanz, die gerade den Fokus verloren hat. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Siehe auch

KEY_FOCUS_CHANGEKonstante 
public static const KEY_FOCUS_CHANGE:String = "keyFocusChange"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type eines keyFocusChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelabletrue; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
keyCodeDer Tastencodewert der Taste, die zum Auslösen eines keyFocusChange-Ereignisses gedrückt wird.
relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.
shiftKeytrue, wenn der Umschalttastenmodifizierer aktiviert ist, andernfalls false.
targetDie InteractiveObject-Instanz, die gerade den Fokus besitzt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Siehe auch

MOUSE_FOCUS_CHANGEKonstante 
public static const MOUSE_FOCUS_CHANGE:String = "mouseFocusChange"

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Definiert den Wert der Eigenschaft type eines mouseFocusChange-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblestrue
cancelabletrue; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
keyCode0; gilt nur für keyFocusChange-Ereignisse.
relatedObjectDie andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist.
shiftKeyfalse; gilt nur für keyFocusChange-Ereignisse.
targetDie InteractiveObject-Instanz, die gerade den Fokus besitzt. Das unter target angegebene Ziel ist nicht immer das Objekt in der Anzeigeliste, in der der Ereignis-Listener registriert wurde. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet.

Siehe auch

Beispiele Verwendung von Beispielen
FocusEventExample.as

Im folgenden Beispiel wird anhand der Klassen FocusEventExample und CustomSprite gezeigt, wie Focus-Ereignisse im Zusammenhang mit Stage-Elementen zur Erfassung von Ereignis- und Druckinformationen verwendet werden können. In diesem Beispiel werden die folgenden Aufgaben ausgeführt:
  1. Die Eigenschaften child (vom Typ "Sprite") und childCount (vom Typ "uint") werden deklariert.
  2. Mit einer for-Schleife werden am Punkt (0,0) fünf hellblaue Quadrate gezeichnet. Zuerst wird einer neuen CustomSprite-Instanz die Eigenschaft child zugewiesen. Jedes Mal, wenn ein CustomSprite-Objekt erstellt wird, passiert Folgendes:
    • Die Eigenschaft size vom Typ "uint" wird auf 50 Pixel gesetzt, und bgColor wird auf hellblau gesetzt.
    • Die Eigenschaften buttonMode und useHandCursor der Klasse "Sprite" werden innerhalb des Konstruktors auf true gesetzt.
    • Es wird ein Ereignis-Listener vom Typ click zusammen mit dem verknüpften Abonnenten clickHandler() instanziiert. Die Abonnentenmethode erstellt eine lokale target-Variable vom Typ "Sprite" und weist sie dem Feld zu, auf das geklickt wurde. Anschließend wird der Fokus der Bühne der Variablen target zugewiesen.
    • Die Methode draw() wird aufgerufen. Hierdurch wird ein 50 x 50 Pixel großes Quadrat mit den Methoden beginFill(), drawRect() und endFill() der Graphics-Klasse und der Instanzeigenschaften erstellt.
  3. In der "for"-Schleife wird die Methode configureListeners() aufgerufen, die drei Ereignis-Listener/-Abonnenten instanziiert:
    • focusIn/focusInHandler() wird ausgelöst, nachdem auf ein beliebiges Anzeigelistenobjekt (Feld) geklickt worden ist (click-Ereignis).
    • focusOut/focusOutHandler() wird ausgelöst, wenn auf ein anderes Feld geklickt wird oder die Bühne nicht mehr den Fokus besitzt (z. B., weil jemand außerhalb von Flash Player geklickt hat).
    • keyFocusChange/keyFocusChangeHandler() wird ausgelöst, wenn Sie mit der Tabulatortaste oder den Nach-links- und Nach-rechts-Pfeiltasten ein Anzeigelistenobjekt auswählen. Mit der keyFocusChangeHandler()-Methode werden die Aktionen der Nach-links- und Nach-rechts-Pfeiltasten überwacht. Außerdem wird die Methode preventDefault() zur Deaktivierung aufgerufen.
  4. In der for-Schleife wird jedes Quadrat der Anzeigeliste hinzugefügt und angezeigt (im gleichen Bereich). Hierfür kommt die Methode addChild() zum Einsatz.
  5. Der Konstruktor ruft anschließend die Methode refreshLayout() auf, mit der die orangefarbenen Quadrate mit jeweils 5 Pixel Abstand oben in der Anzeige (y = 0) verteilt werden.
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;
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/events/FocusEvent.html