IFocusManager - Adobe ActionScript® 3 (AS3 Flex) API-Referenz

Paket	mx.managers
Schnittstelle	public interface IFocusManager extends IEventDispatcher
Umsetzer	FocusManager

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die IFocusManager-Schnittstelle definiert die Schnittstelle, die von Komponenten implementiert werden muss, um den Fokus bei Maus- oder Tastaturaktivität (Tabulatortaste) auf eine andere Komponente zu verschieben und um eine Standardschaltfläche zu unterstützen.

Verwandte API-Elemente

mx.managers.FocusManager

Öffentliche Eigenschaften

	Eigenschaft		Definiert von
		defaultButton : IButton Ein Verweis auf das ursprüngliche Button-Standardsteuerelement.	IFocusManager
		defaultButtonEnabled : Boolean Ein Flag, das angibt, ob der FocusManager prüfen soll, ob die Eingabetaste gedrückt wurde, um die Standardschaltfläche zu aktivieren.	IFocusManager
		focusPane : Sprite Ein einzelnes Sprite, das zusammen mit dem Fokus von einem Container zu einem anderen verschoben wird.	IFocusManager
		nextTabIndex : int [schreibgeschützt] Die nächste eindeutige Position, die in der Tabulatorschleife verwendet werden soll.	IFocusManager
		showFocusIndicator : Boolean Ein Flag, das angibt, ob ein Indikator angezeigt werden soll, um darauf aufmerksam zu machen, dass eine Komponente den Fokus besitzt.	IFocusManager

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		activate():void Der SystemManager aktiviert und deaktiviert einen FocusManager, wenn mehrere „IFocusManagerContainer“ gleichzeitig sichtbar sind.	IFocusManager
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	IEventDispatcher
		deactivate():void Der SystemManager aktiviert und deaktiviert einen FocusManager, wenn mehrere „IFocusManagerContainer“ gleichzeitig sichtbar sind.	IFocusManager
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	IEventDispatcher
		findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent Gibt die IFocusManagerComponent-Komponente zurück, die das entsprechende Objekt enthält (sofern vorhanden).	IFocusManager
		getFocus():IFocusManagerComponent Ruft die IFocusManagerComponent-Komponente ab, die gerade den Fokus besitzt.	IFocusManager
		getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent Gibt die IFocusManagerComponent zurück, die den Fokus erhalten würde, falls der Benutzer die Tabulatortaste drücken würde, um zu einer anderen Komponente zu navigieren.	IFocusManager
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	IEventDispatcher
		hideFocus():void Setzt „showFocusIndicator“ auf „false“ und entfernt den sichtbaren Fokusindikator von dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden).	IFocusManager
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	IEventDispatcher
		setFocus(o:IFocusManagerComponent):void Legt den Fokus auf eine IFocusManagerComponent-Komponente.	IFocusManager
		showFocus():void Setzt „showFocusIndicator“ auf „true“ und zeichnet einen sichtbaren Fokusindikator auf dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden).	IFocusManager
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	IEventDispatcher

Eigenschaftendetails

defaultButton

Eigenschaft

defaultButton:IButton

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Verweis auf das ursprüngliche Button-Standardsteuerelement. Wird die Eingabetaste gedrückt, während der Fokus auf einem Steuerelement liegt, dann wird das Button-Steuerelement aktiviert, indem ein click-Ereignis auf dem Button-Steuerelement ausgelöst wird. Dies entspricht einem Mausklick auf das Steuerelement. Das tatsächliche Button-Standardsteuerelement ändert sich, wenn der Fokus an ein anderes Button-Steuerelement übergeben wird, wechselt jedoch zurück zum ursprünglichen Element, wenn der Fokus nicht auf einer Schaltfläche liegt.

Diese Eigenschaft wird von Flex-Containern verwaltet. Legen Sie sie nicht direkt fest, um die Standardschaltfläche anzugeben.

Der defaultButton muss der mx.controls.Button-Klasse angehören, auch wenn diese Eigenschaft nicht den Typ IUIComponent aufweist.

Implementierung
public function get defaultButton():IButton
public function set defaultButton(value:IButton):void

defaultButtonEnabled

Eigenschaft

defaultButtonEnabled:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Flag, das angibt, ob der FocusManager prüfen soll, ob die Eingabetaste gedrückt wurde, um die Standardschaltfläche zu aktivieren. TextArea und andere Komponenten, von denen die Eingabetaste erkannt werden soll, setzen diese Eigenschaft auf false, damit die Eingabetaste kein click-Ereignis auf die Standardschaltfläche auslöst, falls diese vorhanden ist.

Implementierung
public function get defaultButtonEnabled():Boolean
public function set defaultButtonEnabled(value:Boolean):void

focusPane

Eigenschaft

focusPane:Sprite

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein einzelnes Sprite, das zusammen mit dem Fokus von einem Container zu einem anderen verschoben wird. Das Sprite wird als übergeordnetes Objekt des visuellen Indikators verwendet, der anzeigt, dass eine Komponente den Fokus besitzt.

Implementierung
public function get focusPane():Sprite
public function set focusPane(value:Sprite):void

nextTabIndex

Eigenschaft

nextTabIndex:int [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die nächste eindeutige Position, die in der Tabulatorschleife verwendet werden soll.

Implementierung
public function get nextTabIndex():int

showFocusIndicator

Eigenschaft

showFocusIndicator:Boolean

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ein Flag, das angibt, ob ein Indikator angezeigt werden soll, um darauf aufmerksam zu machen, dass eine Komponente den Fokus besitzt. Bei true zeigt eine Komponente, die den Fokus erhält, einen sichtbaren Indikator an.

Standardmäßig ist für diese Eigenschaft false festgelegt, bis der Benutzer die Tabulatortaste drückt. Dann wechselt die Eigenschaft auf true.

Im Allgemeinen sollte die showFocus()- und hideFocus()-Methode zum Ändern dieser Eigenschaft verwendet werden, da diese Methoden auch den visuellen Indikator aktualisieren, der angibt, dass einer Komponente der Fokus zugewiesen ist.

Implementierung
public function get showFocusIndicator():Boolean
public function set showFocusIndicator(value:Boolean):void

Methodendetails

activate

()

Methode

public function activate():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der SystemManager aktiviert und deaktiviert einen FocusManager, wenn mehrere „IFocusManagerContainer“ gleichzeitig sichtbar sind. Wird in einem „IFocusManagerContainer“ bei deaktiviertem FocusManager mit der Maus geklickt, ruft der SystemManager die activate()-Methode für den jeweiligen FocusManager auf. Für den aktivierten FocusManager wird seine deactivate()-Methode aufgerufen, bevor ein anderer FocusManager aktiviert wird.

deactivate

()

Methode

public function deactivate():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

findFocusManagerComponent

()

Methode

public function findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt die IFocusManagerComponent-Komponente zurück, die ggf. das gegebene Objekt enthält. Da der Player den Fokus auf die Unterkomponente einer Flex-Komponente legen kann, wird durch diese Methode ermittelt, welche IFocusManagerComponent vom Blickwinkel der Komponente aus über den Fokus verfügt.

Parameter

o:InteractiveObject — Ein Objekt, das über den Fokus auf Player-Ebene verfügen kann.

Rückgabewerte

IFocusManagerComponent — IFocusManagerComponent, die o oder null enthält.

getFocus

()

Methode

public function getFocus():IFocusManagerComponent

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Ruft die IFocusManagerComponent-Komponente auf, die gerade den Fokus besitzt. Verwenden Sie diese Methode anstelle des Stage-Objekts, da hier angegeben wird, auf welcher Komponente der Fokus liegt. Das Stage-Objekt gibt unter Umständen eine Unterkomponente in der Komponente zurück.

Rückgabewerte

IFocusManagerComponent — Das IFocusManagerComponent-Objekt, das den Fokus besitzt.

getNextFocusManagerComponent

()

Methode

public function getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt die IFocusManagerComponent zurück, die den Fokus erhalten würde, falls der Benutzer die Tabulatortaste drücken würde, um zu einer anderen Komponente zu navigieren. Es wird die Komponente zurückgegeben, der gegenwärtig der Fokus zugewiesen ist, wenn die Anwendung keine anderen gültigen Komponenten enthält.

Parameter

backward:Boolean (default = false) — Wenn true angegeben ist, wird das Objekt zurückgegeben, das beim Drücken von Umschalt+Tabulatortaste den Fokus erhält.

Rückgabewerte

IFocusManagerComponent — Die Komponente, die den Fokus als Nächstes erhält.

hideFocus

()

Methode

public function hideFocus():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Setzt showFocusIndicator auf false und entfernt den sichtbaren Fokusindikator von dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden).

setFocus

()

Methode

public function setFocus(o:IFocusManagerComponent):void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Legt den Fokus auf eine IFocusManagerComponent-Komponente. Die Sichtbarkeit, der Aktivierungsstatus und andere Bedingungen der Komponente werden hiermit nicht überprüft.

Parameter

o:IFocusManagerComponent — Eine Komponente, die den Fokus erhalten kann.

showFocus

()

Methode

public function showFocus():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Setzt showFocusIndicator auf true und zeichnet einen sichtbaren Fokusindikator auf dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden).

Rechtliche Hinweise | Onlinedatenschutzerklärung

IFocusManager - AS3 Flex

Klassen x

defaultButton

defaultButtonEnabled

focusPane

nextTabIndex

showFocusIndicator

activate

deactivate

findFocusManagerComponent

getFocus

getNextFocusManagerComponent

hideFocus

setFocus

showFocus