| 包 | flash.events |
| 类 | public class PressAndTapGestureEvent |
| 继承 | PressAndTapGestureEvent  GestureEvent Event Object |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
相关 API 元素
flash.ui.Multitouch
flash.display.InteractiveObject
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.display.InteractiveObject
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | altKey : Boolean
表示 Alt 键是处于活动状态 (true) 还是非活动状态 (false)。 | GestureEvent | |
| bubbles : Boolean [只读]
表示事件是否为冒泡事件。 | Event | |
| cancelable : Boolean [只读]
表示是否可以阻止与事件相关联的行为。 | Event | |
| commandKey : Boolean
表示是否已激活 Command 键（仅限 Mac）。 | GestureEvent | |
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| controlKey : Boolean
表示在 Mac 中是否已激活 Control 键，以及在 Windows 或 Linux 中是否已激活 Ctrl 键。 | GestureEvent | |
| ctrlKey : Boolean
在 Windows 或 Linux 中，表示 Ctrl 键是处于活动状态 (true) 还是非活动状态 (false)。 | GestureEvent | |
| currentTarget : Object [只读]
当前正在使用某个事件侦听器处理 Event 对象的对象。 | Event | |
| eventPhase : uint [只读]
事件流中的当前阶段。 | Event | |
| localX : Number
事件发生点相对于所属 Sprite 的水平坐标。 | GestureEvent | |
| localY : Number
事件发生点相对于所属 Sprite 的垂直坐标。 | GestureEvent | |
| phase : String
GesturePhase 类中用于表示触摸操作的进度的值。 | GestureEvent | |
| shiftKey : Boolean
表示 Shift 键是处于活动状态 (true) 还是非活动状态 (false)。 | GestureEvent | |
| stageX : Number [只读]
事件发生点在全局舞台坐标中的水平坐标。 | GestureEvent | |
| stageY : Number [只读]
事件发生点在全局舞台坐标中的垂直坐标。 | GestureEvent | |
| tapLocalX : Number
事件发生点相对于所属交互对象的水平坐标。 | PressAndTapGestureEvent | ||
| tapLocalY : Number
事件发生点相对于所属交互对象的垂直坐标。 | PressAndTapGestureEvent | ||
| tapStageX : Number [只读]
发生轻敲触摸的位置在全局舞台坐标系中的水平坐标。 | PressAndTapGestureEvent | ||
| tapStageY : Number [只读]
发生轻敲触摸的位置在全局舞台坐标系中的垂直坐标。 | PressAndTapGestureEvent | ||
| target : Object [只读]
事件目标。 | Event | |
| type : String [只读]
事件的类型。 | Event | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
PressAndTapGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, tapLocalX:Number = 0, tapLocalY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)
创建包含有关复杂多点触控事件（例如用户执行的显示上下文相关弹出菜单的触摸）的信息的 Event 对象。 | PressAndTapGestureEvent | ||
[覆盖]
创建 PressAndTapGestureEvent 对象的副本，并将每个属性的值设置为与原始属性值相匹配。 | PressAndTapGestureEvent | ||
|
用于在自定义 ActionScript 3.0 Event 类中实现 toString() 方法的实用程序函数。 | Event | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
检查是否已对事件调用 preventDefault() 方法。 | Event | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
如果可以取消事件的默认行为，则取消该行为。 | Event | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
设置循环操作动态属性的可用性。 | Object | |
|
防止对事件流中当前节点中和所有后续节点中的事件侦听器进行处理。 | Event | |
|
防止对事件流中当前节点的后续节点中的所有事件侦听器进行处理。 | Event | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
[覆盖]
返回一个字符串，其中包含 PressAndTapGestureEvent 对象的所有属性。 | PressAndTapGestureEvent | ||
|
如果显示列表已由事件处理函数修改，则在处理手势事件后刷新 Flash 运行时显示。 | GestureEvent | |
|
返回指定对象的原始值。 | Object | |
公共常量
| 常量 | 由以下参数定义 | ||
|---|---|---|---|
| GESTURE_PRESS_AND_TAP : String = "gesturePressAndTap" [静态]
定义 GESTURE_PRESS_AND_TAP 触摸事件对象的 type 属性的值。 | PressAndTapGestureEvent | ||
属性详细信息
tapLocalX | 属性 |
tapLocalY | 属性 |
tapStageX | 属性 |
tapStageY | 属性 |
构造函数详细信息
PressAndTapGestureEvent | () | 构造函数 |
public function PressAndTapGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, tapLocalX:Number = 0, tapLocalY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
创建包含有关复杂多点触控事件（例如用户执行的显示上下文相关弹出菜单的触摸）的信息的 Event 对象。将 Event 对象作为参数传递给事件侦听器。
参数type:String — 事件类型：PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP。
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
phase:String (default = null)GesturePhase.BEGIN、GesturePhase.END、GesturePhase.UPDATE 或 GesturePhase.ALL。
| |
localX:Number (default = 0) | |
localY:Number (default = 0) | |
tapLocalX:Number (default = 0) | |
tapLocalY:Number (default = 0) | |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) |
相关 API 元素
方法详细信息
clone | () | 方法 |
toString | () | 方法 |
常量详细信息
GESTURE_PRESS_AND_TAP | 常量 |
public static const GESTURE_PRESS_AND_TAP:String = "gesturePressAndTap"| 语言版本: | ActionScript 3.0 |
| 运行时版本: | Flash Player 10.1, AIR 2, Flash Lite 4 |
定义 GESTURE_PRESS_AND_TAP 触摸事件对象的 type 属性的值。
调度的 PressAndTapGestureEvent 对象具有下列属性：
| 属性 | 值 |
|---|---|
altKey | 如果 Alt 键处于活动状态，则为 true（Windows 或 Linux）。 |
bubbles | true |
cancelable | false；没有要取消的默认行为。 |
commandKey | 在 Mac 中，如果 Command 键处于活动状态，则为 true；如果处于非活动状态，则为 false。在 Windows 中始终为 false。 |
controlKey | 如果 Ctrl 或 Control 键处于活动状态，则为 true，如果处于非活动状态，则为 false。 |
ctrlKey | 在 Windows 或 Linux 中，如果 Ctrl 键处于活动状态，则为 true。在 Mac 中，如果 Ctrl 键或 Command 键处于活动状态，则为 true。否则为 false。 |
currentTarget | 当前正在使用某个事件侦听器处理 Event 对象的对象。 |
eventPhase | 当前阶段作为事件通过对象层次结构；数值表示此事件在目标上 (2) 或冒泡时 (3) 被捕获 (1)。 |
localX | 事件发生点相对于所属的显示对象的水平坐标。 |
localY | 事件发生点相对于所属的显示对象的垂直坐标。 |
phase | 事件流中的当前阶段；GesturePhase 类中的某个值。可能值包括：GesturePhase.BEGIN、GesturePhase.UPDATE、GesturePhase.END 或 GesturePhase.ALL。按住轻敲手势会生成 GesturePhase.BEGIN、GesturePhase.UPDATE、GesturePhase.END 序列，也会生成一个 GesturePhase.ALL 相位。 |
shiftKey | 如果 Shift 键处于活动状态，则为 true；如果处于非活动状态，则为 false。 |
stageX | 事件发生点在全局舞台坐标中的水平坐标。 |
stageY | 事件发生点在全局舞台坐标中的垂直坐标。 |
tapLocalX | 事件发生点相对于所属交互对象的水平坐标。 |
tapLocalY | 事件发生点相对于所属交互对象的垂直坐标。 |
tapStageX | 发生轻敲触摸的位置在全局舞台坐标系中的水平坐标。 |
tapStageY | 发生轻敲触摸的位置在全局舞台坐标系中的垂直坐标。 |
target | 触摸设备下的 InteractiveObject 实例。target 不一定是显示列表中注册此事件侦听器的对象。请使用 currentTarget 属性来访问显示列表中当前正在处理此事件的对象。 |
相关 API 元素
示例 如何使用本示例
GesturePressAndTap.as
以下示例显示针对
GESTURE_PRESS_AND_TAP 事件的事件处理过程。当用户执行按住轻敲手势时，mySprite 旋转，myTextField 填充为当前阶段。
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP , onPressAndTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onPressAndTap(evt:PressAndTapGestureEvent):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";
}
}
Tue Jun 12 2018, 11:04 AM Z