FocusManager

Paquete	mx.managers
Clase	public class FocusManager
Herencia	FocusManager EventDispatcher Object
Implementa	IFocusManager

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

The FocusManager class manages the focus on components in response to mouse activity or keyboard activity (Tab key). There can be several FocusManager instances in an application. Each FocusManager instance is responsible for a set of components that comprise a "tab loop". If you hit Tab enough times, focus traverses through a set of components and eventually get back to the first component that had focus. That is a "tab loop" and a FocusManager instance manages that loop. If there are popup windows with their own set of components in a "tab loop" those popup windows will have their own FocusManager instances. The main application always has a FocusManager instance.

The FocusManager manages focus from the "component level". In Flex, a UITextField in a component is the only way to allow keyboard entry of text. To the Flash Player or AIR, that UITextField has focus. However, from the FocusManager's perspective the component that parents the UITextField has focus. Thus there is a distinction between component-level focus and player-level focus. Application developers generally only have to deal with component-level focus while component developers must understand player-level focus.

All components that can be managed by the FocusManager must implement mx.managers.IFocusManagerComponent, whereas objects managed by player-level focus do not.

The FocusManager also managers the concept of a defaultButton, which is the Button on a form that dispatches a click event when the Enter key is pressed depending on where focus is at that time.

Más ejemplos

Focus in sandboxed applications
Focus in multi-versioned applications

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		defaultButton : IButton A reference to the original default Button control.	FocusManager
		defaultButtonEnabled : Boolean A flag that indicates whether the FocusManager should check for the Enter key being pressed to activate the default button.	FocusManager
		focusPane : Sprite A single Sprite that is moved from container to container as the focus moves to those containers.	FocusManager
		nextTabIndex : int [solo lectura] The next unique tab index to use in this tab loop.	FocusManager
		showFocusIndicator : Boolean A flag that indicates whether to display an indicator that a component has focus.	FocusManager

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		FocusManager(container:IFocusManagerContainer, popup:Boolean = false) Constructor.	FocusManager
		activate():void The SystemManager activates and deactivates a FocusManager if more than one IFocusManagerContainer is visible at the same time.	FocusManager
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		deactivate():void The SystemManager activates and deactivates a FocusManager if more than one IFocusManagerContainer is visible at the same time.	FocusManager
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent Returns the IFocusManagerComponent that contains the given object, if any.	FocusManager
		getFocus():IFocusManagerComponent Gets the IFocusManagerComponent component that currently has the focus.	FocusManager
		getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent Returns the IFocusManagerComponent that would receive focus if the user pressed the Tab key to navigate to another component.	FocusManager
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		hideFocus():void Sets showFocusIndicator to false and removes the visual focus indicator from the focused object, if any.	FocusManager
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setFocus(o:IFocusManagerComponent):void Sets focus to an IFocusManagerComponent component.	FocusManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		showFocus():void Sets showFocusIndicator to true and draws the visual focus indicator on the focused object, if any.	FocusManager
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String [override] Returns a String representation of the component hosting the FocusManager object, with the String ".focusManager" appended to the end of the String.	FocusManager
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Evento		Resumen	Definido por
		activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
		deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher

Información sobre propiedades

defaultButton

propiedad

defaultButton:IButton

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

A reference to the original default Button control. Pressing the Enter key while the focus is on any control activates the Button control by dispatching a click event on the Button control, just as if it was clicked with the mouse. The actual default Button control changes if focus is given to another Button control, but switches back to the original if focus is not on a button.

This property is managed by Flex containers; do not set it directly to specify the default button.

The defaultButton must be of class mx.controls.Button even though this property is of type IUIComponent.

Implementación
public function get defaultButton():IButton
public function set defaultButton(value:IButton):void

defaultButtonEnabled

propiedad

defaultButtonEnabled:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

A flag that indicates whether the FocusManager should check for the Enter key being pressed to activate the default button. TextArea and other components that want to recognize the Enter key set this property to false to disable the Enter key from dispatching a click event on the default button, if it exists.

Implementación
public function get defaultButtonEnabled():Boolean
public function set defaultButtonEnabled(value:Boolean):void

focusPane

propiedad

focusPane:Sprite

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

A single Sprite that is moved from container to container as the focus moves to those containers. The Sprite is used as the parent of the visual indicator that a component has focus.

Implementación
public function get focusPane():Sprite
public function set focusPane(value:Sprite):void

nextTabIndex

propiedad

nextTabIndex:int [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

The next unique tab index to use in this tab loop.

Implementación
public function get nextTabIndex():int

showFocusIndicator

propiedad

showFocusIndicator:Boolean

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

A flag that indicates whether to display an indicator that a component has focus. If true a component receiving focus draws a visible indicator that it has focus.

By default, this is false until the user uses the Tab key, then it is set to true.

In general it is better to use the showFocus() and hideFocus() methods to change this property as those methods also update the visual indicator that a component has focus.

Implementación
public function get showFocusIndicator():Boolean
public function set showFocusIndicator(value:Boolean):void

Información sobre constructores

()

Información sobre

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Constructor.

A FocusManager manages the focus within the children of an IFocusManagerContainer. It installs itself in the IFocusManagerContainer during execution of the constructor.

Parámetros

	`container:IFocusManagerContainer` — An IFocusManagerContainer that hosts the FocusManager.

	`popup:Boolean` (default = `false`) — If `true`, indicates that the container is a popup component and not the main application.

Información sobre métodos

activate

()

método

public function activate():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

The SystemManager activates and deactivates a FocusManager if more than one IFocusManagerContainer is visible at the same time. If the mouse is clicked in an IFocusManagerContainer with a deactivated FocusManager, the SystemManager will call the activate() method on that FocusManager. The FocusManager that was activated will have its deactivate() method called prior to the activation of another FocusManager.

The FocusManager adds event handlers that allow it to monitor focus related keyboard and mouse activity.

deactivate

()

método

public function deactivate():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

The FocusManager removes event handlers that allow it to monitor focus related keyboard and mouse activity.

findFocusManagerComponent

()

método

public function findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Returns the IFocusManagerComponent that contains the given object, if any. Because the player can set focus to a subcomponent of a Flex component this method determines which IFocusManagerComponent has focus from the component perspective.

Parámetros

o:InteractiveObject — An object that can have player-level focus.

Valor devuelto

IFocusManagerComponent — The IFOcusManagerComponent containing o or null

getFocus

()

método

public function getFocus():IFocusManagerComponent

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Gets the IFocusManagerComponent component that currently has the focus. Calling this method is recommended instead of using the Stage object because it indicates which component has focus. The Stage might return a subcomponent in that component.

Valor devuelto

IFocusManagerComponent — IFocusManagerComponent object that has focus.

getNextFocusManagerComponent

()

método

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

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Returns the IFocusManagerComponent that would receive focus if the user pressed the Tab key to navigate to another component. It will return the same component as the current focused component if there are no other valid components in the application.

Parámetros

backward:Boolean (default = false) — If true, return the object as if the Shift-Tab keys were pressed.

Valor devuelto

IFocusManagerComponent — The component that would receive focus.

hideFocus

()

método

public function hideFocus():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Sets showFocusIndicator to false and removes the visual focus indicator from the focused object, if any.

setFocus

()

método

public function setFocus(o:IFocusManagerComponent):void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Sets focus to an IFocusManagerComponent component. Does not check for the components visibility, enabled state, or any other conditions.

Parámetros

o:IFocusManagerComponent — A component that can receive focus.

showFocus

()

método

public function showFocus():void

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Sets showFocusIndicator to true and draws the visual focus indicator on the focused object, if any.

toString

()

método

override public function toString():String

Versión del lenguaje:

ActionScript 3.0

Versión de producto:

Flex 3

Versiones de motor de ejecución:

Flash Player 9, AIR 1.1

Returns a String representation of the component hosting the FocusManager object, with the String ".focusManager" appended to the end of the String.

Valor devuelto

String — Returns a String representation of the component hosting the FocusManager object, with the String ".focusManager" appended to the end of the String.

Avisos legales | Política de privacidad en línea

FocusManager - AS3 Flex

Clases x

defaultButton

defaultButtonEnabled

focusPane

nextTabIndex

showFocusIndicator

FocusManager

activate

deactivate

findFocusManagerComponent

getFocus

getNextFocusManagerComponent

hideFocus

setFocus

showFocus

toString