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

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 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를 활성화해야 합니다.

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

기능WindowsMac OSXLinux
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을 지원하지 않습니다.

참고 사항

Using the IME class

Public 속성
 속성다음에 의해 정의됨
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  conversionMode : String
[정적] 현재 IME의 변환 모드입니다.
IME
  enabled : Boolean
[정적] 시스템 IME가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.
IME
 Inheritedprototype : Object
[정적] 클래스 또는 함수 객체의 프로토타입 객체에 대한 참조입니다.
Object
Public 메서드
 메서드다음에 의해 정의됨
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다.
EventDispatcher
  
compositionAbandoned():void
[정적]
IME
  
compositionSelectionChanged(start:int, end:int):void
[정적]
IME
 Inherited
dispatchEvent(event:Event):Boolean
이벤트를 이벤트 흐름으로 전달합니다.
EventDispatcher
  
doConversion():void
[정적] IME가 현재 구성 문자열에 대한 첫 번째 후보를 선택하게 합니다.
IME
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다.
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다.
Object
 Inherited
propertyIsEnumerable(name:String):Boolean
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher 객체에서 리스너를 제거합니다.
EventDispatcher
  
setCompositionString(composition:String):void
[정적] IME 구성 문자열을 설정합니다.
IME
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다.
Object
 Inherited
toString():String
지정된 객체의 문자열 표현을 반환합니다.
Object
 Inherited
valueOf():Object
지정된 객체의 프리미티브 값을 반환합니다.
Object
 Inherited
willTrigger(type:String):Boolean
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다.
EventDispatcher
이벤트
 이벤트 요약 다음에 의해 정의됨
 Inherited
activate
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다.EventDispatcher
 Inherited
deactivate
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다.EventDispatcher
  
imeComposition
사용자가 IME 구성을 완료하여 문자열을 읽을 수 있을 때 전달됩니다.IME
속성 정보
conversionMode속성
conversionMode:String  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

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



구현
    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
Using the IME class
enabled속성 
enabled:Boolean  [읽기/쓰기]

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

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



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

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

참고 사항

Using the IME class
메서드 정보
compositionAbandoned()메서드
public static function compositionAbandoned():void

compositionSelectionChanged()메서드 
public static function compositionSelectionChanged(start:int, end:int):void

매개 변수

start:int
 
end:int

doConversion()메서드 
public static function doConversion():void

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

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


오류
Error — 호출에 실패했습니다.
setCompositionString()메서드 
public static function setCompositionString(composition:String):void

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

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

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

매개 변수

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


오류
Error — 호출에 실패했습니다.
이벤트 정보
imeComposition 이벤트
이벤트 객체 유형: flash.events.IMEEvent
속성 IMEEvent.type = flash.events.IMEEvent.IME_COMPOSITION

언어 버전: ActionScript 3.0
런타임 버전: AIR 1.0 Flash Player 9

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

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

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

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

참고 사항

Using the IME class



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 02:16 AM -08:00