FocusManager

Paket	mx.managers
Klasse	public class FocusManager
Vererbung	FocusManager EventDispatcher Object
Implementiert	IFocusManager

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Die FocusManager-Klasse verwaltet den Fokus auf Komponenten auf eine Maus- oder Tastaturaktivität hin (Tabulatortaste). Eine Anwendung kann mehrere FocusManager-Instanzen aufweisen. Jede FocusManager-Instanz ist für eine Gruppe von Komponenten verantwortlich, die eine „Tabulatorschleife“ bilden. Wenn Sie die Tabulatortaste oft genug drücken, durchläuft der Fokus eine Reihe von Komponenten und kehrt zu der Komponente zurück, der der Fokus zuerst zugewiesen war. Diese sogenannte Tabulatorschleife wird von einem FocusManager verwaltet. Falls es Popup-Fenster mit eigenen Komponentengruppen in einer Tabulatorschleife gibt, verfügen diese Fenster über ihre eigenen FocusManager-Instanzen. Die Hauptanwendung verfügt immer über eine FocusManager-Instanz.

Der FocusManager verwaltet den Fokus der Komponentenebene. In Flex ist ein UITextField die einzige Möglichkeit, die Eingabe von Text über die Tastatur zuzulassen. In Flash Player oder AIR ist diesem UITextField der Fokus zugewiesen. Vom Blickwinkel des FocusManagers aus ist der Komponente, die UITextField übergeordnet ist, der Fokus zugewiesen. Daher besteht ein Unterschied zwischen dem Fokus auf Komponentenebene und dem Fokus auf Player-Ebene. Anwendungsentwickler müssen normalerweise nur den Fokus auf Komponentenebene und Komponentenentwickler den Fokus auf Player-Ebene verstehen.

Alle Komponenten, die von einem FocusManager verwaltet werden können, müssen mx.managers.IFocusManagerComponent implementieren. Bei Objekten, deren Fokus auf Player-Ebene verwaltet wird, ist dies nicht erforderlich.

Der FocusManager verwaltet darüber hinaus eine Standardschaltfläche (defaultButton). Hierbei handelt es sich um die Schaltfläche auf einem Formular, die ein click-Ereignis auslöst, wenn die Eingabetaste gedrückt wird, je nachdem, wo sich der Fokus zu diesem Zeitpunkt befindet.

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		FocusManager(container:IFocusManagerContainer, popup:Boolean = false) Konstruktor.	FocusManager
		activate():void Der SystemManager aktiviert und deaktiviert einen FocusManager, wenn mehrere „IFocusManagerContainer“ gleichzeitig sichtbar sind.	FocusManager
		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.	EventDispatcher
		deactivate():void Der SystemManager aktiviert und deaktiviert einen FocusManager, wenn mehrere „IFocusManagerContainer“ gleichzeitig sichtbar sind.	FocusManager
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent Gibt die IFocusManagerComponent-Komponente zurück, die das entsprechende Objekt enthält (sofern vorhanden).	FocusManager
		getFocus():IFocusManagerComponent Ruft die IFocusManagerComponent-Komponente ab, die gerade den Fokus besitzt.	FocusManager
		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.	FocusManager
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		hideFocus():void Setzt „showFocusIndicator“ auf „false“ und entfernt den sichtbaren Fokusindikator von dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden).	FocusManager
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setFocus(o:IFocusManagerComponent):void Legt den Fokus auf eine IFocusManagerComponent-Komponente.	FocusManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		showFocus():void Setzt „showFocusIndicator“ auf „true“ und zeichnet einen sichtbaren Fokusindikator auf dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden).	FocusManager
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String [override] Gibt eine Stringdarstellung der Komponente zurück, die das FocusManager-Objekt hostet, wobei „.focusManager“ am Ende des Strings hinzugefügt wird.	FocusManager
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		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.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

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

Konstruktordetails

()

Konstruktor

public function FocusManager(container:IFocusManagerContainer, popup:Boolean = false)

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Konstruktor.

Ein FocusManager verwaltet den Fokus für die untergeordneten Objekte eines IFocusManagerContainers. Er installiert sich während der Ausführung des Konstruktors im IFocusManagerContainer.

Parameter

	`container:IFocusManagerContainer` — Ein IFocusManagerContainer, der den FocusManager hostet.

	`popup:Boolean` (default = `false`) — Bei `true` enthält der Container eine Popup-Komponente und nicht die Hauptanwendung.

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.

Der FocusManager fügt Ereignisprozeduren hinzu, mit denen fokusrelevante Tastatur- und Mauseingaben überwacht werden können.

deactivate

()

Methode

public function deactivate():void

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Der FocusManager entfernt Ereignisprozeduren, mit denen fokusrelevante Tastatur- und Mauseingaben überwacht werden können.

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).

toString

()

Methode

override public function toString():String

Sprachversion:

ActionScript 3.0

Produktversion:

Flex 3

Laufzeitversionen:

Flash Player 9, AIR 1.1

Gibt eine Stringdarstellung der Komponente zurück, die das FocusManager-Objekt hostet, wobei .focusManager am Ende des Strings hinzugefügt wird.

Rückgabewerte

String — Gibt eine Stringdarstellung der Komponente zurück, die das FocusManager-Objekt hostet, wobei .focusManager am Ende des Strings hinzugefügt wird.

Rechtliche Hinweise | Onlinedatenschutzerklärung

FocusManager - AS3 Flex

Klassen x

defaultButton

defaultButtonEnabled

focusPane

nextTabIndex

showFocusIndicator

FocusManager

activate

deactivate

findFocusManagerComponent

getFocus

getNextFocusManagerComponent

hideFocus

setFocus

showFocus

toString