InteractiveObject  - AS3

이 InteractiveObject 인스턴스에 대한 현재 액세스 가능성 구현(AccessibilityImplementation)입니다.

관련 API 요소

이 객체에 연결된 컨텍스트 메뉴를 지정합니다.

Flash Player에서 실행 중인 내용의 경우 이 속성이 ContextMenu 객체입니다. AIR 런타임에서 ContextMenu 클래스는 NativeMenu 클래스를 확장하지만 Flash Player는 NativeMenu 클래스가 아니라 ContextMenu 클래스만 지원합니다.

참고: 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 속성도 doubleClick 이벤트를 수신하려면 해당 객체에 대해 true로 설정되어야 합니다.

이 속성을 설정할 때 전달되는 이벤트는 없습니다. addEventListener() 메서드를 사용하여 doubleClick 이벤트에 대한 이벤트 리스너를 추가해야 합니다.

관련 API 요소

이 객체에서 포커스 사각형을 표시할지 여부를 지정합니다. true, false 또는 null이라는 세 가지 값 중 하나를 사용할 수 있습니다. true 및 false 값은 예상대로 작동하여 포커스 사각형의 표시 여부를 지정합니다. null 값은 이 객체가 Stage의 stageFocusRect 속성을 사용함을 나타냅니다.

이 객체가 마우스 또는 기타 사용자 입력, 메시지를 수신할지 여부를 지정합니다. 기본값은 true로, 표시 목록에 있는 InteractiveObject 인스턴스가 기본적으로 마우스 이벤트 또는 기타 사용자 입력 이벤트를 수신함을 의미합니다. mouseEnabled를 false로 설정하면 인스턴스가 마우스 이벤트(또는 키보드 이벤트와 같은 기타 사용자 입력 이벤트)를 수신하지 않습니다. 표시 목록에 있는 이 인스턴스의 자식은 영향을 받지 않습니다. 표시 목록에 있는 특정 객체의 모든 자식에 대한 mouseEnabled 비헤이비어를 변경하려면 flash.display.DisplayObjectContainer.mouseChildren을 사용합니다.

이 속성을 설정할 때 전달되는 이벤트는 없습니다. 대화형 기능을 만들려면 addEventListener() 메서드를 사용해야 합니다.

관련 API 요소

이 InteractiveObject 인스턴스가 포커스를 받을 때 가상 키보드(화면의 소프트웨어 키보드)를 표시할지 여부를 지정합니다.

기본적으로 값은 false이고 InteractiveObject 인스턴스가 포커스를 얻으면 소프트 키보드를 표시하지 않습니다. needsSoftKeyboard 속성이 true로 설정되는 경우, InteractiveObject 인스턴스가 사용자 입력을 받을 준비가 되면 런타임이 소프트 키보드를 표시합니다. InteractiveObject 인스턴스는 프로그래밍 호출로 스테이지의 focus 속성 또는 "두드리기" 등의 사용자 상호 작용을 설정한 후에야 사용자 입력을 받을 준비가 됩니다. 클라이언트 시스템에 하드웨어 키보드가 있거나 가상 키보드가 지원되지 않는 경우에는 소프트 키보드가 표시되지 않습니다.

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가 가로 방향에서 무시됩니다.

참고: softKeyboardInputAreaOfInterest는 iOS에서 지원되지 않습니다.

관련 API 요소

이 객체가 탭 순서에 있는지 여부를 지정합니다. 이 객체가 탭 순서에 있으면 값이 true이고, 그렇지 않으면 false입니다. 기본적으로 이 값은 다음 경우를 제외하고 false입니다.

• SimpleButton 객체의 경우 값은 true입니다.
• type = "input"인 TextField 객체의 경우 값은 true입니다.
• buttonMode = true인 Sprite 객체나 MovieClip 객체의 경우 값은 true입니다.

SWF 파일에서 객체의 탭 순서를 지정합니다. tabIndex 속성의 기본값은 -1로, 해당 객체에 대해 설정된 탭 인덱스가 없음을 의미합니다.

SWF 파일에 현재 표시되어 있는 임의의 객체가 tabIndex 속성을 포함하고 있으면 자동 탭 순서는 사용되지 않으며, 해당 SWF 파일에 있는 객체의 tabIndex 속성에서 탭 순서가 계산됩니다. 사용자 정의 탭 순서에는 tabIndex 속성을 가진 객체만 포함됩니다.

tabIndex 속성은 음수가 아닌 정수가 될 수 있습니다. 객체는 tabIndex 속성에 따라 오름차순으로 정렬됩니다. tabIndex 값이 1인 객체가 tabIndex 값이 2인 객체보다 앞에 옵니다. 여러 객체에 대해 같은 tabIndex 값을 사용해서는 안 됩니다.

tabIndex 속성이 정의하는 사용자 정의 탭 순서는 평면적입니다. 즉, SWF 파일에서 객체의 계층 관계가 무시됩니다. SWF 파일에서 tabIndex 속성을 갖는 모든 객체는 탭 순서대로 정렬되며, 이 탭 순서는 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여야 합니다. 하드웨어 키보드가 있거나, 클라이언트 시스템이 가상 키보드를 지원하지 않을 경우 키보드가 표시되지 않습니다.

참고: 이 메서드는 iOS의 AIR 응용 프로그램에서는 지원되지 않습니다.

관련 API 요소

사용자가 텍스트 컨텍스트 메뉴에서 '지우기' 또는 '삭제'를 선택할 때 전달됩니다. 이 이벤트는 현재 포커스가 있는 객체로 전달됩니다. 현재 포커스가 있는 객체가 TextField인 경우 이 이벤트의 기본 비헤이비어는 텍스트 필드에서 현재 선택된 모든 텍스트가 삭제되도록 하는 것입니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

참고: TextField 객체는 clear, copy, cut, paste, selectAll 이벤트를 전달하지 않습니다. TextField 객체의 컨텍스트 메뉴에는 [잘라내기], [복사], [붙여넣기], [지우기], [전체 선택] 명령이 항상 포함됩니다. 이러한 명령은 TextField 객체의 컨텍스트 메뉴에서 제거할 수 없습니다. TextField 객체의 경우 이러한 명령(또는 키보드의 해당 키)을 선택해도 clear, copy, cut, paste, selectAll 이벤트가 생성되지 않습니다. 하지만 FTE(Flash Text Engine)를 사용하여 제작된 구성 요소를 포함하여 InteractiveObject 클래스를 확장하는 다른 클래스는 키보드 단축키 및 컨텍스트 메뉴 등의 사용자 동작에 대한 응답으로 이러한 이벤트를 전달합니다.

사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 기본 버튼을 눌렀다 놓을 때 전달됩니다. 클릭 이벤트는 항상 mouseDown 이벤트와 mouseUp 이벤트가 차례로 발생한 뒤에 발생합니다. 이 두 이벤트에 대한 대상 객체는 동일해야 하며, 그렇지 않으면 click 이벤트가 발생하지 않습니다. 다른 수많은 마우스 이벤트가 mouseDown 또는 mouseUp 이벤트 사이에 언제든지 발생할 수 있으며, 이 때에도 click 이벤트는 여전히 발생합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

사용자 동작이 AIR 응용 프로그램의 이 대화형 객체와 연결된 컨텍스트 메뉴를 트리거할 때 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

관련 API 요소

사용자가 복사 작업에 대해 플랫폼 관련 액셀러레이터 키 조합을 활성화하거나 텍스트 컨텍스트 메뉴에서 '복사'를 선택할 때 전달됩니다. 이 이벤트는 현재 포커스가 있는 객체로 전달됩니다. 현재 포커스가 있는 객체가 TextField인 경우 이 이벤트의 기본 비헤이비어는 텍스트 필드에서 현재 선택된 모든 텍스트가 클립보드로 복사되도록 하는 것입니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

참고: TextField 객체는 clear, copy, cut, paste, selectAll 이벤트를 전달하지 않습니다. TextField 객체의 컨텍스트 메뉴에는 [잘라내기], [복사], [붙여넣기], [지우기], [전체 선택] 명령이 항상 포함됩니다. 이러한 명령은 TextField 객체의 컨텍스트 메뉴에서 제거할 수 없습니다. TextField 객체의 경우 이러한 명령(또는 키보드의 해당 키)을 선택해도 clear, copy, cut, paste, selectAll 이벤트가 생성되지 않습니다. 하지만 FTE(Flash Text Engine)를 사용하여 제작된 구성 요소를 포함하여 InteractiveObject 클래스를 확장하는 다른 클래스는 키보드 단축키 및 컨텍스트 메뉴 등의 사용자 동작에 대한 응답으로 이러한 이벤트를 전달합니다.

사용자가 잘라내기 작업에 대해 플랫폼 관련 액셀러레이터 키 조합을 활성화하거나 텍스트 컨텍스트 메뉴에서 '잘라내기'를 선택할 때 전달됩니다. 이 이벤트는 현재 포커스가 있는 객체로 전달됩니다. 현재 포커스가 있는 객체가 TextField인 경우 이 이벤트의 기본 비헤이비어는 텍스트 필드에서 현재 선택된 모든 텍스트가 클립보드로 잘려지도록 하는 것입니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

참고: TextField 객체는 clear, copy, cut, paste, selectAll 이벤트를 전달하지 않습니다. TextField 객체의 컨텍스트 메뉴에는 [잘라내기], [복사], [붙여넣기], [지우기], [전체 선택] 명령이 항상 포함됩니다. 이러한 명령은 TextField 객체의 컨텍스트 메뉴에서 제거할 수 없습니다. TextField 객체의 경우 이러한 명령(또는 키보드의 해당 키)을 선택해도 clear, copy, cut, paste, selectAll 이벤트가 생성되지 않습니다. 하지만 FTE(Flash Text Engine)를 사용하여 제작된 구성 요소를 포함하여 InteractiveObject 클래스를 확장하는 다른 클래스는 키보드 단축키 및 컨텍스트 메뉴 등의 사용자 동작에 대한 응답으로 이러한 이벤트를 전달합니다.

객체의 doubleClickEnabled 플래그가 true로 설정되어 있는 경우 사용자가 동일한 InteractiveObject 위에서 포인팅 장치의 기본 버튼을 연속으로 빠르게 두 번 눌렀다 놓을 때 전달됩니다. doubleClick 이벤트가 발생할 때는 mouseDown, mouseUp, click, mouseDown, mouseUp으로 이루어지는 일련의 이벤트 뒤에 즉시 발생해야 합니다. 이러한 모든 이벤트는 doubleClick 이벤트와 동일한 대상을 공유해야 합니다. 두 번째 mouseDown 및 mouseUp 이벤트에 의해 표시되는 두 번째 클릭은 click 이벤트가 발생한 뒤 지정된 시간 내에 발생해야 합니다. 허용되는 시간 길이는 운영 체제에 따라 다르며 사용자가 직접 구성할 수도 있습니다. 대상이 선택 가능한 텍스트 필드인 경우 기본 비헤이비어로 포인터 아래의 단어가 선택됩니다. 대상 InteractiveObject에 true로 설정된 doubleClickEnabled 플래그가 없는 경우에는 두 개의 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 인스턴스가 gesturePressAndTap 이벤트 외에도 mouseOver 이벤트와 click 이벤트를 전달하거나, 현재 환경이 지원하는 경우 이 모두를 전달할 수도 있습니다. 사용자 상호 작용을 처리할 방식을 선택합니다. 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 이벤트의 목적과 다른 비헤이비어로, 자식이 있는 표시 객체 컨테이너에 대한 rollover 비헤이비어를 단순화하기 위한 것입니다. 마우스가 표시 객체의 영역이나 자식의 영역을 벗어나 자식의 영역이 아닌 객체로 이동하면 표시 객체가 rollOut 이벤트를 전달합니다. rollOut 이벤트는 객체에서 시작하여 relatedObject의 루트나 조상이 아닌 최상위 부모로 끝나는 객체의 부모 체인으로 연속적으로 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

포인팅 장치를 InteractiveObject 인스턴스 위로 옮길 때 전달됩니다. relatedObject는 이전에 포인팅 장치 아래에 있던 객체입니다. 대상이 SimpleButton 인스턴스인 경우 객체는 마우스 버튼이 눌려져 있는지 여부에 따라 기본 비헤이비어로 overState 또는 upState 표시 객체를 표시합니다.

mouseOver 이벤트는 마우스가 이미 표시 객체 컨테이너의 다른 자식 객체 위에 있는 경우에도 마우스가 표시 객체 컨테이너의 자식 객체의 영역에 진입할 때마다 전달됩니다. 이것은 rollOver 이벤트의 목적과 다른 비헤이비어로, 자식이 있는 표시 객체 컨테이너에 대한 rollout 비헤이비어를 단순화하기 위한 것입니다. 마우스가 표시 객체 영역이나 자식 중 하나가 아닌 객체로부터 자식의 영역으로 진입하면 표시 객체가 rollOver 이벤트를 전달합니다. rollOver 이벤트는 객체의 부모 체인을 내림차순(루트도 relatedObject의 조상이 아닌 최상위 부모로 시작하여 해당 객체로 끝남)으로 하여 연속적으로 전달됩니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

InteractiveObject 인스턴스 위에 포인팅 장치를 놓고 버튼을 놓을 때 전달됩니다. 대상이 SimpleButton 인스턴스인 경우에는 객체가 upState 표시 객체를 표시합니다. 대상이 선택 가능한 텍스트 필드인 경우 텍스트 필드는 기본 비헤비이어로 선택을 종료합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

InteractiveObject 인스턴스 위에 마우스를 놓고 휠을 굴릴 때 전달됩니다. 대상이 텍스트 필드인 경우 텍스트는 기본 비헤비이어로 스크롤됩니다. Microsoft Windows 운영 체제에서만 사용할 수 있습니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

사용자가 드래그 동작을 놓을 때 드래그 시작 객체 InteractiveObject에 의해 전달됩니다.

이벤트의 dropAction 속성은 드래그 대상 객체에 의해 설정된 액션을 나타내며 "none" 값(DragActions.NONE)은 드롭이 취소되었거나 허용되지 않았음을 나타냅니다.

nativeDragComplete 이벤트 핸들러는 목록에서 항목을 제거하거나("move"의 드래그 액션), 시각적 속성을 변경하는 등의 방법으로 시작하는 표시 객체의 상태를 업데이트하기 편리한 지점입니다.

이 이벤트에는 다음과 같은 속성이 있습니다.

드래그한 객체가 이 객체에 드롭되고 드롭이 DragManager.acceptDragDrop()에 대한 호출을 통해 허용될 때 대상 InteractiveObject에 의해 전달됩니다.

이벤트 객체 clipboard 속성을 사용하여 드롭된 데이터에 액세스합니다.

이 이벤트의 핸들러는 DragManager.dropAction 속성을 설정하여 드래그 액션이 수행된 시작 객체에 피드백을 제공해야 합니다. 설정된 값이 없을 경우 DragManager는 허용된 액션 목록에서 기본값을 선택합니다.

이 이벤트에는 다음과 같은 속성이 있습니다.