GestureEvent

패키지	flash.events
클래스	public class GestureEvent
상속	GestureEvent Event Object
하위 클래스	PressAndTapGestureEvent, TransformGestureEvent

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

GestureEvent 클래스를 사용하면 사용자의 복잡한 장치 접촉 이벤트(예: 동시에 손가락 두 개로 터치 스크린을 누르는 경우)를 감지하는 장치에서 다중 터치 이동 이벤트를 처리할 수 있습니다. 사용자는 터치 스크린이 있는 휴대 전화나 타블렛 등의 장치와 상호 작용할 때 일반적으로 손가락이나 포인팅 장치를 스크린에 접촉하여 움직입니다. GestureEvent 및 TransformGestureEvent 클래스를 사용하여 이러한 사용자 상호 작용에 응답하는 응용 프로그램을 개발할 수 있습니다. 이 클래스 또는 관련 TouchEvent 및 TransformGestureEvent 클래스에서 정의된 이벤트 유형을 사용하여 이벤트 리스너를 만듭니다. 그런 다음 이러한 클래스의 속성과 메서드를 사용하여 사용자가 장치와 접촉할 때 응답하는 이벤트 핸들러를 생성합니다.

Multitouch 클래스를 사용하여 현재 환경이 터치 상호 작용을 지원하는지 확인하고 지원하는 경우 터치 상호 작용 지원을 관리합니다.

참고: 객체가 표시 목록에 중첩되는 경우 터치 이벤트는 표시 목록에 표시되는 가장 깊이 중첩된 객체를 대상으로 합니다. 이 객체를 대상 노드라고 합니다. 대상 노드의 조상(표시 목록에 대상 노드가 포함된 객체)이 터치 이벤트 알림을 수신하도록 하려면 유형 매개 변수를 감지할 특정 터치 이벤트로 설정한 상태로 조상 노드에서 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
		target : Object [읽기 전용] 이벤트 대상입니다.	Event
		type : String [읽기 전용] 이벤트 유형입니다.	Event

공용 메서드

상속되는 공용 메서드 숨기기

상속되는 공용 메서드 표시

	메서드		정의 주체
		GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false) 다중 터치 이벤트(예: 동시에 손가락 두 개로 터치 스크린을 누르는 경우)에 대한 정보가 포함된 Event 객체를 만듭니다.	GestureEvent
		clone():Event [재정의] GestureEvent 객체의 복사본을 만들고 각 속성의 값이 원본과 일치하도록 설정합니다.	GestureEvent
		formatToString(className:String, ... arguments):String 사용자 정의 ActionScript 3.0 Event 클래스에서 toString() 메서드를 구현하기 위한 유틸리티 함수입니다.	Event
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isDefaultPrevented():Boolean 이벤트에서 preventDefault() 메서드가 호출되었는지 여부를 확인합니다.	Event
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		preventDefault():void 이벤트의 기본 비헤이비어를 취소할 수 있는 경우, 그 비헤이비어를 취소합니다.	Event
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		stopImmediatePropagation():void 이벤트 흐름에서 현재 노드 및 그 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.	Event
		stopPropagation():void 이벤트 흐름에서 현재 노드의 후속 노드에 있는 모든 이벤트 리스너가 처리되지 않도록 합니다.	Event
		toLocaleString():String 로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.	Object
		toString():String [재정의] GestureEvent 객체의 속성이 모두 포함된 문자열을 반환합니다.	GestureEvent
		updateAfterEvent():void 이벤트 핸들러가 표시 목록을 수정한 경우 동작 이벤트 처리 후 Flash 런타임 표시를 새로 고칩니다.	GestureEvent
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object

공용 상수

상속되는 공용 상수 숨기기

상속되는 공용 상수 표시

	상수		정의 주체
		GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [정적] GESTURE_TWO_FINGER_TAP 동작 이벤트 객체의 type 속성 값을 정의합니다.	GestureEvent

속성 세부 정보

altKey

속성

altKey:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

Alt 키가 활성(true)인지 비활성(false)인지를 나타냅니다. Windows 및 Linux 운영 체제만 지원합니다.

구현
public function get altKey():Boolean
public function set altKey(value:Boolean):void

commandKey

속성

commandKey:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

AIR 2

Command 키가 활성화되었는지 여부를 나타냅니다(Mac만 해당).

Mac OS에서 commandKey 속성 값은 ctrlKey 속성 값과 동일합니다. Windows나 Linux에서는 이 속성이 항상 false입니다.

구현
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void

controlKey

속성

controlKey:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

Mac에서 Control 키가 활성화되었는지 여부 및 Windows 또는 Linux에서 Ctrl 키가 활성화되었는지 여부를 나타냅니다.

구현
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void

ctrlKey

속성

ctrlKey:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

Windows 또는 Linux에서 Ctrl 키가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다. Macintosh에서 Control 키 또는 Command 키가 활성화되었는지 여부를 나타냅니다.

구현
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void

localX

속성

localX:Number

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

포함 Sprite와 관련된 이벤트가 발생한 지점의 수평 좌표입니다.

구현
public function get localX():Number
public function set localX(value:Number):void

localY

속성

localY:Number

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

포함 Sprite와 관련된 이벤트가 발생한 지점의 수직 좌표입니다.

구현
public function get localY():Number
public function set localY(value:Number):void

phase

속성

phase:String

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

터치 동작의 진행률을 나타내는 GesturePhase 클래스의 값입니다. 대부분의 동작에서 값은 begin, update 또는 end입니다. 스와이프 및 두 손가락 두드리기 동작의 경우, 일단 이벤트가 전달되면 단계 값은 항상 all입니다. 이 값을 사용하여 이벤트 핸들러가 복잡한 사용자 상호 작용에 응답하거나, 다중 터치 동작(예: 사용자가 스크린에서 시각적 객체를 접촉한 후 드래그할 때의 확장, 이동 및 "드롭")의 현재 단계에 따라 다른 방식으로 응답하는 시점을 결정합니다.

구현
public function get phase():String
public function set phase(value:String):void

관련 API 요소

flash.events.GesturePhase

shiftKey

속성

shiftKey:Boolean

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2

Shift 키가 활성(true)인지 비활성(false)인지를 나타냅니다.

구현
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void

stageX

속성

stageX:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

전역 스테이지 좌표에서 이벤트가 발생한 지점의 수평 좌표입니다. localX 속성이 설정되면 이 속성이 계산됩니다.

구현
public function get stageX():Number

stageY

속성

stageY:Number [읽기 전용]

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

전역 스테이지 좌표에서 이벤트가 발생한 지점의 수직 좌표입니다. localY 속성이 설정되면 이 속성이 계산됩니다.

구현
public function get stageY():Number

생성자 세부 정보

()

생성자

public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY: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` — 이벤트 유형입니다. 지원되는 값은 `GestureEvent.GESTURE_TWO_FINGER_TAP`입니다.

	`bubbles:Boolean` (default = `true`) — Event 객체가 이벤트 흐름의 버블링 단계에 참여하는지 여부를 결정합니다.

	`cancelable:Boolean` (default = `false`) — Event 객체를 취소할 수 있는지 여부를 결정합니다.

	`phase:String` (default = `null`) — 터치 동작의 진행률을 나타내는 GesturePhase 클래스의 값(begin, update, end, all)입니다.

	`localX:Number` (default = `0`) — 포함 Sprite와 관련된 이벤트가 발생한 지점의 수평 좌표입니다.

	`localY:Number` (default = `0`) — 포함 Sprite와 관련된 이벤트가 발생한 지점의 수직 좌표입니다.

	`ctrlKey:Boolean` (default = `false`) — Windows 또는 Linux에서 Ctrl 키가 활성화되었는지 여부를 나타냅니다. Mac에서 Ctrl 키 또는 Command 키가 활성화되었는지 여부를 나타냅니다.

	`altKey:Boolean` (default = `false`) — Alt 키의 활성화 여부를 나타냅니다(Windows 또는 Linux용).

	`shiftKey:Boolean` (default = `false`) — Shift 키가 활성화되었는지 여부를 나타냅니다.

	`commandKey:Boolean` (default = `false`) — (AIR만 해당) Command 키가 활성화되었는지 여부를 나타냅니다(Mac만 해당). 이 매개 변수는 Adobe AIR에만 사용할 수 있으므로 Flash Player 내용에는 설정하지 마십시오.

	`controlKey:Boolean` (default = `false`) — (AIR만 해당) Control 또는 Ctrl 키가 활성화되었는지 여부를 나타냅니다. 이 매개 변수는 Adobe AIR에만 사용할 수 있으므로 Flash Player 내용에는 설정하지 마십시오.

관련 API 요소

flash.events.GesturePhase

메서드 세부 정보

clone

()

메서드

override public function clone():Event

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

GestureEvent 객체의 복사본을 만들고 각 속성의 값이 원본과 일치하도록 설정합니다.

반환값

Event — 속성 값이 원본과 일치하는 새 GestureEvent 객체입니다.

toString

()

메서드

override public function toString():String

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

GestureEvent 객체의 속성이 모두 포함된 문자열을 반환합니다. 문자열의 형식은 다음과 같습니다.

[GestureEvent type=value bubbles=value cancelable=value ... ]

반환값

String — GestureEvent 객체의 속성이 모두 포함된 문자열입니다.

updateAfterEvent

()

메서드

public function updateAfterEvent():void

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

이벤트 핸들러가 표시 목록을 수정한 경우 동작 이벤트 처리 후 Flash 런타임 표시를 새로 고칩니다.

상수 세부 정보

GESTURE_TWO_FINGER_TAP

상수

public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"

언어 버전:

ActionScript 3.0

런타임 버전:

Flash Player 10.1, AIR 2, Flash Lite 4

GESTURE_TWO_FINGER_TAP 동작 이벤트 객체의 type 속성 값을 정의합니다.

전달된 GestureEvent 객체는 다음과 같은 속성을 가집니다.

속성	값
`altKey`	Alt 키가 활성 상태이면 `true`입니다(Windows 또는 Linux).
`bubbles`	`true`
`cancelable`	`false`. 취소할 기본 비헤이비어가 없습니다.
`commandKey`	(AIR에만 해당) Mac에서 `true`이면 Command 키가 활성 상태이고, `false`이면 비활성 상태입니다. Windows에서는 항상 `false`입니다.
`controlKey`	Ctrl 또는 Control 키가 활성 상태이면 `true`이고 비활성 상태이면 `false`입니다.
`ctrlKey`	Windows 또는 Linux에서 Ctrl 키가 활성 상태이면 `true`입니다. Mac에서 Ctrl 키 또는 Command 키가 활성 상태이면 `true`입니다. 그렇지 않으면 `false`입니다.
`currentTarget`	이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`phase`	이벤트 흐름에서 현재 단계입니다. 두 손가락 두드리기 이벤트의 경우, 일단 이벤트가 전달되면 이 값은 항상 `GesturePhase.ALL` 값에 해당하는 `all`이 됩니다.
`isRelatedObjectInaccessible`	보안 샌드박스 규칙으로 인해 relatedObject 속성이 `null`로 설정된 경우 `true`입니다.
`localX`	포함 Sprite와 관련된 이벤트가 발생한 지점의 수평 좌표입니다.
`localY`	포함 Sprite와 관련된 이벤트가 발생한 지점의 수직 좌표입니다.
`shiftKey`	`true`이면 Shift 키가 활성 상태이고, `false`이면 비활성 상태입니다.
`target`	터칭 장치 아래에 있는 InteractiveObject 인스턴스입니다. `target`은 표시 목록에서 이벤트 리스너를 등록한 객체가 아닐 수도 있습니다. 표시 목록에서 현재 이벤트를 처리 중인 객체에 액세스하려면 `currentTarget` 속성을 사용합니다.

예제 예제 사용 방법

GestureTwoFingerTap.as

다음 예제에서는 GESTURE_TWO_FINGER_TAP 이벤트에 대한 이벤트 처리를 보여 줍니다. 사용자가 두 손가락 두드리기 동작을 수행할 때 mySprite는 회전 작업을 수행하고 myTextField는 두 손가락 두드리기 이벤트의 유일한 단계인 all 단계로 채우기 작업을 수행합니다. TransformGestureEvent 클래스의 다른 동작은 begin, update 및 end 단계를 지원합니다.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onTwoFingerTap(evt:GestureEvent):void {

    evt.target.rotation -= 45;
    myTextField.text = evt.phase; //"all"

}

법적 고지 사항 | 온라인 개인 정보 보호 정책

GestureEvent - AS3

클래스 x

altKey

commandKey

controlKey

ctrlKey

localX

localY

phase

shiftKey

stageX

stageY

GestureEvent

clone

toString

updateAfterEvent

GESTURE_TWO_FINGER_TAP