Пакет | mx.managers |
Класс | public class FocusManager |
Наследование | FocusManager EventDispatcher Object |
Реализует | IFocusManager |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
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 | ||
SystemManager активирует и деактивирует FocusManager при нескольких одновременно отображаемых IFocusManagerContainer. | FocusManager | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | ||
SystemManager активирует и деактивирует FocusManager при нескольких одновременно отображаемых IFocusManagerContainer. | FocusManager | ||
Посылает событие в поток событий. | EventDispatcher | ||
Возвращает IFocusManagerComponent, содержащий данный объект при его наличии. | FocusManager | ||
Получает компонент IFocusManagerComponent, который в настоящее время имеет фокус. | FocusManager | ||
Возвращает IFocusManagerComponent, который получил бы фокус, если бы пользователь нажал клавишу Tab для перемещения к другому компоненту. | FocusManager | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Устанавливает для showFocusIndicator значение false и удаляет визуальный индикатор фокуса из сфокусированного объекта при его наличии. | FocusManager | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | ||
Устанавливает фокус на компоненте IFocusManagerComponent. | FocusManager | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Устанавливает для showFocusIndicator значение true и выводит визуальный индикатор фокуса на сфокусированном объекте при его наличии. | FocusManager | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает представление в виде строки компонента, размещающего объект FocusManager, с добавленной к концу строки строкой .focusManager. | FocusManager | ||
Возвращает элементарное значение заданного объекта. | Object | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | 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 | свойство |
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 .
|
Tue Jun 12 2018, 11:34 AM Z