Paket | flash.events |
Klasse | public class FocusEvent |
Vererbung | FocusEvent Event Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
-
FocusEvent.FOCUS_IN
-
FocusEvent.FOCUS_OUT
-
FocusEvent.KEY_FOCUS_CHANGE
-
FocusEvent.MOUSE_FOCUS_CHANGE
Eigenschaft | Definiert von | ||
---|---|---|---|
bubbles : Boolean [schreibgeschützt]
Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt. | Event | ||
cancelable : Boolean [schreibgeschützt]
Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann. | Event | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
currentTarget : Object [schreibgeschützt]
Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. | Event | ||
direction : String
Gibt die Richtung des Fokus für ein focusIn-Ereignis an. | FocusEvent | ||
eventPhase : uint [schreibgeschützt]
Die aktuelle Phase im Ereignisablauf. | Event | ||
isRelatedObjectInaccessible : Boolean
Falls „true“, ist die relatedObject-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null gesetzt. | FocusEvent | ||
keyCode : uint
Der Tastencodewert der Taste, die zum Auslösen eines „keyFocusChange“-Ereignisses gedrückt wird. | FocusEvent | ||
relatedObject : InteractiveObject
Ein Verweis auf die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. | FocusEvent | ||
shiftKey : Boolean
Gibt an, ob die Umschalttaste als Zusatztaste aktiviert ist. In diesem Fall lautet der Wert „true“. | FocusEvent | ||
target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | ||
type : String [schreibgeschützt]
Der Ereignistyp. | Event |
Methode | Definiert von | ||
---|---|---|---|
FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0, direction:String = "none")
Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für Fokus-Ereignisse wichtig sind. | FocusEvent | ||
[override]
Erstellt eine Kopie des FocusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht. | FocusEvent | ||
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
[override]
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des FocusEvent-Objekts enthält. | FocusEvent | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object |
Konstante | Definiert von | ||
---|---|---|---|
FOCUS_IN : String = "focusIn" [statisch]
Definiert den Wert der Eigenschaft „type“ eines focusIn-Ereignisobjekts. | FocusEvent | ||
FOCUS_OUT : String = "focusOut" [statisch]
Definiert den Wert der Eigenschaft „type“ eines focusOut-Ereignisobjekts. | FocusEvent | ||
KEY_FOCUS_CHANGE : String = "keyFocusChange" [statisch]
Definiert den Wert der Eigenschaft „type“ eines keyFocusChange-Ereignisobjekts. | FocusEvent | ||
MOUSE_FOCUS_CHANGE : String = "mouseFocusChange" [statisch]
Definiert den Wert der Eigenschaft „type“ eines mouseFocusChange-Ereignisobjekts. | FocusEvent |
direction | Eigenschaft |
isRelatedObjectInaccessible | Eigenschaft |
isRelatedObjectInaccessible:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 10, Flash Lite 4 |
Wenn true
, ist die relatedObject
-Eigenschaft aus Gründen, die mit der Sicherheitssandbox zusammenhängen, auf null
gesetzt. Ist der Nominalwert von relatedObject
ein Verweis auf ein DisplayObject in einer anderen Sandbox, wird relatedObject
auf null
gesetzt, es sei denn, die Berechtigung gilt über die Sandboxgrenzen hinweg für beide Richtungen. Die Berechtigung wird eingerichtet, indem aus einer SWF-Datei Security.allowDomain()
aufgerufen wird oder eine Richtliniendatei vom Server einer Bilddatei bereitgestellt und die LoaderContext.checkPolicyFile
-Eigenschaft beim Laden des Bilds gesetzt wird.
Implementierung
public function get isRelatedObjectInaccessible():Boolean
public function set isRelatedObjectInaccessible(value:Boolean):void
Verwandte API-Elemente
keyCode | Eigenschaft |
relatedObject | Eigenschaft |
relatedObject:InteractiveObject
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Der Wert dieser Eigenschaft kann in zwei Fällen null
sein: Wenn es kein verwandtes Objekt gibt oder wenn es eines gibt, dieses aber eine Sicherheitssandbox ist, auf die Sie keinen Zugriff haben. Verwenden Sie die isRelatedObjectInaccessible()
-Eigenschaft, um festzustellen, welcher dieser Gründe zutrifft.
Implementierung
public function get relatedObject():InteractiveObject
public function set relatedObject(value:InteractiveObject):void
Verwandte API-Elemente
shiftKey | Eigenschaft |
shiftKey:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Gibt an, ob die Umschalttaste als Zusatztaste 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
FocusEvent | () | Konstruktor |
public function FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0, direction:String = "none")
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt ein Ereignisobjekt mit bestimmten Informationen, die für Fokus-Ereignisse wichtig sind. Ereignisobjekte werden Ereignis-Listenern als Parameter übergeben.
Parametertype:String — Der Ereignistyp. Mögliche Werte sind: FocusEvent.FOCUS_IN , FocusEvent.FOCUS_OUT , FocusEvent.KEY_FOCUS_CHANGE und FocusEvent.MOUSE_FOCUS_CHANGE .
| |
bubbles:Boolean (default = true ) — Bestimmt, ob das Ereignisobjekt an der Bubbling-Phase des Ereignisablaufs teilnimmt.
| |
cancelable:Boolean (default = false ) — Bestimmt, 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 die Umschalttaste als Zusatztaste aktiviert ist.
| |
keyCode:uint (default = 0 ) — Gibt den Tastencodewert der Taste an, die zum Auslösen eines keyFocusChange -Ereignisses gedrückt wird.
| |
direction:String (default = "none ") — Gibt an, aus welcher Richtung das interaktive Zielobjekt aktiviert wurde. Hat den Wert FocusDirection.NONE (der Standardwert) für alle Ereignisse außer focusIn .
|
Verwandte API-Elemente
clone | () | Methode |
override public function clone():Event
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Erstellt eine Kopie des FocusEvent-Objekts und stellt den Wert jeder Eigenschaft so ein, dass er dem Wert des Originals entspricht.
RückgabewerteEvent — Ein neues FocusEvent-Objekt mit Eigenschaftswerten, die denen des Originals entsprechen.
|
toString | () | Methode |
override public function toString():String
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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] keyCode=Wert]
String — Eine Zeichenfolge, die alle Eigenschaften des FocusEvent-Objekts enthält.
|
FOCUS_IN | Konstante |
public static const FOCUS_IN:String = "focusIn"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definiert den Wert der Eigenschaft type
eines focusIn
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | 0; gilt nur für keyFocusChange -Ereignisse. |
relatedObject | Die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. |
shiftKey | false ; gilt nur für keyFocusChange -Ereignisse. |
target | Die 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.
|
direction | Die Richtung, aus der der Fokus zugewiesen wurde. Diese Eigenschaft meldet den Wert des direction -Parameters der assignFocus() -Methode auf der Bühne. Wird der Fokus durch andere Mittel geändert, ist der Wert immer FocusDirection.NONE . Gilt nur für focusIn -Ereignisse. Für alle anderen focus-Ereignisse ist der Wert FocusDirection.NONE . |
Verwandte API-Elemente
FOCUS_OUT | Konstante |
public static const FOCUS_OUT:String = "focusOut"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definiert den Wert der Eigenschaft type
eines focusOut
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | 0; gilt nur für keyFocusChange -Ereignisse. |
relatedObject | Die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. |
shiftKey | false ; gilt nur für keyFocusChange -Ereignisse. |
target | Die 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.
|
Verwandte API-Elemente
KEY_FOCUS_CHANGE | Konstante |
public static const KEY_FOCUS_CHANGE:String = "keyFocusChange"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definiert den Wert der Eigenschaft type
eines keyFocusChange
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | true ; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | Der Tastencodewert der Taste, die zum Auslösen eines keyFocusChange -Ereignisses gedrückt wird. |
relatedObject | Die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. |
shiftKey | true , wenn die Umschalttaste als Zusatztaste aktiviert ist, andernfalls false . |
target | Die 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.
|
Verwandte API-Elemente
MOUSE_FOCUS_CHANGE | Konstante |
public static const MOUSE_FOCUS_CHANGE:String = "mouseFocusChange"
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Definiert den Wert der Eigenschaft type
eines mouseFocusChange
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | true |
cancelable | true ; rufen Sie die Methode preventDefault() auf, um das Standardverhalten abzubrechen. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
keyCode | 0; gilt nur für keyFocusChange -Ereignisse. |
relatedObject | Die andere InteractiveObject-Instanz, die von dem Fokuswechsel betroffen ist. |
shiftKey | false ; gilt nur für keyFocusChange -Ereignisse. |
target | Die 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.
|
Verwandte API-Elemente
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:
- Die Eigenschaften
child
(vom Typ "Sprite") undchildCount
(vom Typ "uint") werden deklariert. - Mit einer
for
-Schleife werden am Punkt (0,0) fünf hellblaue Quadrate gezeichnet. Zuerst wird einer neuen CustomSprite-Instanz die Eigenschaftchild
zugewiesen. Jedes Mal, wenn ein CustomSprite-Objekt erstellt wird, passiert Folgendes:- Die Eigenschaft
size
vom Typ "uint" wird auf 50 Pixel gesetzt, undbgColor
wird auf hellblau gesetzt. - Die Eigenschaften
buttonMode
unduseHandCursor
der Klasse "Sprite" werden innerhalb des Konstruktors auftrue
gesetzt. - Es wird ein Ereignis-Listener vom Typ
click
zusammen mit dem verknüpften AbonnentenclickHandler()
instanziiert. Die Abonnentenmethode erstellt eine lokaletarget
-Variable vom Typ „Sprite“ und weist sie dem Feld zu, auf das geklickt wurde. Anschließend wird der Fokus der Bühne der Variablentarget
zugewiesen. - Die Methode
draw()
wird aufgerufen. Hierdurch wird ein 50 x 50 Pixel großes Quadrat mit den MethodenbeginFill()
,drawRect()
undendFill()
der Graphics-Klasse und der Instanzeigenschaften erstellt.
- Die Eigenschaft
- 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 derkeyFocusChangeHandler()
-Methode werden die Aktionen der Nach-links- und Nach-rechts-Pfeiltasten überwacht. Außerdem wird die MethodepreventDefault()
zur Deaktivierung aufgerufen.
- In der
for
-Schleife wird jedes Quadrat der Anzeigeliste hinzugefügt und angezeigt (im gleichen Bereich). Hierfür kommt die MethodeaddChild()
zum Einsatz. - 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; } }
Tue Jun 12 2018, 10:04 AM Z