InteractiveObject  - AS3

Текущая реализация специальных возможностей (AccessibilityImplementation) для данного экземпляра InteractiveObject.

Связанные элементы API

Определяет контекстное меню, связанное с данным объектом.

Для содержимого, запущенного в проигрывателе Flash Player, это свойство является объектом ContextMenu. В среде выполнения AIR класс ContextMenu расширяет класс NativeMenu, однако Flash Player поддерживает только класс ContextMenu, но не класс NativeMenu.

Примечание. Объекты TextField всегда содержат меню буфера обмена в контекстном меню. Меню буфера обмена включает команды «Вырезать», «Копировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll.

var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

Определяет, получает ли объект события doubleClick. Значение по умолчанию — false: по умолчанию экземпляр InteractiveObject не получает событий doubleClick. Если свойству doubleClickEnabled задано значение true, экземпляр получает события doubleClick в своих границах. Свойство mouseEnabled экземпляра InteractiveObject должно иметь значение true, чтобы объект мог получать события doubleClick.

При настройке данного свойства события не отправляются. Чтобы добавить прослушиватель события doubleClick, необходимо использовать метод addEventListener().

Связанные элементы API

Задает отображение прямоугольной рамки индикатора фокуса для данного объекта. Может принимать одно из трех значений true, false или null. Значения true и false дают ожидаемые результаты, определяя, будет ли появляться прямоугольник в фокусе. Значение null указывает, что данный объект подчиняется свойству stageFocusRect рабочей области.

Определяет, получает ли этот объект события мыши или другого пользовательского ввода. Значение по умолчанию — true, которое указывает, что по умолчанию любой экземпляр InteractiveObject в списке отображения получает события мыши или других устройств пользовательского ввода. Если свойство mouseEnabled имеет значение false, экземпляр не получает событий мыши (или события другого пользовательского ввода, например клавиатуры). Эта настройка не затрагивает дочерние элементы данного экземпляра в списке отображения. Чтобы изменить поведение mouseEnabled для всех дочерних элементов объекта в списке отображения, используйте flash.display.DisplayObjectContainer.mouseChildren.

При настройке данного свойства события не отправляются. Чтобы создать интерактивные функции, необходимо использовать метод addEventListener().

Связанные элементы API

Определяет, должна ли отображаться виртуальная клавиатура (программная экранная клавиатура), когда этот экземпляр InteractiveObject получает фокус.

По умолчанию задано значение false. Когда экземпляр InteractiveObject получает фокус, программная клавиатура не отображается. Если для свойства needsSoftKeyboard задано значение true, то во время выполнения отображается программная клавиатура, когда экземпляр InteractiveObject готов принять ввод данных пользователем. Экземпляр InteractiveObject готов принять ввод данных пользователем после программного вызова для задания свойства focus рабочей области свойства или действий пользователя, например «касания». Если в клиентской системе есть аппаратная клавиатура или она не поддерживает виртуальные клавиатуры, то программная клавиатура не отображается.

Экземпляр InteractiveObject передает события softKeyboardActivating, softKeyboardActivate и softKeyboardDeactivate при отображении и переводе на задний план программной клавиатуры.

Примечание. Это свойство не поддерживается в приложениях AIR для iOS.

Связанные элементы API

Управляет внешним видом программной клавиатуры.

Устройства с программной клавиатурой могут настраивать кнопки клавиатуры в соответствии с типом ожидаемого ввода. Например, если ожидается ввод числовых данных, на устройстве может использоваться SoftKeyboardType.NUMBER для отображения только цифр для программной клавиатуры. Допустимые значения определены в виде констант в классе SoftKeyboardType:

• "default"
• "punctuation"
• "url"
• "number"
• "contact"
• "email"
• "phone"
• "decimalpad"

Эти значения служат подсказками, помогающим устройству отобразить наиболее подходящую клавиатуру для текущей операции.

Значением по умолчанию является SoftKeyboardType.DEFAULT.

Связанные элементы API

Определяет область, которая должна оставаться на экране при отображении программной клавиатуры (недоступна в iOS).

Если для свойства needsSoftKeyboard этого объекта InteractiveObject задано значение true, то среда выполнения корректирует отображение, чтобы объект оставался в области отображения, когда пользователь вводит данные. Обычно среда выполнения использует границы объекта, полученные из метода DisplayObject.getBounds(). Можно указать другую область, используя свойство softKeyboardInputAreaOfInterest.

Укажите softKeyboardInputAreaOfInterest в координатах рабочей области.

Примечание. В ОС Android softKeyboardInputAreaOfInterest не учитывается с альбомной ориентацией.

Примечание. softKeyboardInputAreaOfInterest не поддерживается в iOS.

Связанные элементы API

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

• Для объекта SimpleButton используется значение true.
• Для объекта TextField с type = "input" используется значение true.
• Для объекта Sprite или MovieClip с buttonMode = true используется значение true.

Задает последовательность перехода между объектами в SWF-файле. Свойство tabIndex по умолчанию имеет значение -1, то есть для объекта не задан индекс при переходе с помощью клавиши Tab.

Если какой-либо отображаемый в данный момент объект в SWF-файле имеет свойство tabIndex, автоматическая последовательность перехода с помощью клавиши Tab отключается, и последовательность перехода вычисляется по свойствам tabIndex объектов SWF-файла. Пользовательская последовательность перехода с помощью клавиши Tab включает только объекты, имеющие свойство tabIndex.

Свойство tabIndex может быть выражено неотрицательным числом. Последовательность перехода определяется в соответствии со свойствами tabIndex объектов в восходящем порядке. Объект со значением 1 свойства tabIndex предшествует объекту со значением 2 свойства tabIndex. Нельзя использовать одинаковое значение tabIndex для нескольких объектов.

Пользовательская последовательность перехода с помощью клавиши Tab, определяемая свойством tabIndex, является линейной. Это значит, что иерархические отношения объектов в SWF-файле не учитываются. Все объекты в SWF-файле со свойствами tabIndex помещаются в последовательность перехода с помощью клавиши Tab, которая определяется последовательностью значений tabIndex.

Примечание. Чтобы установить порядок табуляции для экземпляров TLFTextField, передайте дочерний объект экранного объекта TLFTextField как InteractiveObject, затем задайте свойство tabIndex. Например:

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

При вызове конструктора new InteractiveObject() выдается исключение ArgumentError. Однако можно вызывать конструкторы для следующих подклассов InteractiveObject:

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

Вызывает виртуальную клавиатуру.

Вызов этого метода наводит фокус на экземпляр InteractiveObject и вызывает программную клавиатуру, если необходимо. Значение needsSoftKeyboard должно равняться true. Клавиатура не вызывается, если доступна аппаратная клавиатура или если система клиента не поддерживает виртуальные клавиатуры.

Примечание. Этот метод не поддерживается в приложениях AIR для iOS.

Связанные элементы API

Отправляется, когда пользователь выбирает команду «Удалить» из контекстного меню текста. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объектом, находящимся в фокусе, является экземпляр TextField, событием по умолчанию является удаление выделенного в данный момент текстового поля.

Это событие имеет следующие свойства:

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

Отправляется, когда пользователь нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject. Чтобы произошло событие «click», оно должно следовать за данной последовательностью событий, перечисленных в порядке появления: событие mouseDown, а затем mouseUp. Оба эти события должны иметь ту же цель, иначе событие click не произойдет. Между событиями mouseDown или mouseUp может произойти любое количество других событий мыши; событие click все равно происходит.

Это событие имеет следующие свойства:

Отправляется, когда жест пользователя вызывает контекстное меню, связанное с данным интерактивным объектом в приложении AIR.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Копировать», или выбирает команду «Копировать» из контекстного меню. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объектом, находящимся в фокусе, является экземпляр TextField, событием по умолчанию является копирование в буфер обмена выделенного в данный момент текстового поля.

Это событие имеет следующие свойства:

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

Отправляется, когда пользователь активирует комбинацию клавиш быстрого вызова, используемую на данной платформе для операции «Вырезать», или выбирает команду «Вырезать» из контекстного меню. Это событие отправляется объекту, который в данный момент находится в фокусе. Если объектом, находящимся в фокусе, является экземпляр TextField, событием по умолчанию является вырезание и сохранение в буфере обмена выделенного в данный момент текстового поля.

Это событие имеет следующие свойства:

Примечание. Объектами TextField не отправляются события clear, copy, cut, paste или selectAll. Объекты TextField в контекстном меню всегда включают команды «Вырезать», «Скопировать», «Вставить» и «Выбрать все». Удалить эти команды из контекстного меню для объектов TextField невозможно. Для объектов TextField выбор этих команд (или сочетаний клавиш, эквивалентных элементу меню) не приводит к генерации событий clear, copy, cut, paste или selectAll. Однако другие классы, которые распространяют класс InteractiveObject, включая компоненты, построенные, используя текстовую Службу Flash (FTE), отправят эти события в ответ на операции пользователя, например, комбинации клавиш и контекстные меню.

Отправляется, когда пользователь дважды нажимает и отпускает главную кнопку на указывающем устройстве над одним и тем же объектом InteractiveObject, а флаг doubleClickEnabled для этого объекта имеет значение true. Чтобы произошло событие doubleClick, оно должно следовать непосредственно за этими последовательностями событий: mouseDown, mouseUp, click, mouseDown, mouseUp. У всех этих событий должна быть та же цель, что и у события doubleClick. Второй щелчок, представленный событиями mouseDown и mouseUp, должен произойти в пределах заданного периода времени после события click. Допустимая продолжительность этого периода варьируется в зависимости от операционной системы и может настраиваться пользователем. Если цель — выбираемое текстовое поле, действие по умолчанию — выделение слова, находящегося под указателем. Если у целевого объекта InteractiveObject флаг doubleClickEnabled имеет значение true, он получает два события click.

По умолчанию свойство doubleClickEnabled имеет значение false.

Выделение текста двойным щелчком как поведение объекта TextField не связано с событием doubleClick. Используйте TextField.doubleClickEnabled для управления выделением TextField.

Это событие имеет следующие свойства:

Связанные элементы API

Отправляется после того, как экранный объект перемещается в фокус. Это происходит, когда пользователь выделяет объект с помощью указателя или клавиатуры. Получатель фокуса называется целевым объектом события, а соответствующий экземпляр InteractiveObject, потерявший фокус в результате данного изменения, называется связанным объектом. Ссылка на связанный объект сохраняется в свойстве relatedObject получающего объекта. Свойство shiftKey не используется. Это событие следует после отправки события focusOut предыдущего объекта.

Это событие имеет следующие свойства:

Отправляется после того, как экранный объект теряет фокус. Это происходит, когда пользователь выделяет другой объект с помощью указателя или клавиатуры. Объект, теряющий фокус, называется целевым объектом события, а соответствующий экземпляр InteractiveObject, получающий фокус, называется связанным объектом. Ссылка на связанный объект сохраняется в свойстве relatedObject целевого объекта. Свойство shiftKey не используется. Это событие предшествует отправке события focusIn связанным объектом.

Это событие имеет следующие свойства:

Отправляется, когда пользователь создает точку контакта вдоль края сенсорной поверхности с помощью экземпляра InteractiveObject (например, нажатие по краю сенсорной поверхности на пульте Siri Remote для Apple TV). Некоторые устройства также могут интерпретировать этот контакт как комбинацию нескольких событий касания.

В частности, если пользователь ставит палец на объект InteractiveObject, а затем сдвигает его, экземпляр InteractiveObject может отправить события touchBegin и touchEnd (помимо прочих), а также событие gestureDirectionalTap либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события touchBegin, один и тот же обработчик события будет использоваться для устройств с сенсорным экраном. Однако, если требуется обрабатывать событие gestureDirectionalTap, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события жеста и прикосновения. Но класс flash.ui.Multitouch определяет, какое событие будет отправлено: прикосновения или жеста.

При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта (для Apple TV это центр экрана). Свойства offsetX и offsetY соответствуют направлению жеста.

Примечание. Данный API-интерфейс поддерживает только направленные прикосновения одним пальцем.

Объект TransformGestureEvent имеет следующие свойства.

Связанные элементы API

Отправляется, когда пользователь наживает две точки контакта над одним экземпляром InteractiveObject на устройстве с сенсорным экраном (например, двумя пальцами нажимает точки над экранным объектом и отпускает их при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие doubleClick.

В частности, если пользователь касается двумя пальцами объекта InteractiveObject, то экземпляр InteractiveObject может отправить события doubleClick или gestureTwoFingerTap, либо оба сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события doubleClick, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureTwoFingerTap, обработчик можно создать таким образом, чтобы он реагировал на конкретные события устройства с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.

Примечание. Сведения о совместимости сред см. в описании класса Multitouch.

Связанные элементы API

Отправляется, когда пользователь перемещает точку контакта с экземпляром InteractiveObject на устройстве с сенсорным экраном (например, касается пальцем и проводит им слева направо над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать этот контакт как событие mouseOver и touchOver.

В частности, если пользователь проводит пальцем над объектом InteractiveObject, то вдобавок к событию gesturePan экземпляр InteractiveObject может отправить события mouseOver или touchOver либо все события сразу, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gesturePan, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.

Примечание. Сведения о совместимости сред см. в описании класса Multitouch.

Объект TransformGestureEvent имеет следующие свойства.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Связанные элементы API

Отправляется, когда пользователь выполняет жест поворота в точке контакта с экземпляром InteractiveObject (например, касание двумя пальцами и их вращение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Вращение двумя пальцами является распространенным жестом поворота, но в каждом устройстве и операционной системе могут быть собственные требования к жестам поворота. Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.

В частности, если пользователь проводит пальцем над объектом InteractiveObject, то вдобавок к событию gestureRotate экземпляр InteractiveObject может отправить события mouseOver и click (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureRotate, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.

При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта. Свойства offsetX и offsetY указывают расстояние до точки контакта, в которой завершился жест поворота.

Примечание. Сведения о совместимости сред см. в описании класса Multitouch.

Во время этого события свойство rotation содержит угол поворота. Возможны следующие значения поворота:

• от 0 до 180 градусов указывают направление по часовой стрелке
• от - 180 до 0 градусов указывают направление против часовой стрелки

Объект TransformGestureEvent имеет следующие свойства.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Связанные элементы API

Отправляется, когда пользователь выполняет жест выделения в точке контакта с экземпляром InteractiveObject (например, касание экрана тремя пальцами и их параллельное перемещение над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Параллельное движение пальцами является распространенным жестом выделения, но в разных устройствах и операционных системах могут предъявляться различные требования к этому движению. Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.

В частности, если пользователь ставит пальцы на объект InteractiveObject, а затем перемещает их параллельно, то вдобавок к событию gestureSwipe экземпляр InteractiveObject может отправить события rollOver и rollOut (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Если задана обработка события rollOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureSwipe, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.

При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта. Свойства offsetX и offsetY указывают расстояние до точки контакта, в которой завершился жест выделения.

Примечание. Хотя некоторые устройства с ОС Mac OS могут интерпретировать жест выделения четырьмя пальцами, данный API поддерживает только выделение тремя пальцами.

Объект TransformGestureEvent имеет следующие свойства.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

Связанные элементы API

Отправляется, когда пользователь создает точку контакта с экземпляром InteractiveObject, а затем касается сенсорного экрана (например, касается экранного объекта несколькими пальцами, чтобы открыть меню, а затем касается одним пальцем для выбора нужного элемента меню при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.

В частности, если пользователь наводит палец на объект InteractiveObject, а затем делает второе касание, то вдобавок к событию gesturePressAndTap экземпляр InteractiveObject может отправить события mouseOver и click (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gesturePressAndTap, обработчик можно создать таким образом, чтобы он реагировал на конкретные события устройства с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.

При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты точки первичного контакта (нажатия). Свойства offsetX и offsetY указывают расстояние до точки вторичного контакта (касания).

Связанные элементы API

Отправляется, когда пользователь выполняет жест увеличения в точке контакта с экземпляром InteractiveObject (например, касание экрана двумя пальцами и их быстрое разведение в стороны над экранным объектом при использовании мобильного телефона или планшетного компьютера с сенсорным экраном). Разведение пальцев является распространенным жестом увеличения, но в каждом устройстве и операционной системе могут быть собственные требования к жестам масштабирования. Некоторые устройства также могут интерпретировать такой жест как комбинацию из нескольких событий мыши.

В частности, если пользователь наводит палец на объект InteractiveObject, а затем разводит пальцы в стороны, то вдобавок к событию gestureZoom экземпляр InteractiveObject может отправить события mouseOver и click (помимо прочих), либо все события, если это поддерживается текущей средой. Выберите способ обработки взаимодействия с пользователем. Используйте класс flash.ui.Multitouch для управления обработкой событий (включите обработку событий сложных жестов, событий простых точечных касаний или выключите события касания, чтобы отправлялись только события мыши). Если задана обработка события mouseOver, то один и тот же обработчик события будет использоваться для устройств с сенсорным экраном и для устройств с мышью. Однако если требуется обрабатывать событие gestureZoom, обработчик можно создать таким образом, чтобы он удовлетворял конкретные потребности устройств с сенсорным экраном и предоставлял пользователям расширенные возможности управления с помощью жестов. Также можно обрабатывать оба события по отдельности, чтобы обеспечить разную реакцию на события прикосновения и мыши.

При обработке свойств объекта Event необходимо учитывать, что в качестве значений свойств localX и localY используются координаты первой точки контакта. Свойства offsetX и offsetY указывают расстояние до точки контакта, в которой завершился жест увеличения.

Примечание. Сведения о совместимости сред см. в описании класса Multitouch.

Объект TransformGestureEvent имеет следующие свойства.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}

Связанные элементы API

Это событие отправляется любой клиентской программе, которая поддерживает линейный ввод с помощью IME.

Отправляется, когда пользователь нажимает клавишу. Соответствие клавиш и конкретных символов варьируется в зависимости от устройства и операционной системы. Этот тип событий создается после возникновения такого соответствия, но перед его обработкой редактором метода ввода IME. Редакторы IME используются для ввода таких символов, как китайские идеограммы, для чего малопригодна стандартная клавиатура QWERTY. Это событие происходит перед событием keyUp.

Отмена этого события в программе AIR предотвращает ввод этого символа в текстовое поле.

Это событие имеет следующие свойства:

Отправляется, когда пользователь пытается изменить фокус с помощью клавиатуры. По умолчанию это событие изменяет фокус и отправляет соответствующие события focusIn и focusOut.

Это событие отправляется объекту, который в данный момент находится в фокусе. Связанным объектом этого события является экземпляр InteractiveObject, попадающий в фокус, если не изменить поведение по умолчанию. Чтобы предотвратить изменение фокуса, можно вызвать метод preventDefault() в прослушивателе событий, соответствующим образом зарегистрированном для целевого объекта. Фокус меняется, и события focusIn и focusOut отправляются по умолчанию.

Это событие имеет следующие свойства:

Отправляется, когда пользователь отпускает клавишу. Соответствие клавиш и конкретных символов варьируется в зависимости от устройства и операционной системы. Этот тип событий создается после возникновения такого соответствия, но перед его обработкой редактором метода ввода IME. Редакторы IME используются для ввода таких символов, как китайские идеограммы, для чего малопригодна стандартная клавиатура QWERTY. Это событие происходит после события keyDown и имеет следующие характеристики:

Это событие имеет следующие свойства:

Отправляется, когда пользователь нажимает и отпускает среднюю кнопку указывающего устройства над одним и тем же объектом InteractiveObject. Чтобы произошло событие middleClick, оно должно следовать за данной последовательностью событий, перечисленных в порядке появления: событие middleMouseDown, затем событие middleMouseUp. Оба эти события должны иметь ту же цель, иначе событие middleClick не произойдет. Между событиями middleMouseDown или middleMouseUp может произойти любое количество других событий мыши; событие middleClick все равно происходит.

Это событие имеет следующие свойства:

Отправляется, когда пользователь нажимает среднюю кнопку указывающего устройства над экземпляром InteractiveObject.

Это событие имеет следующие свойства:

Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject.

Это событие имеет следующие свойства:

Отправляется, когда пользователь нажимает кнопку указывающего устройства над экземпляром InteractiveObject. Если цель — экземпляр SimpleButton, кнопка по умолчанию отображает экранный объект downState. Если цель — выбираемое текстовое поле, то действие по умолчанию — начало выбора текстового поля.

Это событие имеет следующие свойства:

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

Это событие отправляется объекту, который в данный момент находится в фокусе. Связанным объектом этого события является экземпляр InteractiveObject, попадающий в фокус, если не изменить поведение по умолчанию. Чтобы предотвратить изменение фокуса, можно вызвать метод preventDefault() в прослушивателе событий, соответствующим образом зарегистрированном для целевого объекта. Свойство shiftKey не используется. Фокус меняется, и события focusIn и focusOut отправляются по умолчанию.

Это событие имеет следующие свойства:

Отправляется, когда пользователь перемещает указывающее устройство в момент, когда курсор находится над объектом InteractiveObject. Если цель — текстовое поле, которое выбирает пользователь, действие по умолчанию — обновление выбора.

Это событие имеет следующие свойства:

Отправляется, когда пользователь перемещает указатель с экземпляра InteractiveObject. Целью события является объект, на который до этого был наведен указатель. relatedObject — это объект, на который перемещен указатель. Если целью является экземпляр SimpleButton, кнопка по умолчанию отображает экранный объект upState.

Событие mouseOut отправляется каждый раз при перемещении курсора мыши из области дочернего объекта контейнера экранных объектов, даже если был выполнен переход к другому дочернему объекту. Это событие имеет иную цель, в отличие от события rollOut, которое служит для упрощения кодировки поведений ролловера для контейнеров экранных объектов с дочерними элементами. Когда мышь покидает область экранного объекта или его дочерних элементов и переходит к объекту, не являющемуся его дочерним элементом, экранный объект отправляет событие rollOut. События rollOut отправляются последовательно вверх по восходящей цепочке, начиная с объекта и заканчивая объектом верхнего уровня, который не является корнем или предшественником объекта relatedObject.

Это событие имеет следующие свойства:

Отправляется, когда пользователь наводит указывающее устройство на экземпляр InteractiveObject. relatedObject — это объект, на который до этого был наведен указатель. Если цель — экземпляр SimpleButton, объект по умолчанию отображает объект отображения overState или upState в зависимости от того, нажата ли кнопка мыши.

Событие mouseOver отправляется каждый раз при перемещении курсора мыши в область дочернего объекта контейнера объектов отображения, даже при переходе с другого дочернего объекта контейнера объектов отображения. Это событие имеет иную цель, в отличие от события rollOver, которое служит для упрощения кодировки поведений отката для контейнеров объектов отображения с дочерними элементами. Когда мышь переходит в область экранного объекта или его дочерних элементов от объекта, не являющегося дочерним по отношению к данному объекту, экранный объект отправляет событие rollOver. События rollOver отправляются последовательно вниз по родительской цепочке объекта, начиная с элемента самого высокого уровня, не являющегося корневым элементом или предшествующим элементом relatedObject, и заканчивая самим объектом.

Это событие имеет следующие свойства:

Отправляется, когда пользователь отпускает кнопку указывающего устройства над экземпляром InteractiveObject. Если целью является экземпляр SimpleButton, объект отображает экранный объект upState. Если целью является выбираемое текстовое поле, то действие по умолчанию — завершение выбора текстового поля.

Это событие имеет следующие свойства:

Отправляется при прокрутке колеса мыши над экземпляром InteractiveObject. Если цель — текстовое поле, то действие по умолчанию — прокрутка текста. Доступно только в операционных системах Microsoft Windows.

Это событие имеет следующие свойства:

Отправляется инициатором перетаскивания InteractiveObject, когда пользователь завершает жест перетаскивания.

Свойство dropAction события указывает действие, заданное целевым объектом перетаскивания; значение none (DragActions.NONE) указывает на то, что «сброс» перетаскиваемых данных был отменен или не был принят.

С помощью обработчика событий nativeDragComplete можно обновить состояние инициирующего объекта отображения, например удалив элемент из списка (при операции перетаскивания move) или изменив визуальные свойства.

Это событие имеет следующие свойства:

Отправляется целевым объектом InteractiveObject при принятии перетаскиваемого объекта вызовом метода DragManager.acceptDragDrop().

Доступ к перенесенным данным можно получить с помощью свойства clipboard объекта события.

Обработчик этого события должен установить свойство DragManager.dropAction, чтобы сообщить объекту-инициатору о том, какое действие перетаскивания было выполнено. Если значение не задано, DragManager выберет в списке допустимых действий значение по умолчанию.

Это событие имеет следующие свойства: