Главная / Action Script 3
Пакетflash.events
Классpublic class MouseEvent
НаследованиеMouseEvent Inheritance Event Inheritance Object
Подклассы NativeDragEvent, ScreenMouseEvent

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Flash® Player отправляет объекты MouseEvent в поток событий каждый раз, когда происходит событие мыши. Как правило, событие мыши генерируется устройством ввода пользователя, например мышью или шаровым манипулятором, в котором используется указатель.

Когда в процессе принимают участие вложенные узлы, события мыши нацелены на самый глубокий вложенный узел, видимый в списке отображения. Этот узел называется целевым. Чтобы предок целевого узла получал оповещение о событии мыши, используйте метод EventDispatcher.addEventListener() для предка, указав в качестве параметра type конкретное событие мыши, которое нужно отслеживать.

Посмотреть примеры



Общедоступные свойства
 СвойствоОпределено
  altKey : Boolean
Показывает активность клавиши Alt: true — активна, false — неактивна.
MouseEvent
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие "событием на цепочке".
Event
  buttonDown : Boolean
Показывает, нажата ли основная кнопка мыши: true — да, false — нет.
MouseEvent
 Inheritedcancelable : Boolean
[только для чтения] Определяет, можно ли отключить поведение, связанное с событием.
Event
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  ctrlKey : Boolean
Показывает активность клавиши Control: true — активна, false — неактивна.
MouseEvent
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
  delta : int
Показывает расстояние прокрутки в строках на единицу вращения колесика мыши.
MouseEvent
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
  isRelatedObjectInaccessible : Boolean
Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированной средой безопасности.
MouseEvent
  localX : Number
Горизонтальная координата события относительно спрайта-контейнера.
MouseEvent
  localY : Number
Вертикальная координата события относительно спрайта-контейнера.
MouseEvent
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  relatedObject : InteractiveObject
Ссылка на объект списка отображения, связанный с событием.
MouseEvent
  shiftKey : Boolean
Показывает активность клавиши Shift: true — активна, false — неактивна.
MouseEvent
  stageX : Number
[только для чтения] Горизонтальная координата события в глобальных координатах рабочей области.
MouseEvent
  stageY : Number
[только для чтения] Вертикальная координата события в глобальных координатах рабочей области.
MouseEvent
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtype : String
[только для чтения] Тип события.
Event
Общедоступные методы
 МетодОпределено
  
MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0)
Создает объект Event, содержащий данные о событиях mouse.
MouseEvent
  
Создает копию объекта MouseEvent и задает значение каждого свойства, совпадающее с оригиналом.
MouseEvent
 Inherited
formatToString(className:String, ... arguments):String
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.
Event
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Проверяет, выполнялся ли для события вызова метода preventDefault().
Event
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Отменяет поведение по умолчанию для события, если такое поведение можно отменить.
Event
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Event
  
Возвращает строку, содержащую все свойства объекта MouseEvent.
MouseEvent
  
Предписывает проигрывателю Flash Player выполнить визуализацию после обработки данного события, если список отображения был изменен.
MouseEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 Константа Определено
 InheritedACTIVATE : String = "activate"
[статические] Константа Event.ACTIVATE определяет значение свойства type объекта события Activitate.
Event
 InheritedADDED : String = "added"
[статические] Константа Event.ADDED определяет значение свойства type добавленного объекта события.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[статические] Константа Event.ADDED_TO_STAGE определяет значение свойства type объекта события addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[статические] Константа Event.CANCEL определяет значение свойства type объекта события cancel.
Event
 InheritedCHANGE : String = "change"
[статические] Константа Event.CHANGE определяет значение свойства type объекта события change.
Event
 InheritedCLEAR : String = "clear"
[статические] Задает значение свойства type для объекта события clear.
Event
  CLICK : String = "click"
[статические] Задает значение свойства type для объекта события Click.
MouseEvent
 InheritedCLOSE : String = "close"
[статические] Константа Event.CLOSE определяет значение свойства type объекта события close.
Event
 InheritedAIR-only CLOSING : String = "closing"
[статические] Константа Event.CLOSING определяет значение свойства type объекта события closing.
Event
 InheritedCOMPLETE : String = "complete"
[статические] Константа Event.COMPLETE определяет значение свойства type объекта события complete.
Event
 InheritedCONNECT : String = "connect"
[статические] Константа Event.CONNECT определяет значение свойства type объекта события connect.
Event
 InheritedCOPY : String = "copy"
[статические] Задает значение свойства type для объекта события copy.
Event
 InheritedCUT : String = "cut"
[статические] Задает значение свойства type для объекта события cut.
Event
 InheritedDEACTIVATE : String = "deactivate"
[статические] Константа Event.DEACTIVATE определяет значение свойства type объекта события deactivate.
Event
 InheritedDISPLAYING : String = "displaying"
[статические] Задает значение свойства type для объекта события displaying.
Event
  DOUBLE_CLICK : String = "doubleClick"
[статические] Задает значение свойства type для объекта события doubleClick.
MouseEvent
 InheritedENTER_FRAME : String = "enterFrame"
[статические] Константа Event.ENTER_FRAME определяет значение свойства type объекта события enterFrame.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[статические] Определяет значение свойства type объекта exitFrame.
Event
 InheritedAIR-only EXITING : String = "exiting"
[статические] Константа Event.EXITING определяет значение свойства type объекта exiting.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[статические] Задает значение свойства type для объекта события frameConstructed.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[статические] Константа Event.FULL_SCREEN определяет значение свойства type для объекта события fullScreen.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[статические] Константа Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта htmlBoundsChange.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[статические] Константа Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[статические] Константа Event.HTML_RENDER определяет значение свойства type объекта события htmlRender.
Event
 InheritedID3 : String = "id3"
[статические] Константа Event.ID3 определяет значение свойства type объекта id3.
Event
 InheritedINIT : String = "init"
[статические] Константа Event.INIT определяет значение свойства type объекта init.
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[статические] Константа Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange.
Event
  MOUSE_DOWN : String = "mouseDown"
[статические] Задает значение свойства type для объекта события mouseDown.
MouseEvent
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[статические] Константа Event.MOUSE_LEAVE определяет значение свойства type объекта события mouseLeave.
Event
  MOUSE_MOVE : String = "mouseMove"
[статические] Задает значение свойства type для объекта события mouseMove.
MouseEvent
  MOUSE_OUT : String = "mouseOut"
[статические] Задает значение свойства type для объекта события mouseOut.
MouseEvent
  MOUSE_OVER : String = "mouseOver"
[статические] Задает значение свойства type для объекта события mouseOver.
MouseEvent
  MOUSE_UP : String = "mouseUp"
[статические] Задает значение свойства type для объекта события mouseUp.
MouseEvent
  MOUSE_WHEEL : String = "mouseWheel"
[статические] Задает значение свойства type для объекта события mouseWheel.
MouseEvent
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[статические] Константа Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange.
Event
 InheritedOPEN : String = "open"
[статические] Константа Event.OPEN определяет значение свойства type объекта open.
Event
 InheritedPASTE : String = "paste"
[статические] Задает значение свойства type для объекта события paste.
Event
 InheritedREMOVED : String = "removed"
[статические] Константа Event.REMOVED определяет значение свойства type объекта события removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[статические] Константа REMOVED_FROM_STAGE определяет значение свойства type объекта события removedFromStage.
Event
 InheritedRENDER : String = "render"
[статические] Константа Event.RENDER определяет значение свойства type объекта события render.
Event
 InheritedRESIZE : String = "resize"
[статические] Константа Event.RESIZE определяет значение свойства type объекта события resize.
Event
  ROLL_OUT : String = "rollOut"
[статические] Задает значение свойства type для объекта события rollOut.
MouseEvent
  ROLL_OVER : String = "rollOver"
[статические] Задает значение свойства type для объекта события rollOver.
MouseEvent
 InheritedSCROLL : String = "scroll"
[статические] Константа Event.SCROLL определяет значение свойства type объекта события scroll.
Event
 InheritedSELECT : String = "select"
[статические] Константа Event.SELECT определяет значение свойства type объекта события select.
Event
 InheritedSELECT_ALL : String = "selectAll"
[статические] Задает значение свойства type для объекта события selectAll.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[статические] Константа Event.SOUND_COMPLETE определяет значение свойства type объекта события soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[статические] Константа Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[статические] Константа Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[статические] Константа Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[статические] Константа Event.UNLOAD определяет значение свойства type объекта unload.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[статические] Константа Event.USER_IDLE определяет значение свойства type объекта события userIdle.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[статические] Константа Event.USER_PRESENT определяет значение свойства type объекта события userPresent.
Event
Сведения о свойстве
altKeyсвойство
altKey:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Показывает активность клавиши Alt: true — активна, false — неактивна. Поддерживается только для операционных систем Windows.



Реализация
    public function get altKey():Boolean
    public function set altKey(value:Boolean):void
buttonDownсвойство 
buttonDown:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Показывает, нажата ли основная кнопка мыши: true — да, false — нет.



Реализация
    public function get buttonDown():Boolean
    public function set buttonDown(value:Boolean):void
ctrlKeyсвойство 
ctrlKey:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Показывает активность клавиши Control: true — активна, false — неактивна. В компьютерах Macintosh это свойство необходимо использовать для представления клавиши Command.



Реализация
    public function get ctrlKey():Boolean
    public function set ctrlKey(value:Boolean):void
deltaсвойство 
delta:int  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Показывает расстояние прокрутки в строках на единицу вращения колесика мыши. Положительное значение delta показывает прокручивание вверх, отрицательное значение показывает прокрутку вниз. Как правило, используются значения в пределах 1-3, но более быстром прокручивании это число увеличивается. Этот параметр от устройства и операционной системы, как правило оно может настраиваться пользователем. Это свойство применяется только к событию MouseEvent.mouseWheel.



Реализация
    public function get delta():int
    public function set delta(value:int):void
isRelatedObjectInaccessibleсвойство 
isRelatedObjectInaccessible:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 10

Если принимает значение true, свойство relatedObject принимает значение null по причинам, связанным с изолированными средами безопасности. Если номинальным значением свойства relatedObject является ссылка на объект DisplayObject в другой изолированной среде, свойство relatedObject принимает значение null, пока не будут заданы двусторонние права в границах данной изолированной среды. Права задаются путем вызова метода Security.allowDomain() из SWF-файла или указания файла политик на сервере файла изображений и задания свойства LoaderContext.checkPolicyFile при загрузке изображения.



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

См. также

localXсвойство 
localX:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Горизонтальная координата события относительно спрайта-контейнера.



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

Пример
Как пользоваться примерами
Пример использования этого свойства см. в примере для константы MOUSE_MOVE.
localYсвойство 
localY:Number  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Вертикальная координата события относительно спрайта-контейнера.



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

Пример
Как пользоваться примерами
Пример использования этого свойства см. в примере для константы MOUSE_MOVE.
relatedObjectсвойство 
relatedObject:InteractiveObject  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Ссылка на объект списка отображения, связанный с событием. Например, когда происходит событие mouseOut, relatedObject представляет объект списка отображения, на который теперь показывает указатель. Это свойство применяется к событиям mouseOut, mouseOver, rollOut и rollOver.

Это свойство может принимать значение null по двум причинам: связанный объект отсутствует или связанный объект существует, но находится в изолированной программной среде безопасности, доступ к которой запрещен. Используйте свойство isRelatedObjectInaccessible() для определения причины.



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

См. также

shiftKeyсвойство 
shiftKey:Boolean  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Показывает активность клавиши Shift: true — активна, false — неактивна.



Реализация
    public function get shiftKey():Boolean
    public function set shiftKey(value:Boolean):void
stageXсвойство 
stageX:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Горизонтальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localX.



Реализация
    public function get stageX():Number

Пример
Как пользоваться примерами
Пример использования этого свойства см. в примере для константы MOUSE_MOVE.
stageYсвойство 
stageY:Number  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Вертикальная координата события в глобальных координатах рабочей области. Это свойство вычисляется, когда задано свойство localY.



Реализация
    public function get stageY():Number

Пример
Как пользоваться примерами
Пример использования этого свойства см. в примере для константы MOUSE_MOVE.
Сведения о конструкторе
MouseEvent()Конструктор
public function MouseEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, localX:Number = NaN, localY:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, buttonDown:Boolean = false, delta:int = 0)

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Создает объект Event, содержащий данные о событиях mouse. Объекты Event передаются прослушивателям событий в качестве параметров.

Параметры
type:String — Тип события. Допустимые значения: MouseEvent.CLICK, MouseEvent.DOUBLE_CLICK, MouseEvent.MOUSE_DOWN, MouseEvent.MOUSE_MOVE, MouseEvent.MOUSE_OUT, MouseEvent.MOUSE_OVER, MouseEvent.MOUSE_UP, MouseEvent.MOUSE_WHEEL, MouseEvent.ROLL_OUT и MouseEvent.ROLL_OVER.
 
bubbles:Boolean (default = true) — Определяет, участвует ли объект Event в фазе восходящей цепочки процесса события.
 
cancelable:Boolean (default = false) — Определяет, можно ли отменить объект Event.
 
localX:Number (default = NaN) — Горизонтальная координата события относительно спрайта-контейнера.
 
localY:Number (default = NaN) — Вертикальная координата события относительно спрайта-контейнера.
 
relatedObject:InteractiveObject (default = null) — Дополняющий экземпляр InteractiveObject, на который влияет событие. Например, когда происходит событие mouseOut, relatedObject представляет объект списка отображения, на который теперь показывает указатель.
 
ctrlKey:Boolean (default = false) — Указывает, активирована ли клавиша Control.
 
altKey:Boolean (default = false) — Указывает, активирована ли клавиша Alt (только для Windows).
 
shiftKey:Boolean (default = false) — Указывает, активирована ли клавиша Shift.
 
buttonDown:Boolean (default = false) — Указывает, нажата ли основная кнопка мыши.
 
delta:int (default = 0) — Показывает расстояние прокрутки в строках на единицу вращения колесика мыши. Положительное значение delta показывает прокручивание вверх, отрицательное значение показывает прокрутку вниз. Как правило, используются значения в пределах 1-3, но более быстром прокручивании это число увеличивается. Этот параметр используется только для события MouseEvent.mouseWheel.
Сведения о методе
clone()метод
override public function clone():Event

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Создает копию объекта MouseEvent и задает значение каждого свойства, совпадающее с оригиналом.

Возвращает
Event — Новый объект MouseEvent, значения свойств которого соответствуют значениям оригинала.
toString()метод 
override public function toString():String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Возвращает строку, содержащую все свойства объекта MouseEvent. Строка имеет следующий формат:

[MouseEvent type=значение bubbles=значение cancelable=значение ... delta=значение]

Возвращает
String — Строка, содержащая все свойства объекта MouseEvent.
updateAfterEvent()метод 
public function updateAfterEvent():void

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Предписывает проигрывателю Flash Player выполнить визуализацию после обработки данного события, если список отображения был изменен.

Сведения о константе
CLICKКонстанта
public static const CLICK:String = "click"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события click.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; нет поведения по умолчанию для отмены.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также

DOUBLE_CLICKКонстанта  
public static const DOUBLE_CLICK:String = "doubleClick"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события doubleClick. Свойство doubleClickEnabled должно иметь значение true, чтобы объект мог генерировать событие doubleClick.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; нет поведения по умолчанию для отмены.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также

MOUSE_DOWNКонстанта  
public static const MOUSE_DOWN:String = "mouseDown"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события mouseDown.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также


Пример
Как пользоваться примерами
Пример использования этой константы см. в примере константы MOUSE_MOVE.
MOUSE_MOVEКонстанта  
public static const MOUSE_MOVE:String = "mouseMove"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события mouseMove.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также


Пример

В следующем примере рассматривается простая программа для рисования. Пользователь может рисовать на основном объекте Sprite или на прямоугольном объекте Sprite меньшего размера.

В конструкторе создается прямоугольный объект Sprite с именем innerRect и задается зеленый цвет для стиля линии. Стилю линий для рисования контейнера Sprite MouseEvent_MOUSE_MOVEExample задается красный цвет. Добавляются отдельный прослушиватели событий MouseEvent.MOUSE_UP и MouseEvent.MOUSE_DOWN для основного объекта Sprite и объекта Sprite с именем innerRect приложения. В обоих случаях методы прослушивателя событий для нажатого положения мыши перемещают текущее положение точки рисования в местоположение указателя мыши и добавляют прослушиватель для события MouseEvent.MOUSE_MOVE. При перемещении указателя мыши вызванный метод прослушивателя событий следует за указателем и рисует линию с помощью метода graphics.LineTo(). ( Примечание. объект Sprite с именем innerRect скрывает красные линии основного объекта Sprite, нарисованные за прямоугольником.) Когда происходит событие MouseEvent.MOUSE_UP, прослушиватель события MOUSE_MOVE удаляется и рисование прекращается.

package {
    import flash.display.Sprite;
    import flash.display.Graphics;
    import flash.events.MouseEvent;

    public class MouseEvent_MOUSE_MOVEExample extends Sprite {
        private var innerRect:Sprite = new Sprite();
        
        public function MouseEvent_MOUSE_MOVEExample() {

            graphics.lineStyle(3, 0xFF0000, 1);
            stage.addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
            stage.addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);

            innerRect.graphics.lineStyle(1, 0x00FF00, 1);
            innerRect.graphics.beginFill(0xFFFFFF);
            innerRect.graphics.drawRect(10, 10, 200, 200);
            innerRect.graphics.endFill();
            innerRect.addEventListener(MouseEvent.MOUSE_DOWN, innerRectMouseDownHandler);
            innerRect.addEventListener(MouseEvent.MOUSE_UP, innerRectMouseUpHandler);
            addChild(innerRect);
        }

        private function mouseDownHandler(event:MouseEvent):void {
            graphics.moveTo(event.stageX, event.stageY);
            stage.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }
    
        private function mouseMoveHandler(event:MouseEvent):void {
            graphics.lineTo(event.stageX, event.stageY);
        }    
    
        private function mouseUpHandler(event:MouseEvent):void {
            stage.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        }

        private function innerRectMouseDownHandler(event:MouseEvent):void {
            innerRect.graphics.moveTo(event.localX, event.localY);
            innerRect.addEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    
        private function innerRectMouseMoveHandler(event:MouseEvent):void {
            innerRect.graphics.lineTo(event.localX, event.localY);
        }    
    
        private function innerRectMouseUpHandler(event:MouseEvent):void {
            innerRect.removeEventListener(MouseEvent.MOUSE_MOVE, innerRectMouseMoveHandler);
        }
    }
}
MOUSE_OUTКонстанта  
public static const MOUSE_OUT:String = "mouseOut"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события mouseOut.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
relatedObjectОбъект списка отображения, на который сейчас указывает мышь.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также

MOUSE_OVERКонстанта  
public static const MOUSE_OVER:String = "mouseOver"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события mouseOver.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
relatedObjectОбъект списка отображения, на который указывала мышь.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также

MOUSE_UPКонстанта  
public static const MOUSE_UP:String = "mouseUp"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type объекта события mouseUp.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также


Пример
Как пользоваться примерами
Пример использования этой константы см. в примере константы MOUSE_MOVE.
MOUSE_WHEELКонстанта  
public static const MOUSE_WHEEL:String = "mouseWheel"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события mouseWheel.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblestrue
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; поведение по умолчанию отменить нельзя.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
deltaЧисло строк, которое представляет каждая отметка на колесе прокрутки.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также

ROLL_OUTКонстанта  
public static const ROLL_OUT:String = "rollOut"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события rollOut.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; нет поведения по умолчанию для отмены.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
relatedObjectОбъект списка отображения, на который сейчас указывает мышь.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также

ROLL_OVERКонстанта  
public static const ROLL_OVER:String = "rollOver"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9

Задает значение свойства type для объекта события rollOver.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
buttonDowntrue, если нажата основная кнопка мыши; иначе — false.
cancelablefalse; нет поведения по умолчанию для отмены.
ctrlKeytrue, если клавиша Control активна; иначе — false.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
relatedObjectОбъект списка отображения, на который указывала мышь.
localXГоризонтальная координата события относительно спрайта-контейнера.
localYВертикальная координата события относительно спрайта-контейнера.
shiftKeytrue, если клавиша Shift активна; иначе — false.
stageXГоризонтальная координата события в глобальных координатах рабочей области.
stageYВертикальная координата события в глобальных координатах рабочей области.
targetОбъект InteractiveObject под указателем. Свойство target не всегда является объектом из списка отображения, для которого зарегистрирован прослушиватель событий. Используйте свойство currentTarget, чтобы обратиться к объекту в списке отображения, обрабатывающему событие в данный момент.

См. также

Примеры Как пользоваться примерами
MouseEventExample.as

В следующем примере используются классы MouseEventExample и ChildSprite, чтобы показать, как отправляются события мыши для простого изображения. Этот код выполняет следующие задачи.
  1. Заявляются свойства для размера (100 x 100 пикселов) и фонового цвета (оранжевый) для последующего использования при рисовании квадрата.
  2. Конструктор создает новый объект ChildSprite с именем child. Его конструктор сначала рисует квадрат 100 x 100 пикселов в точке с координатами (0,0) путем вызова метода draw(), а затем добавляет семь прослушивателей событий с подписчиками.
    • click/clickHandler(): отправляется, когда пользователь один раз щелкает квадрат левой кнопкой мыши.
    • doubleClick/doubleClickHandler(): отправляется, когда пользователь дважды щелкает квадрат левой кнопкой мыши.
    • mouseDown/mouseDownHandler(): когда объект ChildSprite (оранжевый квадрат) получает щелчок, на экране печатается сообщение trace(), а затем вызывается метод ChildSprite.draw(), рисующий темно-желтый квадрат вместо голубого, нарисованного методом mouseOverHandler(). Метод mouseDownHandler() также добавляет прослушиватель событий mouseMove и подписчик mouseMoveHandler() (как описано ниже, обрабатывающий перемещение мыши. Затем вызывается метод startDrag(), позволяющий перетаскивать объект Sprite.
    • mouseOut/mouseOutHandler(): отправляется, когда указатель покидает область квадрата. Вызывается метод draw(), чтобы вернуть квадрату обычный размер и цвет.
    • mouseOver/mouseOverHandler(): отправляется, когда указатель мыши находится над квадратом. Этот метод перерисовывает квадрат так, что он становится больше, а фон становится темно-желтым.
    • mouseUp/mouseUpHandler(): когда пользователь отпускает кнопку мыши, прослушиватель события mouseMove удаляется и вызывается метод stopDrag фиксирующий местоположение квадрата.
    • mouseMove/mouseMoveHandler(): вызывается в рамках функции mouseDownHandler() и отправляется, когда пользователь удерживает левую кнопку мыши и перетаскивает квадрат.
    • mouseWheel/mouseWheelHandler(): отправляется, когда пользователь прокручивает колесо мыши над квадратом.
  3. Затем экземпляр ChildSprite с именем child добавляется в список отображения с помощью метода addChild(), который быстро рисует оранжевый квадрат.

Примечания.

package {
    import flash.display.Sprite;

    public class MouseEventExample extends Sprite {
        private var size:uint = 100;
        private var bgColor:uint = 0xFFCC00;

        public function MouseEventExample() {
            var child:ChildSprite = new ChildSprite();
            addChild(child);
        }
    }
}

import flash.display.Sprite;
import flash.events.MouseEvent;

class ChildSprite extends Sprite {
    private var size:uint = 50;
    private var overSize:uint = 60;
    private var backgroundColor:uint = 0xFFCC00;
    private var overColor:uint = 0xCCFF00;
    private var downColor:uint = 0x00CCFF;

    public function ChildSprite() {
        draw(size, size, backgroundColor);
            doubleClickEnabled = true;
        addEventListener(MouseEvent.CLICK, clickHandler);
        addEventListener(MouseEvent.DOUBLE_CLICK, doubleClickHandler);
        addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
        addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
        addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
        addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
        addEventListener(MouseEvent.MOUSE_WHEEL, mouseWheelHandler);
    }

    private function draw(w:uint, h:uint, bgColor:uint):void {
        graphics.clear();
        graphics.beginFill(bgColor);
        graphics.drawRect(0, 0, w, h);
        graphics.endFill();
    }

    private function clickHandler(event:MouseEvent):void {
        trace("clickHandler");
    }

    private function doubleClickHandler(event:MouseEvent):void {
        trace("doubleClickHandler");
    }

    private function mouseDownHandler(event:MouseEvent):void {
        trace("mouseDownHandler");
        draw(overSize, overSize, downColor);

        var sprite:Sprite = Sprite(event.target);
        sprite.addEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.startDrag();
    }

    private function mouseMoveHandler(event:MouseEvent):void {
        trace("mouseMoveHandler");
        event.updateAfterEvent();
    }

    private function mouseOutHandler(event:MouseEvent):void {
        trace("mouseOutHandler");
        draw(size, size, backgroundColor);
    }

    private function mouseOverHandler(event:MouseEvent):void {
        trace("mouseOverHandler");
        draw(overSize, overSize, overColor);
    }

    private function mouseWheelHandler(event:MouseEvent):void {
        trace("mouseWheelHandler delta: " + event.delta);
    }

    private function mouseUpHandler(event:MouseEvent):void {
        trace("mouseUpHandler");
        var sprite:Sprite = Sprite(event.target);
        sprite.removeEventListener(MouseEvent.MOUSE_MOVE, mouseMoveHandler);
        sprite.stopDrag();
        draw(overSize, overSize, overColor);
    }
}