패키지 | flash.system |
클래스 | public final class IME |
상속 | IME EventDispatcher Object |
언어 버전: | ActionScript 3.0 |
런타임 버전: | AIR 1.0, Flash Player 9 |
AIR 프로파일 지원: 이 기능은 데스크톱 운영 체제에서는 지원되지만 휴대 장치의 경우에는 어떤 유형에서도 지원되지 않습니다. AIR for TV 장치에서도 지원되지 않습니다. IME.isSupported
속성을 사용하여 런타임에 지원을 테스트할 수 있습니다. 여러 프로파일 간 API 지원에 대한 자세한 내용은 AIR 프로파일 지원을 참조하십시오.
사용자는 IME를 통해 한국어, 중국어 및 일본어와 같은 ASCII가 아닌 멀티바이트 언어 텍스트 문자를 입력할 수 있습니다. IME 사용에 대한 자세한 내용은 개발 중인 응용 프로그램이 실행될 운영 체제의 설명서를 참조하십시오. 추가 리소스를 보려면 다음 웹 사이트를 방문하십시오.
- http://www.microsoft.com/globaldev/default.mspx
- http://developer.apple.com/documentation/
- http://java.sun.com
사용자의 컴퓨터에서 IME가 활성화되어 있지 않으면 Capabilities.hasIME
이외의 IME 메서드 또는 속성에 대한 호출이 실패합니다. 이때 IME를 수동으로 활성화시키면 ActionScript에서 이후에 IME 메서드 및 속성을 정상적으로 호출할 수 있습니다. 예를 들어 한국어 IME를 사용하는 경우 IME 메서드 또는 속성을 호출하기 전에 해당 IME를 활성화해야 합니다.
다음 표에서는 이 클래스의 플랫폼 적용 범위를 보여 줍니다.
기능 | Windows | Mac OSX | Linux |
---|---|---|---|
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을 지원하지 않습니다.
속성 | 정의 주체 | ||
---|---|---|---|
constructor : Object
지정된 객체 인스턴스의 클래스 객체 또는 생성자 함수에 대한 참조입니다. | Object | ||
conversionMode : String [정적]
현재 IME의 변환 모드입니다. | IME | ||
enabled : Boolean [정적]
시스템 IME가 활성 상태(true)인지 비활성 상태(false)인지를 나타냅니다. | IME | ||
isSupported : Boolean [정적] [읽기 전용]
현재 플랫폼에서 IME 클래스를 사용할 수 있으면 isSupported 속성이 true로 설정되고, 그렇지 않으면 false로 설정됩니다. | IME |
메서드 | 정의 주체 | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
리스너에서 이벤트 알림을 받을 수 있도록 EventDispatcher 객체에 이벤트 리스너 객체를 등록합니다. | EventDispatcher | ||
[정적]
런타임에서 진행 중인 모든 구성을 중단하도록 합니다. | IME | ||
[정적]
구성 내의 선택 영역이 대화형으로 또는 프로그래밍 방식으로 업데이트된 경우 이 메서드를 호출합니다. | IME | ||
이벤트를 이벤트 흐름으로 전달합니다. | EventDispatcher | ||
[정적]
IME가 현재 구성 문자열에 대한 첫 번째 후보를 선택하게 합니다. | IME | ||
EventDispatcher 객체에 특정 유형의 이벤트에 대한 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher | ||
지정된 속성이 객체에 정의되어 있는지 여부를 나타냅니다. | Object | ||
Object 클래스의 인스턴스가 매개 변수로 지정된 객체의 프로토타입 체인에 있는지 여부를 나타냅니다. | Object | ||
지정된 속성이 존재하고 열거 가능한지 여부를 나타냅니다. | Object | ||
EventDispatcher 객체에서 리스너를 제거합니다. | EventDispatcher | ||
[정적]
IME 구성 문자열을 설정합니다. | IME | ||
루프 작업에서 동적 속성을 사용할 수 있는지 여부를 설정합니다. | Object | ||
로캘별 규칙에 따라 서식이 지정된 이 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 문자열 표현을 반환합니다. | Object | ||
지정된 객체의 프리미티브 값을 반환합니다. | Object | ||
이 EventDispatcher 객체 또는 조상 객체에 지정한 이벤트 유형에 대한 이벤트 리스너가 등록되어 있는지 여부를 확인합니다. | EventDispatcher |
이벤트 | 요약 | 정의 주체 | ||
---|---|---|---|---|
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 얻어 활성화될 때 전달됩니다. | EventDispatcher | |||
[브로드캐스트 이벤트] Flash Player 또는 AIR 응용 프로그램이 운영 체제 포커스를 잃고 비활성화될 때 전달됩니다. | EventDispatcher | |||
사용자가 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_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 | 속성 |
isSupported | 속성 |
compositionAbandoned | () | 메서드 |
public static function compositionAbandoned():void
언어 버전: | ActionScript 3.0 |
런타임 버전: | Flash Player 10.1, AIR 2 |
런타임에서 진행 중인 모든 구성을 중단하도록 합니다. 사용자가 구성 영역의 외부를 클릭하는 경우 또는 포커스가 있는 대화형 객체가 삭제되거나 다시 설정되는 경우 이 메서드를 호출합니다. 런타임은 클라이언트에서 confirmComposition()
을 호출하여 구성을 확인합니다. 또한 런타임은 IME를 다시 설정하여 구성이 중단되었음을 운영 체제에 알립니다.
compositionSelectionChanged | () | 메서드 |
doConversion | () | 메서드 |
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 객체입니다. |
Tue Jun 12 2018, 03:17 PM Z