InteractiveObject  - AS3

InteractiveObject 实例的当前辅助功能实现 (AccessibilityImplementation)。

相关 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 事件。InteractiveObject 实例的 mouseEnabled 属性也必须设置为 true，以便对象能够接收 doubleClick 事件。

设置此属性不会调度任何事件。必须使用 addEventListener() 方法为 doubleClick 事件添加事件侦听器。

相关 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 可以接受用户输入时，运行时会显示软键盘。当以编程方式调用设置舞台的 focus 属性或用户交互（如，点击）后，InteractiveObject 实例即可以接受用户输入。如果客户端系统具有可用的硬键盘或者不支持虚拟键盘，则不会显示软键盘。

当显示或关闭软键盘时，InteractiveObject 实例会调度 softKeyboardActivating、softKeyboardActivate 和 softKeyboardDeactivate 事件。

注意：iOS 上的 AIR 应用程序不支持此属性。

相关 API 元素

控制软键盘的外观。

具有软键盘的设备可以自定义键盘的按钮以与所需的输入类型匹配。例如，如果需要数字输入，设备可以使用 SoftKeyboardType.NUMBER 在软键盘上仅显示数字。有效值定义为 SoftKeyboardType 类中的常量：

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

这些值用作提示，帮助设备显示当前操作的最佳键盘。

默认值为 SoftKeyboardType.DEFAULT。

相关 API 元素

定义当显示软键盘时应在屏幕上保留的区域（在 iOS 上不支持）。

如果 InteractiveObject 的 needsSoftKeyboard 属性为 true，则当用户键入时，运行时会根据需要调整显示，以将对象保留在视图中。通常，运行时会使用从 DisplayObject.getBounds() 方法获取的对象边界。您可以通过使用此 softKeyboardInputAreaOfInterest 属性指定不同的区域。

在舞台坐标中指定 softKeyboardInputAreaOfInterest。

注意：在 Android 的横向模式中，不遵循 softKeyboardInputAreaOfInterest。

注意：iOS 不支持 softKeyboardInputAreaOfInterest。

相关 API 元素

指定此对象是否遵循 Tab 键顺序。如果该对象遵循 Tab 键顺序，值为 true；否则值为 false。默认情况下，值为 false，但以下情况除外：

• 对于 SimpleButton 对象，值为 true。
• 对于具有 type = "input" 的 TextField 对象，值为 true。
• 对于具有 buttonMode = true 的 Sprite 对象或 MovieClip 对象，值为 true。

指定 SWF 文件中的对象按 Tab 键顺序排列。默认情况下，tabIndex 属性为 -1，这意味着没有为该对象设置任何 Tab 索引。

如果 SWF 文件中当前显示的任何对象包含 tabIndex 属性，则禁用 Tab 键自动排序，而使用该 SWF 文件中对象的 tabIndex 属性来计算 Tab 键顺序。这个自定义的 Tab 键排序仅包括指定了 tabIndex 属性的对象。

tabIndex 属性可以是非负整数。这些对象按照其 tabIndex 属性按升序进行排序。tabIndex 值为 1 的对象在 tabIndex 值为 2 的对象的前面。不要对多个对象使用相同的 tabIndex 值。

由 tabIndex 属性定义的自定义 Tab 键顺序为平构。这意味着不考虑 SWF 文件中对象的层次结构关系。SWF 文件中具有 tabIndex 属性的所有对象都排入 Tab 键顺序中，而 Tab 键顺序由 tabIndex 值的顺序确定。

注意：要设置 TLFTextField 实例的 Tab 键顺序，请将 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。如果硬键盘可用，或者客户端系统不支持虚拟键盘，则不会显示键盘。

注意：iOS 上的 AIR 应用程序不支持此方法。

相关 API 元素

当用户从文本上下文菜单中选择“清除”（或“删除”）时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField，则此事件的默认行为是删除该文本字段中当前选定的所有文本。

此事件具有以下属性：

注意：TextField 对象不会调度 clear、copy、cut、paste 或 selectAll 事件。TextField 对象的上下文菜单中始终包含“剪切”、“复制”、“粘贴”、“清除”和“全选”命令。您不能从 TextField 对象的上下文菜单中删除这些命令。对于 TextField 对象，选择这些命令（或等效键盘命令）不会生成 clear、copy、cut、paste 或 selectAll 事件。但是，扩展 InteractiveObject 类的其他类，包括使用 Flash 文本引擎 (FTE) 构建的组件，将调度这些事件，以响应诸如键盘快捷键和上下文菜单这样的用户操作。

用户在同一 InteractiveObject 上按下并释放用户指针设备的主按钮时调度。要使单击事件发生，它必须始终在以下顺序的一系列事件后面：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 for Apple TV 上沿触摸面边缘轻击）。有些设备也可能将这种接触解释为多个触摸事件的组合。

具体来说，如果用户用手指触摸一个 InteractiveObject，然后将手指移开，则 InteractiveObject 实例会调度 touchBegin 事件和 touchEnd 事件（也包括其他事件）以及 gestureDirectionalTap 事件，或者，如果当前环境支持，会调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 touchBegin 事件，将在启用触摸功能的设备上运行同一事件处理函数。但是，如果您选择处理 gestureDirectionalTap 事件，您可以设计自己的事件处理函数，以响应启用触摸功能的环境的特定需求，并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为手势事件和触摸事件提供不同的响应。但 flash.ui.Multitouch 类会确定是触发触摸事件还是手势事件。

处理事件对象的属性时，请注意将 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 上移动手指，则 InteractiveObject 实例会调度 mouseOver 事件或 touchOver 事件或 gesturePan 事件，或者，如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 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 上移动手指，则 InteractiveObject 实例除调度 gestureRotate 事件外，还可调度 mouseOver 事件和 click 事件（也包括其他事件），或者，如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 mouseOver 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 gestureRotate 事件，可以设计自己的事件处理函数，以响应启用触摸环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。

处理事件对象的属性时，请注意将 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 上移动手指，然后移动多根手指，则 InteractiveObject 实例除调度 gestureSwipe 事件外，还会调度 rollOver 事件和 rollOut 事件（也包括其他事件），或者，如果当前环境支持，可以调度所有事件。选择处理用户交互的方式。如果您选择处理 rollOver 事件，则将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 gestureSwipe 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。

处理事件对象的属性时，请注意将 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 上移动手指，然后执行辅助点击，则 InteractiveObject 实例会调度 mouseOver 事件和 click 事件（也包括其他事件）以及 gesturePressAndTap 事件，或者如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 mouseOver 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 gesturePressAndTap 事件，您可以设计自己的事件处理函数，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。

处理事件对象的属性时，请注意将 localX 和 localY 属性设置为主要接触点（“推动”）。offsetX 和 offsetY 属性是与辅助接触点（“点击”）之间的距离。

相关 API 元素

当用户在接触点处使用 InteractiveObject 实例执行缩放手势操作时（例如，将两个手指放在屏幕上，然后在配有触摸屏的移动电话或平板电脑上的显示对象上快速分开手指）调度。移开手指是一个常用的缩放手势，但每个设备和操作系统都会有自己表示缩放操作的要求。有些设备也可能将此触摸解释为多个鼠标事件的组合。

具体来说，如果用户在 InteractiveObject 上移动手指，然后将手指移开，则 InteractiveObject 实例除调度 gestureZoom 事件外，还会调度 mouseOver 事件和 click 事件（也包括其他事件），或者，如果当前环境支持，可调度所有事件。选择处理用户交互的方式。使用 flash.ui.Multitouch 类管理触摸事件处理（启用触摸手势事件处理、简单的触摸点事件处理，或禁用触摸事件以仅调度鼠标事件）。如果您选择处理 mouseOver 事件，将在启用触摸的设备和启用鼠标的设备上运行相同的事件处理函数。但是，如果您选择处理 gestureZoom 事件，您可以设计自己的事件处理程序，以响应启用触摸的环境的特定需求并为用户提供更丰富的启用触摸体验。您也可以分别处理这两种事件，为触摸事件和鼠标事件提供不同的响应。

处理事件对象的属性时，请注意将 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 实例，作为默认行为，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”的拖动动作），或通过更改可视属性。

此事件具有以下属性：

在将拖动对象放置到目标上且已通过对 DragManager.acceptDragDrop() 的调用接受该放置操作时，由目标 InteractiveObject 调度。

使用事件对象的 clipboard 属性访问放置的数据。

此事件的处理函数应该设置 DragManager.dropAction 属性以向启动器提供有关采取了哪种拖动动作的反馈。如果未设置任何值，DragManager 将从允许动作的列表中选择一个默认值。

此事件具有以下属性：

当拖动手势进入其边界时由 InteractiveObject 调度。

处理 nativeDragEnter 或 nativeDragOver 事件以允许显示对象成为放置目标。

要确定执行调度的显示对象是否能接受放置，请检查该事件对象的 clipboard 属性中数据的适用性，并检查 allowedActions 属性中允许的拖动动作。

此事件具有以下属性：

当拖动手势离开其边界时由 InteractiveObject 调度。

此事件具有以下属性：

当拖动手势保持在其边界内时，由 InteractiveObject 持续调度。

鼠标只要移动，就会调度 nativeDragOver 事件。在 Windows 和 Mac 中，即使不移动鼠标，每隔一小段时间也会调度这些事件。

处理 nativeDragOver 或 nativeDragEnter 事件以允许显示对象成为放置目标。

要确定执行调度的显示对象是否能接受放置，请检查该事件对象的 clipboard 属性中数据的适用性，并检查 allowedActions 属性中允许的拖动动作。

此事件具有以下属性：

在拖动操作开始时由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。

此事件具有以下属性：

在拖动操作期间由在 DragManager.doDrag() 调用中指定为拖动启动器的 InteractiveObject 调度。

Linux 中不调度 nativeDragUpdate 事件。

此事件具有以下属性：

在用户为粘贴操作激活特定于平台的加速键组合或从文本上下文菜单中选择“粘贴”时调度。将此事件调度到当前具有焦点的对象。如果当前具有焦点的对象是一个 TextField，则此事件的默认行为是将剪贴板的所有内容粘贴到该文本字段的当前插入点，替换文本字段中当前选定的所有文本。

此事件具有以下属性：

注意：TextField 对象不会调度 clear、copy、cut、paste 或 selectAll 事件。TextField 对象的上下文菜单中始终包含“剪切”、“复制”、“粘贴”、“清除”和“全选”命令。您不能从 TextField 对象的上下文菜单中删除这些命令。对于 TextField 对象，选择这些命令（或等效键盘命令）不会生成 clear、copy、cut、paste 或 selectAll 事件。但是，扩展 InteractiveObject 类的其他类，包括使用 Flash 文本引擎 (FTE) 构建的组件，将调度这些事件，以响应诸如键盘快捷键和上下文菜单这样的用户操作。

当用户将活动笔针放低经过屏幕的邻近检测阈值上时调度。

当用户将笔针接近屏幕，在屏幕间移动笔针然后抬高笔针时引发的事件的典型序列为：

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

注意：有关环境兼容性的信息，请参阅 Multitouch 类。

调度的 TouchEvent 对象具有下列属性：

相关 API 元素

当用户将活动笔针抬高放在屏幕的邻近检测阈值上时调度。

当笔针接触屏幕时不调度 proximityEnd 事件。

当用户将笔针接近屏幕，在屏幕间移动笔针然后抬高笔针时引发的事件的典型序列为：

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

注意：有关环境兼容性的信息，请参阅 Multitouch 类。

调度的 TouchEvent 对象具有下列属性：

相关 API 元素

当用户将活动笔针移动到屏幕上但仍保留在邻近检测阈值中时调度。

当用户将笔针接近屏幕，在屏幕间移动笔针然后抬高笔针时引发的事件的典型序列为：

• proximityBegin
• proximityMove
• touchBegin
• touchMove
• touchEnd
• proximityMove
• proximityEnd

注意：有关环境兼容性的信息，请参阅 Multitouch 类。

调度的 TouchEvent 对象具有下列属性：

相关 API 元素

当用户直接将活动笔针从此 InteractiveObject 上移开但仍保留在屏幕的邻近检测阈值中时调度。

注意：有关环境兼容性的信息，请参阅 Multitouch 类。

调度的 TouchEvent 对象具有下列属性：

相关 API 元素

当用户直接将活动笔针移动到此 InteractiveObject 上但仍保留在屏幕的邻近检测阈值中时调度。

注意：有关环境兼容性的信息，请参阅 Multitouch 类。

调度的 TouchEvent 对象具有下列属性：

相关 API 元素

当用户从此 InteractiveObject 及其任一子项中移开而仍保留在屏幕的邻近检测阈值中时调度。

事件目标为先前笔针下的对象或该对象的父级。relatedObject 是已将笔针移动到其上的对象。在该对象的父级链以上连续调度 proximityRollOut 事件，以该对象为开头，并以除 relatedObject 的根或祖代之外的最高级别的父级结束。

proximityRollOut 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当笔针离开显示对象区域（包括何其子级区域）并转到除其子级以外的对象时，显示对象调度 proximityRollOut 事件。这是与 proximityOut 事件行为不同的行为，因为该事件是在每次鼠标离开显示对象容器的任何子对象区域时才会被调度，即使鼠标仍保留在显示对象容器的另一个子对象上也是如此。

注意：有关环境兼容性的信息，请参阅 Multitouch 类。

调度的 TouchEvent 对象具有下列属性：

相关 API 元素

当用户将活动笔针从显示列表中子项的对象树中滑过此 InteractiveObject 时（而仍保留在屏幕的邻近检测阈值中）时调度。

事件目标为笔针下的对象或该对象的父级。relatedObject 是以前在笔针下的对象。proximityRollOver 事件是沿该对象的父级链向下连续调度的，从 relatedObject 的根或祖代之外的最高父级开始，并以该对象结束。

proximityRollOver 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当笔针进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时，该显示对象将调度 proximityRollOver 事件。这种行为与 proximityOver 事件的行为不同，每次鼠标进入显示对象容器的任何子对象区域时都会调度此事件，即使鼠标已在显示对象容器的另一个子对象上也是如此。

注意：有关环境兼容性的信息，请参阅 Multitouch 类。

调度的 TouchEvent 对象具有下列属性：

相关 API 元素

在用户首先在 InteractiveObject 实例上按下按钮，然后将指针设备移离 InteractiveObject 实例，释放指针设备上的按钮时调度。如果目标为 SimpleButton 实例，该对象会显示 upState 显示对象。如果目标为可选文本字段，则作为默认行为，该文本字段会结束选择。

此事件具有以下属性：

当用户在同一 InteractiveObject 上按下并释放用户指针设备的右按钮时调度。要使 rightClick 事件发生，该事件必须始终按照发生顺序跟在以下一系列事件之后：rightMouseDown 事件，然后是 rightMouseUp。这两个事件的目标对象必须相同，否则不会发生 rightClick 事件。在 rightMouseDown 或 rightMouseUp 事件之间可以随时发生任意数量的其他鼠标事件；rightClick 事件仍会发生。

此事件具有以下属性：

当用户在 InteractiveObject 实例上按下指针设备按钮时调度。

此事件具有以下属性：

当用户在 InteractiveObject 实例上释放指针设备按钮时调度。

此事件具有以下属性：

用户将指针设备从 InteractiveObject 实例上移开时调度。事件目标是指先前在指针设备下的对象或该对象的父级。relatedObject 是将指针设备向其移动的对象。在该对象的父级链以上连续调度 rollOut 事件，以该对象为开头，并以除 relatedObject 的根或祖代之外的最高级别的父级结束。

rollOut 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标离开显示对象区域或任何其子级区域并转到除其子级以外的对象时，显示对象调度 rollOut 事件。这是与 mouseOut 事件行为不同的行为，因为该事件是在每次鼠标离开显示对象容器的任何子对象区域时才会被调度，即使鼠标仍保留在显示对象容器的另一个子对象上也是如此。

此事件具有以下属性：

用户将指针设备移动到 InteractiveObject 实例上时调度。事件目标为指针设备下的对象或该对象的父级。relatedObject 是以前在指针设备下的对象。rollOver 事件是沿该对象的父级链向下连续调度的，从 relatedObject 的根或祖代之外的最高父级开始，并以该对象结束。

rollOver 事件的目的是简化带有子级的显示对象容器的移开行为的编码。当鼠标进入某个显示对象区域或者从其子级以外的对象进入任何其子级区域时，该显示对象将调度 rollOver 事件。这种行为与 mouseOver 事件的行为不同，每次鼠标进入显示对象容器的任何子对象区域时都会调度此事件，即使鼠标已在显示对象容器的另一个子对象上也是如此。

此事件具有以下属性：