Пакет | flash.events |
Класс | public class FocusEvent |
Наследование | FocusEvent ![]() ![]() |
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
FocusEvent.FOCUS_IN
FocusEvent.FOCUS_OUT
FocusEvent.KEY_FOCUS_CHANGE
FocusEvent.MOUSE_FOCUS_CHANGE
Свойство | Определено | ||
---|---|---|---|
![]() | bubbles : Boolean [только для чтения]
Определяет, является ли событие "событием на цепочке". | Event | |
![]() | cancelable : Boolean [только для чтения]
Определяет, можно ли отключить поведение, связанное с событием. | Event | |
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
![]() | currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
![]() | eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
keyCode : uint
Значение кода клавиши, нажатой для запуска события keyFocusChange. | FocusEvent | ||
![]() | prototype : Object [статические]
Ссылка на модель объекта класса или функции. | Object | |
relatedObject : InteractiveObject
Ссылка на дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. | FocusEvent | ||
shiftKey : Boolean
Определяет, активирован ли модификатор клавиши Shift. Если да, то параметр имеет значение true. | FocusEvent | ||
![]() | target : Object [только для чтения]
Целевой объект события. | Event | |
![]() | type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)
Создает объект Event со специфической информацией, имеющей отношение к событиям фокуса. | FocusEvent | ||
Создает копию объекта FocusEvent и задает значение каждого свойства, совпадающее с оригиналом. | FocusEvent | ||
![]() |
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
Возвращает строку, содержащую все свойства объекта FocusEvent. | FocusEvent | ||
![]() |
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
![]() | ACTIVATE : String = "activate" [статические]
Константа Event.ACTIVATE определяет значение свойства type объекта события Activitate. | Event | |
![]() | ADDED : String = "added" [статические]
Константа Event.ADDED определяет значение свойства type добавленного объекта события. | Event | |
![]() | ADDED_TO_STAGE : String = "addedToStage" [статические]
Константа Event.ADDED_TO_STAGE определяет значение свойства type объекта события addedToStage. | Event | |
![]() | CANCEL : String = "cancel" [статические]
Константа Event.CANCEL определяет значение свойства type объекта события cancel. | Event | |
![]() | CHANGE : String = "change" [статические]
Константа Event.CHANGE определяет значение свойства type объекта события change. | Event | |
![]() | CLEAR : String = "clear" [статические]
Задает значение свойства type для объекта события clear. | Event | |
![]() | CLOSE : String = "close" [статические]
Константа Event.CLOSE определяет значение свойства type объекта события close. | Event | |
![]() | ![]() [статические]
Константа Event.CLOSING определяет значение свойства type объекта события closing. | Event | |
![]() | COMPLETE : String = "complete" [статические]
Константа Event.COMPLETE определяет значение свойства type объекта события complete. | Event | |
![]() | CONNECT : String = "connect" [статические]
Константа Event.CONNECT определяет значение свойства type объекта события connect. | Event | |
![]() | COPY : String = "copy" [статические]
Задает значение свойства type для объекта события copy. | Event | |
![]() | CUT : String = "cut" [статические]
Задает значение свойства type для объекта события cut. | Event | |
![]() | DEACTIVATE : String = "deactivate" [статические]
Константа Event.DEACTIVATE определяет значение свойства type объекта события deactivate. | Event | |
![]() | DISPLAYING : String = "displaying" [статические]
Задает значение свойства type для объекта события displaying. | Event | |
![]() | ENTER_FRAME : String = "enterFrame" [статические]
Константа Event.ENTER_FRAME определяет значение свойства type объекта события enterFrame. | Event | |
![]() | EXIT_FRAME : String = "exitFrame" [статические]
Определяет значение свойства type объекта exitFrame. | Event | |
![]() | ![]() [статические]
Константа Event.EXITING определяет значение свойства type объекта exiting. | Event | |
FOCUS_IN : String = "focusIn" [статические]
Задает значение свойства type для объекта события focusIn. | FocusEvent | ||
FOCUS_OUT : String = "focusOut" [статические]
Задает значение свойства type для объекта события focusOut. | FocusEvent | ||
![]() | FRAME_CONSTRUCTED : String = "frameConstructed" [статические]
Задает значение свойства type для объекта события frameConstructed. | Event | |
![]() | FULLSCREEN : String = "fullScreen" [статические]
Константа Event.FULL_SCREEN определяет значение свойства type для объекта события fullScreen. | Event | |
![]() | ![]() [статические]
Константа Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта htmlBoundsChange. | Event | |
![]() | ![]() [статические]
Константа Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize. | Event | |
![]() | ![]() [статические]
Константа Event.HTML_RENDER определяет значение свойства type объекта события htmlRender. | Event | |
![]() | ID3 : String = "id3" [статические]
Константа Event.ID3 определяет значение свойства type объекта id3. | Event | |
![]() | INIT : String = "init" [статические]
Константа Event.INIT определяет значение свойства type объекта init. | Event | |
KEY_FOCUS_CHANGE : String = "keyFocusChange" [статические]
Задает значение свойства type для объекта события keyFocusChange. | FocusEvent | ||
![]() | ![]() [статические]
Константа Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange. | Event | |
MOUSE_FOCUS_CHANGE : String = "mouseFocusChange" [статические]
Задает значение свойства type для объекта события mouseFocusChange. | FocusEvent | ||
![]() | MOUSE_LEAVE : String = "mouseLeave" [статические]
Константа Event.MOUSE_LEAVE определяет значение свойства type объекта события mouseLeave. | Event | |
![]() | ![]() [статические]
Константа Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange. | Event | |
![]() | OPEN : String = "open" [статические]
Константа Event.OPEN определяет значение свойства type объекта open. | Event | |
![]() | PASTE : String = "paste" [статические]
Задает значение свойства type для объекта события paste. | Event | |
![]() | REMOVED : String = "removed" [статические]
Константа Event.REMOVED определяет значение свойства type объекта события removed. | Event | |
![]() | REMOVED_FROM_STAGE : String = "removedFromStage" [статические]
Константа REMOVED_FROM_STAGE определяет значение свойства type объекта события removedFromStage. | Event | |
![]() | RENDER : String = "render" [статические]
Константа Event.RENDER определяет значение свойства type объекта события render. | Event | |
![]() | RESIZE : String = "resize" [статические]
Константа Event.RESIZE определяет значение свойства type объекта события resize. | Event | |
![]() | SAMPLE_DATA : String = "sampleData" [статические]
Задает значение свойства type для объекта события SampleDataEvent. | Event | |
![]() | SCROLL : String = "scroll" [статические]
Константа Event.SCROLL определяет значение свойства type объекта события scroll. | Event | |
![]() | SELECT : String = "select" [статические]
Константа Event.SELECT определяет значение свойства type объекта события select. | Event | |
![]() | SELECT_ALL : String = "selectAll" [статические]
Задает значение свойства type для объекта события selectAll. | Event | |
![]() | SOUND_COMPLETE : String = "soundComplete" [статические]
Константа Event.SOUND_COMPLETE определяет значение свойства type объекта события soundComplete. | Event | |
![]() | TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [статические]
Константа Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange. | Event | |
![]() | TAB_ENABLED_CHANGE : String = "tabEnabledChange" [статические]
Константа Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange. | Event | |
![]() | TAB_INDEX_CHANGE : String = "tabIndexChange" [статические]
Константа Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange. | Event | |
![]() | UNLOAD : String = "unload" [статические]
Константа Event.UNLOAD определяет значение свойства type объекта unload. | Event | |
![]() | ![]() [статические]
Константа Event.USER_IDLE определяет значение свойства type объекта события userIdle. | Event | |
![]() | ![]() [статические]
Константа Event.USER_PRESENT определяет значение свойства type объекта события userPresent. | Event |
keyCode | свойство |
keyCode:uint
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Значение кода клавиши, нажатой для запуска события keyFocusChange
.
public function get keyCode():uint
public function set keyCode(value:uint):void
relatedObject | свойство |
relatedObject:InteractiveObject
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Ссылка на дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. Например, когда происходит событие focusOut
, relatedObject
представляет InteractiveObject, получивший фокус.
public function get relatedObject():InteractiveObject
public function set relatedObject(value:InteractiveObject):void
shiftKey | свойство |
shiftKey:Boolean
[чтение и запись] Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Определяет, активирован ли модификатор клавиши Shift
. Если да, то параметр имеет значение true. В противном случае значение — false
. Это свойство используется, только если FocusEvent относится к типу keyFocusChange
.
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void
FocusEvent | () | Конструктор |
public function FocusEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, relatedObject:InteractiveObject = null, shiftKey:Boolean = false, keyCode:uint = 0)
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Создает объект Event со специфической информацией, имеющей отношение к событиям фокуса. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Возможные значения FocusEvent.FOCUS_IN , FocusEvent.FOCUS_OUT , FocusEvent.KEY_FOCUS_CHANGE и FocusEvent.MOUSE_FOCUS_CHANGE .
| |
bubbles:Boolean (default = true ) — Определяет, участвует ли объект Event на этапе восходящей цепочки процесса события.
| |
cancelable:Boolean (default = false ) — Определяет, можно ли отменить объект Event.
| |
relatedObject:InteractiveObject (default = null ) — Ссылка на дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. Например, когда происходит событие focusIn , relatedObject представляет InteractiveObject, потерявший фокус.
| |
shiftKey:Boolean (default = false ) — Указывает, активирован ли модификатор клавиши Shift.
| |
keyCode:uint (default = 0 ) — Значение кода клавиши, нажатой для запуска события keyFocusChange .
|
См. также
clone | () | метод |
override public function clone():Event
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Создает копию объекта FocusEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект FocusEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Возвращает строку, содержащую все свойства объекта FocusEvent. Строка имеет следующий формат:
[FocusEvent type=значение bubbles=значение cancelable=значение relatedObject=значение shiftKey=значение]
String — Строка, содержащая все свойства объекта FocusEvent.
|
FOCUS_IN | Константа |
public static const FOCUS_IN:String = "focusIn"
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает значение свойства type
для объекта события focusIn
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange . |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false ; применяется только к событиям keyFocusChange . |
target | Экземпляр InteractiveObject, только что получивший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget , чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
|
См. также
FOCUS_OUT | Константа |
public static const FOCUS_OUT:String = "focusOut"
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает значение свойства type
для объекта события focusOut
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | true |
cancelable | false ; нет поведения по умолчанию для отмены. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange . |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false ; применяется только к событиям keyFocusChange . |
target | Экземпляр InteractiveObject, только что потерявший фокус. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget , чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
|
См. также
KEY_FOCUS_CHANGE | Константа |
public static const KEY_FOCUS_CHANGE:String = "keyFocusChange"
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает значение свойства type
для объекта события keyFocusChange
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | true |
cancelable | true ; вызовите метод preventDefault() для отмены поведения по умолчанию. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | Значение кода клавиши, нажатой для запуска события keyFocusChange . |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | true , если активирована клавиша Shift; иначе — false . |
target | Объект InteractiveObject, который в данный момент находится в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget , чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
|
См. также
MOUSE_FOCUS_CHANGE | Константа |
public static const MOUSE_FOCUS_CHANGE:String = "mouseFocusChange"
Язык версии : | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 9 |
Задает значение свойства type
для объекта события mouseFocusChange
.
Данное событие имеет следующие свойства.
Свойство | Значение |
---|---|
bubbles | true |
cancelable | true ; вызовите метод preventDefault() для отмены поведения по умолчанию. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
keyCode | 0; применяется только к событиям keyFocusChange . |
relatedObject | Дополняющий экземпляр InteractiveObject, на который влияет смена фокуса. |
shiftKey | false ; применяется только к событиям keyFocusChange . |
target | Объект InteractiveObject, который в данный момент находится в фокусе. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget , чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.
|
См. также
FocusEventExample
и CustomSprite
, чтобы продемонстрировать, как фокус можно использовать вместе с элементами, нарисованными в рабочей области, для захвата и печати информации. Этот код выполняет следующие задачи.
child
(типа Sprite) и childCount
(типа uint).for
создает пять голубых квадратов в точке с координатами (0,0). Сначала свойство child
назначается новому экземпляру CustomSprite. При создании каждого объекта CustomSprite происходит следующее.
size
типа uint задается значение 50 (в пикселах), а для bgColor
задается голубой цвет. buttonMode
и useHandCursor
задается значение true
.click
вместе со связанным подписчиком clickHandler()
. Метод подписчика создает локальную переменную target
типа Sprite и присваивает ее полю, получившему щелчок. После этого фокус рабочей области переводится на target
.draw()
, создающий квадрат 50 x 50 пикселов путем вызова методов beginFill()
, drawRect()
и endFill()
класса Graphics и свойств экземпляра.configureListeners()
, создающий три пары прослушивателей событий и подписчиков:
focusIn
/focusInHandler()
отправляется после события click
для любого объекта списка отображения (поля) получившего щелчок.focusOut
/focusOutHandler()
отправляется, когда щелчок получает другое поле или когда фокус покидает рабочую область (например, при щелчке за пределами Flash Player).keyFocusChange
/keyFocusChangeHandler()
отправляется, если для выбора объекта списка отображения используется клавиша Tab или клавиши со стрелками влево или вправо. Однако метод keyFocusChangeHandler()
перехватывает клавиши со стрелками влево и вправо и отключает их, вызвав метод preventDefault()
.for
каждый квадрат добавляется в список отображения и показывается с помощью метода addChild()
(все в одной и той же области).refreshLayout()
, располагающий оранжевые квадраты по верхнему краю экрана (y = 0) на расстоянии 5 пикселов друг от друга.package { import flash.display.Sprite; import flash.display.DisplayObject; import flash.events.FocusEvent; import flash.events.IEventDispatcher; public class FocusEventExample extends Sprite { private var gutter:uint = 5; private var childCount:uint = 5; public function FocusEventExample() { var child:Sprite; for(var i:uint; i < childCount; i++) { child = new CustomSprite(); configureListeners(child); addChild(child); } refreshLayout(); } private function configureListeners(dispatcher:IEventDispatcher):void { dispatcher.addEventListener(FocusEvent.FOCUS_IN, focusInHandler); dispatcher.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler); dispatcher.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, keyFocusChangeHandler); dispatcher.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, mouseFocusChangeHandler); } private function refreshLayout():void { var ln:uint = numChildren; var child:DisplayObject = getChildAt(0); var lastChild:DisplayObject = child; for(var i:uint = 1; i < ln; i++) { child = getChildAt(i); child.x = lastChild.x + lastChild.width + gutter; lastChild = child; } } private function focusInHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("focusInHandler: " + target.name); } private function focusOutHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("focusOutHandler: " + target.name); } private function keyFocusChangeHandler(event:FocusEvent):void { if(event.keyCode == 39 || event.keyCode == 37){ event.preventDefault() } var target:CustomSprite = CustomSprite(event.target); trace("keyFocusChangeHandler: " + target.name); } private function mouseFocusChangeHandler(event:FocusEvent):void { var target:CustomSprite = CustomSprite(event.target); trace("mouseFocusChangeHandler: " + target.name); } } } import flash.display.Sprite; import flash.events.MouseEvent; class CustomSprite extends Sprite { private var size:uint = 50; private var bgColor:uint = 0x00CCFF; public function CustomSprite() { buttonMode = true; useHandCursor = true; addEventListener(MouseEvent.CLICK, clickHandler); draw(size, size); } private function draw(w:uint, h:uint):void { graphics.beginFill(bgColor); graphics.drawRect(0, 0, w, h); graphics.endFill(); } private function clickHandler(event:MouseEvent):void { var target:Sprite = Sprite(event.target); trace("clickHandler: " + target.name); stage.focus = target; } }