flash.system.IME (Flex™ 2 레퍼런스 가이드)

Package	flash.system
Class	public final class IME
Inheritance	IME EventDispatcher Object

IME 클래스를 사용하면, 클라이언트 컴퓨터로 실행되고 있는 Flash Player 어플리케이션으로, operating system의 IME 를 직접 조작할 수 있습니다. IME 가 설치(Install) 되고 있는지 어떤지, IME 가 현재 유효하게 되어 있는지 어떤지, 및 어느 IME 가 유효하게 되어 있을까를 조사할 수가 있습니다. Flash Player 어플리케이션으로 IME 를 무효 또는 유효하게 할 수가 있습니다. 또, operating system에 따라서는, 그 외가 한정된 기능을 사용할 수 있습니다.

IME 를 사용하면, 중국어, 일본어, 한국어라고 하는 멀티 바이트의 언어로 ASCII 이외의 캐릭터를 입력할 수 있게 됩니다. IME 의 사용 방법의 상세한 것에 대하여는, 어플리케이션의 개발 대상인 OS 의 메뉴얼을 참조해 주세요. 추가 정보에 대해서는, 다음의 Web 사이트를 참조해 주세요.

IME 가 유저의 컴퓨터로 액티브하지 않는 경우, IME 의 Methods 또는 property의 호출은,Capabilities.hasIME 를 제외해, 실패합니다. IME 를 수동으로 액티브하게 하면, 그 이후의 IME 의 Methods 또는 property의 ActionScript 호출은, 의도했던 대로 동작합니다. 예를 들어, 일본어 IME 를 사용하는 경우, IME 의 Methods 또는 property를 호출하기 전에 액티브하게 할 필요가 있습니다.

다음의 겉(표)에, 이 클래스의 플랫폼별의 대응 상황을 나타냅니다.

기능	Windows	Mac OSX	Mac Classic
IME 가 설치(Install) 되고 있는지 어떤지의 확인 `flash.system.Capabilities.hasIME`	가	가	가
IME 의 온 / 오프 `flash.system.IME.enabled`	가	가	가
IME 의 온 / 오프의 확인 `flash.system.IME.enabled`	가	가	가
IME 변환 모드의 취득 또는 설정 `flash.system.IME.conversionMode`	가	대응 **	불가
변환 대상 string의 IME 에의 송신 `flash.system.IME.setCompositionString()`	대응 *	불가	불가
IME 로부터의 변환전의 string의 취득 `flash.system.System.ime.addEventListener(flash.events.IMEEvent.IME_COMPOSITION, myHandler) flash.system.System.ime.removeEventListener(flash.events.IMEEvent.IME_COMPOSITION, myHandler)`	대응 *	불가	불가
IME 에의 변환 요구의 송신 `flash.system.IME.doConversion()`	대응 *	불가	불가

* 일부의 Windows IME 에서는, 상기중 일부 지원(support)하고 있지 않는 조작이 있습니다. 모든 조작을 지원(support)하고 있는 IME 는, 일본어 IME 뿐입니다.

** Macintosh 의 경우는, 일본어 IME 에서만 이러한 Methods가 지원(support)되고 있어 써드파티제의 IME 에서는 지원(support)되고 있지 않습니다.

See also

IME 클래스

	property	정의
		constructor : Object 특정의 object 인스턴스의 클래스 object 또는 constructor　　 함수에의 참조입니다.	Object
		conversionMode : String [static] 현재의 IME 의 변환 모드.	IME
		enabled : Boolean [static] 시스템 IME 가 유효하게 되어 있든가 (`true`) 무효가 되어 있는지 (`false`)를 나타냅니다.	IME
		prototype : Object [static] 클래스 또는 함수 object의 prototype object에의 참조입니다.	Object

Public Methods

상속된 Public Methods의 비표시

상속된 Public Methods 보기

	Methods		정의
		addEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.	EventDispatcher
		dispatchEvent (event:Event ):Boolean 이벤트를 event 플로우(flow)에 dispatch합니다.	EventDispatcher
		doConversion ():void [static] 현재의 입력 string의 제 1 후보를 선택하도록(듯이) IME 에 지시합니다.	IME
		hasEventListener (type:String ):Boolean EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.	EventDispatcher
		hasOwnProperty (name:String ):Boolean object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.	Object
		isPrototypeOf (theClass:Object ):Boolean Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.	Object
		propertyIsEnumerable (name:String ):Boolean 지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.	Object
		removeEventListener (type:String , listener:Function , useCapture:Boolean = false):void EventDispatcher object로부터 listener를 삭제합니다.	EventDispatcher
		setCompositionString (composition:String ):void [static] IME 에의 입력 string를 설정합니다.	IME
		setPropertyIsEnumerable (name:String , isEnum:Boolean = true):void 루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.	Object
		toString ():String 지정된 object의 string 표현을 돌려줍니다.	Object
		valueOf ():Object 지정된 object의 원시적치를 돌려줍니다.	Object
		willTrigger (type:String ):Boolean 지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.	EventDispatcher

	이벤트	일람	정의
		imeComposition	유저가 IME 입력을 완료해, 독해 string가 사용 가능하게 되었을 때에 dispatch합니다.	IME

property의 상세

conversionMode

property

conversionMode:String [read-write]

현재의 IME 의 변환 모드. 변환 모드를 나타내는, 다음의 IME 모드 string 정수를 지정할 수 있습니다.

ALPHANUMERIC_FULL
ALPHANUMERIC_HALF
CHINESE
JAPANESE_HIRAGANA
JAPANESE_KATAKANA_FULL
JAPANESE_KATAKANA_HALF
KOREAN
UNKNOWN 읽기 전용(read-only)의 값이며, 설정할 수 없습니다.

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

Throws

Error — 설정 시행이 성공하지 않았습니다.

enabled

property

enabled:Boolean [read-write]

시스템 IME 가 유효하게 되어 있든가 (true) 무효가 되어 있는지 (false)를 나타냅니다. IME 가 유효하다라고 나무는 멀티 바이트 입력이 되어, IME 가 무효일 때는 영수입력이 됩니다.

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

Throws

Error — 설정 시행이 성공하지 않았습니다.

See also

IME 클래스

Methods의 상세

doConversion

()

Methods

public static function doConversion():void

현재의 입력 string의 제 1 후보를 선택하도록(듯이) IME 에 지시합니다.

Throws

Error — 호출이 성공하지 않았습니다.

setCompositionString

()

Methods

public static function setCompositionString(composition:String ):void

IME 에의 입력 string를 설정합니다. 이 string가 설정되면, 유저는 IME 후보를 선택하고 나서, 현재 포커스가 있는 텍스트 필드의 결과를 확정할 수 있습니다.

어느 텍스트 필드에도 포커스가 없는 경우, 이 Methods는 실패해, 에러를 슬로우 합니다.

Parameters

composition:String — IME 에 보내는 string.

Throws

Error — 호출이 성공하지 않았습니다.

이벤트의 상세

imeComposition

event

Event object type: flash.events.IMEEvent
IMEEvent.type property = flash.events.IMEEvent.IME_COMPOSITION

유저가 IME 입력을 완료해, 독해 string가 사용 가능하게 되었을 때에 dispatch합니다. IME 는, 통상, 일본어, 중국어, 한국어 등, 표음문자는 아니고 표의 문자를 가지는 언어의 텍스트를 입력하기 위해서 사용됩니다.

imeComposition event object의 type property치를 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

Property	Value
`bubbles`	`false`
`cancelable`	`false` 는, 캔슬하는 디폴트의 동작이 없는 것을 나타냅니다.
`currentTarget`	event listener로 Event object를 액티브하게 처리하고 있는 object입니다.
`target`	IME object입니다.

See also

IME 클래스

Adobe® Flex™ 2 Language Reference		모든 패키지 \| 모든 클래스 \| 언어 엘리먼트 \| 색인 \| 부록 \| 규칙 \| 프레임내에 표시 프레임 없음 버젼
Class IME	property \| Methods \| event