Adobe® Flash® Platform용 ActionScript® 3.0 참조 설명서
홈  |  패키지 및 클래스 목록 숨기기 |  패키지  |  클래스  |  새로운 내용  |  색인  |  부록  |  영어로 표시되는 이유
필터: 서버에서 데이터를 검색하는 중...
서버에서 데이터를 검색하는 중...
flash.system 

IME  - AS3

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

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

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

AIR 프로파일 지원: 이 기능은 데스크톱 운영 체제에서는 지원되지만 휴대 장치의 경우에는 어떤 유형에서도 지원되지 않습니다. AIR for TV 장치에서도 지원되지 않습니다. IME.isSupported 속성을 사용하여 런타임에 지원을 테스트할 수 있습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.

사용자는 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을 지원하지 않습니다.


공용 속성
 속성정의 주체
 Inheritedconstructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다.
Object
  conversionMode : String
[정적] 현재 IME의 변환 모드입니다.
IME
  enabled : Boolean
[정적] 시스템 IME가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다.
IME
  isSupported : Boolean
[정적] [읽기 전용] 현재 플랫폼에서 IME 클래스를 사용할 수 있으면 isSupported 속성이 true로 설정되고, 그렇지 않으면 false로 설정됩니다.
IME
공용 메서드
 메서드정의 주체
 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
toLocaleString():String
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다.
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 모드 문자열 상수입니다.

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



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

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

관련 API 요소

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

enabled

속성 
enabled:Boolean

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

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



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

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

isSupported

속성 
isSupported:Boolean  [읽기 전용]

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10.1, AIR 2

현재 플랫폼에서 IME 클래스를 사용할 수 있으면 isSupported 속성이 true로 설정되고, 그렇지 않으면 false로 설정됩니다.



구현
    public static function get isSupported():Boolean
메서드 세부 정보

compositionAbandoned

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

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10.1, AIR 2

런타임에서 진행 중인 모든 구성을 중단하도록 합니다. 사용자가 구성 영역의 외부를 클릭하는 경우 또는 포커스가 있는 대화형 객체가 삭제되거나 다시 설정되는 경우 이 메서드를 호출합니다. 런타임은 클라이언트에서 confirmComposition()을 호출하여 구성을 확인합니다. 또한 런타임은 IME를 다시 설정하여 구성이 중단되었음을 운영 체제에 알립니다.

compositionSelectionChanged

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

언어 버전: ActionScript 3.0
런타임 버전: Flash Player 10.1, AIR 2

구성 내의 선택 영역이 대화형으로 또는 프로그래밍 방식으로 업데이트된 경우 이 메서드를 호출합니다.

매개 변수

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 속성 값을 정의합니다.

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

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



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 03:17 PM Z
 

 

법적 고지 사항 | 온라인 개인 정보 보호 정책
[ X ]영어로 표시되는 이유
ActionScript 3.0 참조 설명서의 내용이 영어로 나타납니다.

ActionScript 3.0 참조 설명서 중 일부는 전체 언어로 번역되지 않았습니다. 언어 요소가 번역되지 않은 경우 영어로 나타납니다. 예를 들어 ga.controls.HelpBox 클래스는 어떤 언어로도 번역되지 않았습니다. 그러므로 한국어 버전의 참조 설명서에서 ga.controls.HelpBox 클래스는 영어로 나타납니다.