Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
mx.managers 

FocusManager  - AS3 Flex

Пакетmx.managers
Классpublic class FocusManager
НаследованиеFocusManager Inheritance EventDispatcher Inheritance 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 в зависимости от того, где находится фокус в этот момент времени.



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : 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
  
SystemManager активирует и деактивирует FocusManager при нескольких одновременно отображаемых IFocusManagerContainer.
FocusManager
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.
EventDispatcher
  
SystemManager активирует и деактивирует FocusManager при нескольких одновременно отображаемых IFocusManagerContainer.
FocusManager
 Inherited
Посылает событие в поток событий.
EventDispatcher
  
Возвращает IFocusManagerComponent, содержащий данный объект при его наличии.
FocusManager
  
Получает компонент IFocusManagerComponent, который в настоящее время имеет фокус.
FocusManager
  
Возвращает IFocusManagerComponent, который получил бы фокус, если бы пользователь нажал клавишу Tab для перемещения к другому компоненту.
FocusManager
 Inherited
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.
EventDispatcher
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
  
Устанавливает для showFocusIndicator значение false и удаляет визуальный индикатор фокуса из сфокусированного объекта при его наличии.
FocusManager
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Удаляет прослушиватель из объекта EventDispatcher.
EventDispatcher
  
Устанавливает фокус на компоненте IFocusManagerComponent.
FocusManager
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
  
Устанавливает для showFocusIndicator значение true и выводит визуальный индикатор фокуса на сфокусированном объекте при его наличии.
FocusManager
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
[переопределить] Возвращает представление в виде строки компонента, размещающего объект FocusManager, с добавленной к концу строки строкой .focusManager.
FocusManager
 Inherited
Возвращает элементарное значение заданного объекта.
Object
 Inherited
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.
EventDispatcher
События
 Событие Сводка Определено
 Inherited[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.EventDispatcher
 Inherited[многоадресное событие] Отправляется, когда проигрыватель 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
Сведения о конструкторе

FocusManager

()Конструктор
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

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

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.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.