flash.system.IME (ActionScript 3.0)

패키지	flash.system
클래스	public final class IME
상속	IME EventDispatcher Object

언어 버전 :

ActionScript 3.0

Player 버전 :

Flash Player 9

IME 클래스를 사용하면 클라이언트 컴퓨터에서 실행되는 Flash Player 응용 프로그램에서 운영 체제의 IME(Input Method Editor)를 직접 조작할 수 있습니다. IME가 설치되어 있는지 여부, IME가 현재 활성화되어 있는지 여부 및 활성화된 IME를 확인할 수 있습니다. Flash Player 응용 프로그램에서 IME를 활성화 또는 비활성화할 수 있으며 운영 체제에 따라 다른 제한된 기능을 수행할 수 있습니다.

사용자는 IME를 통해 한국어, 중국어 및 일본어와 같은 ASCII가 아닌 멀티바이트 언어 텍스트 문자를 입력할 수 있습니다. IME 사용에 대한 자세한 내용은 개발 중인 응용 프로그램이 실행될 운영 체제의 설명서를 참조하십시오. 추가 리소스를 보려면 다음 웹 사이트를 방문하십시오.

사용자의 컴퓨터에서 IME가 활성화되어 있지 않으면 Capabilities.hasIME 이외의 IME 메서드 또는 속성에 대한 호출이 실패합니다. 이때 IME를 수동으로 활성화시키면 ActionScript에서 이후에 IME 메서드 및 속성을 정상적으로 호출할 수 있습니다. 예를 들어, 한국어 IME를 사용하는 경우 IME 메서드 또는 속성을 호출하기 전에 해당 IME를 활성화해야 합니다.

다음 표에서는 이 클래스의 플랫폼 적용 범위를 보여 줍니다.

기능	Windows	Mac OSX
IME 설치 여부 확인: `Capabilities.hasIME`	예	예
IME 설정/해제: `IME.enabled`	예	예
IME 설정/해제 확인: `IME.enabled`	예	예
IME 변환 모드 가져오기/설정: `IME.conversionMode`	예	있음 **
IME에 변환할 문자열 전송: `IME.setCompositionString()`	있음 *	아니오
변환 전에 IME에서 원래 문자열 가져오기: `System.ime.addEventListener()`	있음 *	아니오
IME로 변환 요청 보내기: `IME.doConversion()`	있음 *	아니오

* 모든 Windows IME에서 이러한 기능을 모두 지원하지는 않습니다. 이러한 기능을 모두 지원하는 IME는 일본어 IME뿐입니다.

** Macintosh에서 이러한 메서드는 일본어 IME에서만 지원되며 타사 IME에서는 지원되지 않습니다.

이 클래스의 ActionScript 3.0 버전에서는 Macintosh Classic을 지원하지 않습니다.

참고 사항

IME 클래스 사용

	속성	다음에 의해 정의됨
		constructor : Object 지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.	Object
		conversionMode : String [static] 현재 IME의 변환 모드입니다.	IME
		enabled : Boolean [static] 시스템 IME가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.	IME
		prototype : Object [static] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.	Object

Public 메서드

상속되는 Public 메서드 숨기기

상속되는 Public 메서드 표시

	메서드		다음에 의해 정의됨
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.	EventDispatcher
		dispatchEvent(event:Event):Boolean 이벤트를 이벤트 흐름으로 전달합니다.	EventDispatcher
		doConversion():void [static] IME가 현재 구성 문자열에 대한 첫 번째 후보를 선택하게 합니다.	IME
		hasEventListener(type:String):Boolean EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher
		hasOwnProperty(name:String):Boolean 지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.	Object
		isPrototypeOf(theClass:Object):Boolean Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.	Object
		propertyIsEnumerable(name:String):Boolean 지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher 객체에서 리스너를 제거합니다.	EventDispatcher
		setCompositionString(composition:String):void [static] IME 구성 문자열을 설정합니다.	IME
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.	Object
		toString():String 지정된 객체의 문자열 표현을 반환합니다.	Object
		valueOf():Object 지정된 객체의 프리미티브 값을 반환합니다.	Object
		willTrigger(type:String):Boolean 이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.	EventDispatcher

요약	다음에 의해 정의됨
activate	Flash Player가 운영 체제에서 포커스를 얻어 활성화될 때 전달됩니다.	EventDispatcher
deactivate	Flash Player가 운영 체제에서 포커스를 잃고 비활성화될 때 전달됩니다.	EventDispatcher
imeComposition	사용자가 IME 구성을 완료하여 문자열을 읽을 수 있을 때 전달됩니다.	IME

속성 정보

conversionMode

속성

conversionMode:String [read-write]

언어 버전 :

ActionScript 3.0

Player 버전 :

Flash Player 9

현재 IME의 변환 모드입니다. 사용 가능한 값은 변환 모드를 나타내는 다음과 같은 IME 모드 문자열 상수입니다.

ALPHANUMERIC_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN(설정할 수 없는 읽기 전용 값)

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

오류

Error — 설정 시도에 실패했습니다.

참고 사항

flash.system.IMEConversionMode.ALPHANUMERIC_FULL
flash.system.IMEConversionMode.ALPHANUMERIC_HALF
flash.system.IMEConversionMode.CHINESE
flash.system.IMEConversionMode.JAPANESE_HIRAGANA
flash.system.IMEConversionMode.JAPANESE_KATAKANA_FULL
flash.system.IMEConversionMode.JAPANESE_KATAKANA_HALF
flash.system.IMEConversionMode.KOREAN
flash.system.IMEConversionMode.UNKNOWN
IME 클래스 사용

enabled

속성

enabled:Boolean [read-write]

언어 버전 :

ActionScript 3.0

Player 버전 :

Flash Player 9

시스템 IME의 활성화 여부를 true 또는 false로 나타냅니다. IME를 활성화하면 멀티바이트를 입력할 수 있고, 비활성화하면 영숫자를 입력할 수 있습니다.

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

오류

Error — 설정 시도에 실패했습니다.

참고 사항

IME 클래스 사용

메서드 정보

doConversion

()

메서드

public static function doConversion():void

언어 버전 :

ActionScript 3.0

Player 버전 :

Flash Player 9

IME가 현재 구성 문자열에 대한 첫 번째 후보를 선택하게 합니다.

오류

Error — 호출에 실패했습니다.

setCompositionString

()

메서드

public static function setCompositionString(composition:String):void

언어 버전 :

ActionScript 3.0

Player 버전 :

Flash Player 9

IME 구성 문자열을 설정합니다. 이 문자열을 설정할 때 현재 포커스가 있는 텍스트 필드에 대한 결과를 수행하기 전에 IME 후보를 선택할 수 있습니다.

포커스를 가진 텍스트 필드가 없으면 메서드가 실패하고 오류가 발생합니다.

매개 변수

composition:String — IME에 보낼 문자열입니다.

오류

Error — 호출에 실패했습니다.

이벤트 정보

imeComposition

이벤트

이벤트 객체 유형: flash.events.IMEEvent
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

언어 버전 :

ActionScript 3.0

Player 버전 :

Flash Player 9

사용자가 IME 구성을 완료하여 문자열을 읽을 수 있을 때 전달됩니다. IME는 일반적으로 한국어, 중국어 및 일본어 등 동아시아권 언어의 텍스트를 입력하는 데 사용됩니다.

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

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

속성	값
`bubbles`	`false`
`cancelable`	`false`; 취소할 기본 비헤이비어가 없습니다.
`currentTarget`	현재 이벤트 리스너를 통해 Event 객체를 처리하고 있는 객체입니다.
`target`	IME 객체입니다.

참고 사항

IME 클래스 사용

현재 페이지: http://livedocs.adobe.com/flash/9.0_kr/ActionScriptLangRefV3/flash/system/IME.html

ActionScript 3.0 언어 및 구성 요소 참조 설명서		모든 패키지 \| 모든 클래스 \| 언어 요소 \| 색인 \| 부록 \| 규칙 \| 프레임 비프레임
IME	속성 \| 메서드 \| 이벤트