FocusManager

Пакет	mx.managers
Класс	public class FocusManager
Наследование	FocusManager EventDispatcher Object
Реализует	IFocusManager

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Класс FocusManager управляет фокусом на компонентах в ответ на действия мыши или клавиатуры (клавиши Tab). В приложении могут быть несколько экземпляров FocusManager. Каждый экземпляр FocusManager ответственен за набор компонентов, составляющих «цикл табуляции». При необходимом количестве нажатий клавиши Tab фокус проходит через набор компонентов, и, в конечном счете, возвращается к исходному компоненту. Это и есть «цикл табуляции», а экземпляр FocusManager управляет этим циклом. При наличии всплывающих окон с их собственным набором компонентов в «цикле табуляции» эти всплывающие окна будут иметь собственные экземпляры FocusManager. Главное приложение всегда имеет экземпляр FocusManager.

FocusManager управляет фокусом из «уровня компонентов». Во Flex UITextField в компоненте является единственным способом ввода текста с клавиатуры. В Flash Player или AIR этот UITextField имеет фокус. Однако с точки зрения FocusManager фокус имеет компонент, являющийся вышестоящим элементом по отношению к UITextField. Таким образом, существует различие между фокусом уровня проигрывателя и фокусом уровня компонентов. Как правило, разработчики приложений имеют дело только с фокусом уровня компонентов, в то время как разработчики компонентов должны иметь представление о фокусе уровня проигрывателя.

Все компоненты, которыми можно управлять с помощью FocusManager, должны реализовать mx.managers.IFocusManagerComponent, в то время как объекты, управляемые фокусом уровня проигрывателя, не должны.

FocusManager также управляет понятием defaultButton, являющимся кнопкой на форме, передающей событие щелчка мышью при нажатии клавиши Enter в зависимости от того, где находится фокус в этот момент времени.

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		defaultButton : IButton Ссылка на исходный элемент управления Button по умолчанию.	FocusManager
		defaultButtonEnabled : Boolean Флаг, указывающий, должен ли FocusManager проверить, была ли нажата клавиша Enter для активации кнопки по умолчанию.	FocusManager
		focusPane : Sprite Одиночный спрайт, перемещаемый из контейнера в контейнер при перемещении фокуса в эти контейнеры.	FocusManager
		nextTabIndex : int [только для чтения] Следующий уникальный индекс табуляции для использования в этом цикле табуляции.	FocusManager
		showFocusIndicator : Boolean Флаг, указывающий, отображать ли индикатор того, что компонент имеет фокус.	FocusManager

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		FocusManager(container:IFocusManagerContainer, popup:Boolean = false) Конструктор.	FocusManager
		activate():void SystemManager активирует и деактивирует FocusManager при нескольких одновременно отображаемых IFocusManagerContainer.	FocusManager
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		deactivate():void SystemManager активирует и деактивирует FocusManager при нескольких одновременно отображаемых IFocusManagerContainer.	FocusManager
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent Возвращает IFocusManagerComponent, содержащий данный объект при его наличии.	FocusManager
		getFocus():IFocusManagerComponent Получает компонент IFocusManagerComponent, который в настоящее время имеет фокус.	FocusManager
		getNextFocusManagerComponent(backward:Boolean = false):IFocusManagerComponent Возвращает IFocusManagerComponent, который получил бы фокус, если бы пользователь нажал клавишу Tab для перемещения к другому компоненту.	FocusManager
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		hideFocus():void Устанавливает для showFocusIndicator значение false и удаляет визуальный индикатор фокуса из сфокусированного объекта при его наличии.	FocusManager
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setFocus(o:IFocusManagerComponent):void Устанавливает фокус на компоненте IFocusManagerComponent.	FocusManager
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		showFocus():void Устанавливает для showFocusIndicator значение true и выводит визуальный индикатор фокуса на сфокусированном объекте при его наличии.	FocusManager
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String [переопределить] Возвращает представление в виде строки компонента, размещающего объект FocusManager, с добавленной к концу строки строкой .focusManager.	FocusManager
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Событие		Сводка	Определено
		activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
		deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher

Сведения о свойстве

defaultButton

свойство

defaultButton:IButton

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Ссылка на исходный элемент управления Button по умолчанию. Нажатие клавиши Enter при нахождении фокуса на любом элементе управления активирует элемент управления Button путем передачи события click на элемент управления Button, как если бы по нему щелкнули мышью. Фактический элемент управления Button по умолчанию изменяется при передаче фокуса другому элементу управления Button, но переключается обратно на оригинал, если фокус не находится на кнопке.

Этим свойством управляют контейнеры Flex; не следует устанавливать его непосредственно для указания кнопки по умолчанию.

defaultButton должен иметь класс mx.controls.Button даже в том случае, если это свойство имеет тип IUIComponent.

Реализация
public function get defaultButton():IButton
public function set defaultButton(value:IButton):void

defaultButtonEnabled

свойство

defaultButtonEnabled:Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Флаг, указывающий, должен ли FocusManager проверить, была ли нажата клавиша Enter для активации кнопки по умолчанию. TextArea и другие компоненты, для которых требуется распознать нажатие клавиши Enter, устанавливают для этого свойства значение false для отключения передачи события click клавишей Enter по кнопке по умолчанию, если она существует.

Реализация
public function get defaultButtonEnabled():Boolean
public function set defaultButtonEnabled(value:Boolean):void

focusPane

свойство

focusPane:Sprite

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Одиночный спрайт, перемещаемый из контейнера в контейнер при перемещении фокуса в эти контейнеры. Спрайт используется в качестве вышестоящего элемента визуального индикатора того, что компонент имеет фокус.

Реализация
public function get focusPane():Sprite
public function set focusPane(value:Sprite):void

nextTabIndex

свойство

nextTabIndex:int [только для чтения]

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Следующий уникальный индекс табуляции для использования в этом цикле табуляции.

Реализация
public function get nextTabIndex():int

showFocusIndicator

свойство

showFocusIndicator:Boolean

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Флаг, указывающий, отображать ли индикатор того, что компонент имеет фокус. При значении true получающий фокус компонент выводит визуальный индикатор о том, что он имеет фокус.

По умолчанию это значение false до тех пор, пока пользователь не использует клавишу Tab, затем устанавливается значение true.

Для изменения этого свойства предпочтительнее использовать методы showFocus() и hideFocus(), поскольку эти методы также обновляют визуальный индикатор о том, что компонент имеет фокус.

Реализация
public function get showFocusIndicator():Boolean
public function set showFocusIndicator(value:Boolean):void

Сведения о конструкторе

()

Конструктор

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Конструктор.

FocusManager управляет фокусом внутри нижестоящих элементов IFocusManagerContainer. Он устанавливается в IFocusManagerContainer во время выполнения конструктора.

Параметры

	`container:IFocusManagerContainer` — IFocusManagerContainer, размещающий FocusManager.

	`popup:Boolean` (default = `false`) — Значение `true` указывает, что контейнер является всплывающим компонентом, а не главным приложением.

Сведения о методе

activate

()

метод

public function activate():void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

SystemManager активирует и деактивирует FocusManager при нескольких одновременно отображаемых IFocusManagerContainer. При нажатии кнопки мыши в IFocusManagerContainer при деактивированном FocusManager SystemManager вызовет метод activate() на этом FocusManager. До активации другого FocusManager у активированного FocusManager будет вызван метод deactivate().

FocusManager добавляет обработчиков события, позволяющих ему контролировать связанные с фокусом действия клавиатуры и мыши.

deactivate

()

метод

public function deactivate():void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

FocusManager удаляет обработчиков событий, позволяющих ему контролировать связанные с фокусом действия клавиатуры и мыши.

findFocusManagerComponent

()

метод

public function findFocusManagerComponent(o:InteractiveObject):IFocusManagerComponent

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает IFocusManagerComponent, содержащий данный объект при его наличии. Поскольку проигрыватель мог установить фокус на субкомпоненте компонента Flex, этот метод определяет, какой IFocusManagerComponent имеет фокус с точки зрения компонента.

Параметры

o:InteractiveObject — Объект, который может иметь фокус уровня проигрывателя.

Возвращает

IFocusManagerComponent — IFOcusManagerComponent, содержащий o или null

getFocus

()

метод

public function getFocus():IFocusManagerComponent

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Получает компонент IFocusManagerComponent, который в настоящее время имеет фокус. Рекомендуется выполнить вызов этого метода вместо использования объекта рабочей области, т.к. он указывает, какой компонент имеет фокус. Рабочая область может вернуть субкомпонент в этом компоненте.

Возвращает

IFocusManagerComponent — Объект IFocusManagerComponent, который имеет фокус.

getNextFocusManagerComponent

()

метод

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

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает IFocusManagerComponent, который получил бы фокус, если бы пользователь нажал клавишу Tab для перемещения к другому компоненту. Он возвратит тот же компонент в качестве текущего сфокусированного компонента, если отсутствуют другие допустимые компоненты в приложении.

Параметры

backward:Boolean (default = false) — При значении true возвращает объект, как при нажатии клавиш Shift-Tab.

Возвращает

IFocusManagerComponent — Компонент, который получил бы фокус.

hideFocus

()

метод

public function hideFocus():void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Устанавливает для showFocusIndicator значение false и удаляет визуальный индикатор фокуса из сфокусированного объекта при его наличии.

setFocus

()

метод

public function setFocus(o:IFocusManagerComponent):void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Устанавливает фокус на компоненте IFocusManagerComponent. Не проверяет видимость компонентов, включенное состояние или любые другие условия.

Параметры

o:IFocusManagerComponent — Компонент, который может получить фокус.

showFocus

()

метод

public function showFocus():void

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Устанавливает для showFocusIndicator значение true и выводит визуальный индикатор фокуса на сфокусированном объекте при его наличии.

toString

()

метод

override public function toString():String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Возвращает представление в виде строки компонента, размещающего объект FocusManager, с добавленной к концу строки строкой .focusManager.

Возвращает

String — Возвращает представление в виде строки компонента, размещающего объект FocusManager, с добавленной к концу строки строкой .focusManager.

Юридическая информация | Политика конфиденциальности онлайн

FocusManager - AS3 Flex

Классы x

defaultButton

defaultButtonEnabled

focusPane

nextTabIndex

showFocusIndicator

FocusManager

activate

deactivate

findFocusManagerComponent

getFocus

getNextFocusManagerComponent

hideFocus

setFocus

showFocus

toString