TouchEvent  - AS3

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

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

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

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

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

첫 번째 접촉 지점이 마우스 이벤트에 매핑되었는지 여부를 나타냅니다.

관련 API 요소

true이면 relatedObject 속성이 보안 샌드박스와 관련된 이유로 인해 null로 설정됩니다. relatedObject 공칭 값이 다른 샌드박스의 DisplayObject에 대한 참조이면 이 보안 샌드박스 경계를 넘어 양쪽 방향에서 권한이 있지 않는 한 relatedObject가 null로 지정됩니다. 권한은 SWF 파일에서 Security.allowDomain()을 호출하거나, 이미지 파일 서버에서 정책 파일을 제공하거나, 이미지를 로드할 때 LoaderContext.checkPolicyFile 속성을 지정하여 설정됩니다.

관련 API 요소

이 터치 입력 시퀀스가 운영 체제에 의해 취소되었다는 것을 보고합니다.

펜 스타일러스가 사용 중이므로 손바닥 터치가 거부되는 경우 등의 다양한 이유로 인해 터치 이벤트가 취소될 수 있습니다. isTouchPointCanceled는 touchEnd 이벤트에서만 true일 수 있습니다.

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

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

장치를 누르는 힘을 나타내는 0.0에서 1.0 사이의 값입니다. 장치가 압력 감지를 지원하지 않는 경우 값은 1.0입니다.

이벤트와 관련된 표시 목록 객체에 대한 참조입니다. 예를 들어 touchOut 이벤트가 발생하면 relatedObject는 포인팅 장치가 현재 가리키는 표시 목록 객체를 나타냅니다. 이 속성은 touchOut, touchOver, touchRollOut, touchRollOver 이벤트에 적용됩니다.

관련 객체가 없거나, 관련 객체가 있지만 액세스 권한이 없는 보안 샌드박스 내에 있는 경우 이 속성 값은 null일 수 있습니다. isRelatedObjectInaccessible() 속성을 사용하여 이러한 이유 중 어느 것이 해당하는지 확인할 수 있습니다.

관련 API 요소

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

접촉 영역의 폭입니다.

접촉 영역의 높이입니다.

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

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

이벤트 시간을 상대적인 밀리초로 보고합니다.

보고된 시간은 응용 프로그램 실행이 시작된 시간을 기준으로 합니다. 샘플 버퍼에 있는 일련의 포인트를 반환하는 이벤트의 경우 이 타임스탬프는 버퍼에 있는 마지막 샘플의 경과 시간을 반영합니다.

관련 API 요소

터치가 스타일러스의 주 말단에서 생성되었는지 아니면 지우개에서 생성되었는지를 보고합니다.

터치 이벤트가 손가락이나 스타일러스가 아닌 다른 입력 방법으로 발생했거나 빈도가 높은 모션 추적이 지원되지 않은 스타일러스로 인해 발생한 경우 이 속성은 TouchEventIntent.UNKNOWN 값을 보고합니다.

TouchEventIntent 클래스는 다음을 포함하여 이 속성에 사용할 수 있는 값에 대한 상수를 정의합니다.

• TouchEventIntent.ERASER
• TouchEventIntent.PEN
• TouchEventIntent.UNKNOWN

관련 API 요소

터치 지점에 지정된 고유한 ID 번호(정수)입니다.

Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; 

var mySprite:Sprite = new Sprite(); 
mySprite.graphics.beginFill(0x336699); 
mySprite.graphics.drawRect(0,0,40,40); 
addChild(mySprite); 

var myTextField:TextField = new TextField(); 
addChild(myTextField); 
myTextField.width = 200; 
myTextField.height = 20; 

var touchMoveID:int = 0; 
 
mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); 
function onTouchBegin(event:TouchEvent) { 
    if(touchMoveID != 0) { 
        myTextField.text = "already moving. ignoring new touch";     
        return; 
    } 
    touchMoveID = event.touchPointID; 
 
    myTextField.text = "touch begin" + event.touchPointID; 
    stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); 
    stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); 
} 
function onTouchMove(event:TouchEvent) { 
    if(event.touchPointID != touchMoveID) { 
        myTextField.text = "ignoring unrelated touch"; 
        return; 
    } 
    mySprite.x = event.stageX; 
    mySprite.y = event.stageY; 
    myTextField.text = "touch move" + event.touchPointID; 
} 
function onTouchEnd(event:TouchEvent) { 
    if(event.touchPointID != touchMoveID) { 
        myTextField.text = "ignoring unrelated touch end"; 
        return; 
    } 
    touchMoveID = 0; 
    stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); 
    stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd); 
    myTextField.text = "touch end" + event.touchPointID; 
}

터치 이벤트에 대한 정보가 포함된 Event 객체를 만듭니다. Event 객체는 매개 변수로 이벤트 리스너에 전달됩니다.

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

지정된 ByteArray 객체를 다중 포인트 터치 이벤트에 대한 높은 빈도의 데이터 포인트로 업데이트합니다.

buffer 매개 변수가 참조하는 ByteArray 객체는 이 터치 이벤트 및 이전 터치 이벤트 간의 중간 데이터 포인트에 대한 값으로 업데이트됩니다. 각 샘플에 대한 세 개의 부동 소수점 값인 x 좌표, y 좌표 및 압력 값이 추가됩니다. 스테이지 좌표로 보고된 위치 값입니다. 압력은 0과 1 사이의 값으로 보고됩니다. 샘플은 정기적인 시간 간격으로 기록됩니다. 정확한 빈도는 장치 하드웨어 및 하드웨어 드라이버에 따라 다릅니다. 일반적인 샘플 빈도는 약 133Hz입니다. 터치 이벤트는 정확한 간격으로 전달되지 않습니다. 따라서 비슷한 이벤트에 대한 버퍼에 다른 수의 샘플이 포함될 수 있습니다. 버퍼의 마지막 샘플은 이 터치 이벤트 객체의 stageX, stageY 및 pressure 속성과 동일한 데이터를 가집니다.

샘플 버퍼는 proximityMove 및 touchMove 이벤트에 대해 전달된 이벤트 객체에 포함됩니다.

매개 변수

관련 API 요소

function touchMoveHandler( event:TouchEvent ):void
{
    if( (event.type == TouchEvent.TOUCH_MOVE ||
        event.type == TouchEvent.PROXIMITY_MOVE) &&
        event.touchEventIntent != TouchEventIntent.UNKNOWN )
    {
        var samples:ByteArray = new ByteArray();
        event.getSamples( samples, true );
        samples.position = 0;     // rewind to beginning of array before reading
        
        var xCoord:Number, yCoord:Number, pressure:Number;
        
        while( samples.bytesAvailable > 0 )
        {
            xCoord = samples.readFloat();
            yCoord = samples.readFloat();
            pressure = samples.readFloat();
            //do something with the sample data
        }
    }
}

var samples:ByteArray = new ByteArray();

function touchMoveHandler( event:TouchEvent ):void
{
    if( (event.type == TouchEvent.TOUCH_MOVE ||
        event.type == TouchEvent.PROXIMITY_MOVE) &&
        event.touchEventIntent != TouchEventIntent.UNKNOWN )
    {
        var sampleCount:uint = event.getSamples( samples, true );         
        var xCoord:Number, yCoord:Number, pressure:Number;
        
        for( var i:int; i < sampleCount; i++ )
        {
            xCoord = samples.readFloat();
            yCoord = samples.readFloat();
            pressure = samples.readFloat();
            //do something with the sample data
        }
    }
}

지정된 인덱스의 하드웨어 버튼을 눌렀다는 것을 보고합니다.

매개 변수

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

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

표시 목록이 수정된 경우, 이 이벤트의 처리가 완료된 뒤 렌더링하도록 Flash Player 또는 Adobe AIR에 지시합니다.

PROXIMITY_BEGIN 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

PROXIMITY_END 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

PROXIMITY_MOVE 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

PROXIMITY_OUT 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

PROXIMITY_OVER 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

PROXIMITY_ROLL_OUT 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

PROXIMITY_ROLL_OVER 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_BEGIN 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_END 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_MOVE 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_OUT 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_OVER 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_ROLL_OUT 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_ROLL_OVER 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

TOUCH_TAP 터치 이벤트 객체의 type 속성 값을 정의합니다.

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

관련 API 요소

Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;

var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();

mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);

mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);

function taphandler(e:TouchEvent): void {
    myTextField.text = "I've been tapped";
    myTextField.y = 50;
    addChild(myTextField);
}