| 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 |
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.
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 | ||
| Methode | Definiert von | ||
|---|---|---|---|
Konstruktor. | FocusManager | ||
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 | |
Der SystemManager aktiviert und deaktiviert einen FocusManager, wenn mehrere „IFocusManagerContainer“ gleichzeitig sichtbar sind. | FocusManager | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Gibt die IFocusManagerComponent-Komponente zurück, die das entsprechende Objekt enthält (sofern vorhanden). | FocusManager | ||
Ruft die IFocusManagerComponent-Komponente ab, die gerade den Fokus besitzt. | FocusManager | ||
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 | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
Setzt „showFocusIndicator“ auf „false“ und entfernt den sichtbaren Fokusindikator von dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden). | FocusManager | ||
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
Legt den Fokus auf eine IFocusManagerComponent-Komponente. | FocusManager | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
Setzt „showFocusIndicator“ auf „true“ und zeichnet einen sichtbaren Fokusindikator auf dem Objekt, das gegenwärtig den Fokus besitzt (sofern vorhanden). | FocusManager | ||
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
[override]
Gibt eine Stringdarstellung der Komponente zurück, die das FocusManager-Objekt hostet, wobei „.focusManager“ am Ende des Strings hinzugefügt wird. | FocusManager | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
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):voiddefaultButtonEnabled | 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):voidfocusPane | 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):voidnextTabIndex | Eigenschaft |
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):voidFocusManager | () | 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.
Parametercontainer:IFocusManagerContainer — Ein IFocusManagerContainer, der den FocusManager hostet.
| |
popup:Boolean (default = false)true enthält der Container eine Popup-Komponente und nicht die Hauptanwendung.
|
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 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 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.
|
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ückgabewerteIFocusManagerComponent — 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)true angegeben ist, wird das Objekt zurückgegeben, das beim Drücken von Umschalt+Tabulatortaste den Fokus erhält.
|
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.
String — Gibt eine Stringdarstellung der Komponente zurück, die das FocusManager-Objekt hostet, wobei .focusManager am Ende des Strings hinzugefügt wird.
|
Tue Jun 12 2018, 10:04 AM Z