ActionScript 3.0 의 프로그래밍 > Flash Player API > 클라이언트의 시스템 환경 > IME 클래스

IME 클래스

IME 클래스를 사용하면, operating system의 IME (Input Method Editor)를 Flash Player 내에서 조작할 수 있습니다.

ActionScript 로부터, 다음일항을 조사할 수가 있습니다.

텍스트 입력 필드를 특정의 IME 문맥에 관련지을 수가 있습니다. 그것에 의해, 입력 필드간을 포커스가 이동하는데 따라서 IME 의 변환 모드 (히라가나, 전각 숫자, 반각 숫자, 직접 입력등)의 변환이 생깁니다.

IME 를 사용하면, 중국어, 일본어, 한국어라고 하는 멀티 바이트의 언어로 ASCII 이외의 캐릭터를 입력할 수 있게 됩니다.

IME 의 사용 방법의 상세한 것에 대하여는, 어플리케이션의 개발 대상인 operating system의 메뉴얼을 참조해 주세요. 추가 정보에 대해서는, 다음의 Web 사이트를 참조해 주세요.

메모

 

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

부 주제

IME 가 설치(Install) 되고 유효하게 되고 있는지 어떤지의 확인
어느 IME 변환 모드가 현재 유효한가의 판별
IME 변환 모드의 설정
특정의 텍스트 필드에 대한 IME 의 무효화
IME 입력 이벤트가 기다리고

IME 가 설치(Install) 되고 유효하게 되고 있는지 어떤지의 확인

IME 의 메소드 또는 properties 를 호출하기 전에, 반드시 유저의 컴퓨터를 조사해 IME 가 현재 설치(Install) 되고 유효하게 되고 있는지 어떤지를 확인할 필요가 있습니다. 다음의 코드는, 몇개의 메소드를 호출하기 전에, 유저가 IME 를 설치(Install)이 끝난 상태로, 그것이 액티브한지 어떤지를 확인하는 방법을 나타내고 있습니다. 

if (Capabilities.hasIME) {
    if (IME.enabled) {
        trace("IME is installed and enabled. ");
    } else {
        trace("IME is installed but not enabled.Please enable your IME and try again. ");
    }
} else {
    trace("IME is not installed.Please install an IME and try again. ");
}

상기의 코드는, 최초로 Capabilities.hasIME properties 를 사용해, 유저가 IME 를 설치(Install) 되어 있을지 어떨지를 확인합니다. 이 properties 가 true 로 설정되어 있는 경우는, 다음에 IME.enabled properties 를 사용해, 유저의 IME 가 현재 유효하게 되고 있는지 어떤지를 확인합니다.

어느 IME 변환 모드가 현재 유효한가의 판별

복수 언어 어플리케이션을 구축할 때는, 유저가 현재 어느 변환 모드를 액티브하게 하고 있는지를 판별하는 것이 필요한 경우도 있습니다. 다음의 코드는, 유저가 IME 를 설치(Install) 되어 있을지 어떨지, 또, 설치(Install) 되어 있는 경우는, 어느 IME 변환 모드가 현재 액티브한가를 확인하는 방법을 나타내고 있습니다. 

if (Capabilities.hasIME) {
    switch (IME.conversionMode) {
        case IMEConversionMode.ALPHANUMERIC_FULL:
            tf.text = "Current conversion mode is alphanumeric (full-width). ";
            break;
        case IMEConversionMode.ALPHANUMERIC_HALF:
            tf.text = "Current conversion mode is alphanumeric (half-width). ";
            break;
        case IMEConversionMode.CHINESE:
            tf.text = "Current conversion mode is Chinese. ";
            break;
        case IMEConversionMode.JAPANESE_HIRAGANA:
            tf.text = "Current conversion mode is Japananese Hiragana. ";
            break;
        case IMEConversionMode.JAPANESE_KATAKANA_FULL:
            tf.text = "Current conversion mode is Japanese Katakana (full-width). ";
            break;
        case IMEConversionMode.JAPANESE_KATAKANA_HALF:
            tf.text = "Current conversion mode is Japanese Katakana (half-width). ";
            break;
        case IMEConversionMode.KOREAN:
            tf.text = "Current conversion mode is Korean. ";
            break;
        default:
            tf.text = "Current conversion mode is " + IME.conversionMode + ". ";
            break;
    }
} else {
    tf.text = "Please install an IME and try again. ";
}

상기의 코드에서는, 최초로, 유저가 IME 를 설치(Install) 되어 있을지 어떨지를 확인합니다. 다음에, 현재의 IME 가 어느 변환 모드를 사용하고 있는지를 확인하기 위해서,IME.conversionMode properties 를 IMEConversionMode 클래스내의 각각의 정수로 조합합니다.

IME 변환 모드의 설정

유저의 IME 의 변환 모드를 변경할 때는, 코드가 try..catch 블록내에 랩 되고 있는 것을 확인할 필요가 있습니다. 왜냐하면,conversionMode properties 를 사용해 변환 모드를 설정하면, IME 가 변환 모드를 설정할 수 없는 경우에 에러가 슬로우 될 가능성이 있기 때문입니다. 다음의 코드는,IME.conversionMode properties 를 설정할 때의 try..catch 블록의 사용 방법을 나타내고 있습니다. 

var statusText:TextField = new TextField;
statusText.autoSize = TextFieldAutoSize.LEFT;
addChild(statusText);
if (Capabilities.hasIME) {
    try {
        IME.enabled = true;
        IME.conversionMode = IMEConversionMode.KOREAN;
        statusText.text = "Conversion mode is " + IME.conversionMode + ". ";
    } catch (error:Error) {
        statusText.text = "Unable to set conversion mode. \n" + error.message;
    }
}

상기의 코드는, 최초로, 유저에 대해서 스테이터스 메세지를 표시하기 위한 텍스트 필드를 작성합니다. 다음에, 이 코드는, IME 가 설치(Install) 되고 있는 경우, IME 를 유효하게 해 변환 모드를 한국어로 설정합니다. 유저의 컴퓨터에 한국어 IME 가 설치(Install)되어 있지 않은 경우는 Flash Player 에 의해 에러가 슬로우 되어try..catch 블록에 의해 캐치 됩니다. try..catch 블록은, 전에 작성된 텍스트 필드에 에러 메세지를 표시합니다.

특정의 텍스트 필드에 대한 IME 의 무효화

경우에 따라서는, 유저가 캐릭터를 입력하는 동안, 유저의 IME 를 무효로 하는 것이 바람직할 때도 있습니다. 예를 들어, 수치 입력만을 받아들이는 텍스트 필드가 있는 경우, IME 가 기동되어 데이터 입력 조작이 늦어지는 것은 바람직하지는 않습니다.

다음의 예는,FocusEvent.FOCUS_IN 이벤트와 FocusEvent.FOCUS_OUT 이벤트를 기다려 그러한 이벤트에 응해 유저의 IME 를 무효로 하는 방법을 나타내고 있습니다. 

var phoneTxt:TextField = new TextField();
var nameTxt:TextField = new TextField();

phoneTxt.type = TextFieldType.INPUT;
phoneTxt.addEventListener(FocusEvent.FOCUS_IN, focusInHandler);
phoneTxt.addEventListener(FocusEvent.FOCUS_OUT, focusOutHandler);
phoneTxt.restrict = "0-9";
phoneTxt.width = 100;
phoneTxt.height = 18;
phoneTxt.background = true;
phoneTxt.border = true;
addChild(phoneTxt);

nameField.type = TextFieldType.INPUT;
nameField.x = 120;
nameField.width = 100;
nameField.height = 18;
nameField.background = true;
nameField.border = true;
addChild(nameField);

function focusInHandler(event:FocusEvent) :void {
    if (Capabilities.hasIME) {
        IME.enabled = false;
    }
}
function focusOutHandler(event:FocusEvent) :void {
    if (Capabilities.hasIME) {
        IME.enabled = true;
    }
}

이 예는,phoneTxt 와 nameTxt 라고 하는 2 개의 입력 텍스트 필드를 작성한 후, 2 개의 event listener를 phoneTxt 텍스트 필드에 추가합니다. 유저가 phoneTxt 텍스트 필드에 포커스를 설정하면,FocusEvent.FOCUS_IN 이벤트가 송출(Dispatch)되어 IME 는 무효가 됩니다. phoneTxt 텍스트 필드가 포커스를 잃으면,FocusEvent.FOCUS_OUT 이벤트가 송출(Dispatch)되어 IME 가 다시 유효하게 됩니다.

IME 입력 이벤트가 기다리고

IME 입력 이벤트는, 입력 string가 설정 되려고 하고 있을 때 송출(Dispatch)됩니다. 예를 들어, 유저가 IME 를 유효하게 되어 있어, 그것을 액티브하게 해 일본어로 string를 입력하는 경우, 유저가 입력 string를 선택하는 것과 동시에 IMEEvent.IME_COMPOSITION 이벤트가 송출(Dispatch)됩니다. IMEEvent.IME_COMPOSITION 이벤트를 기다리기 위해서(때문에)는, 다음의 예와 같이, System class (flash.system.System.ime.addEventListener(...))의 정적 properties ime 에 event listener를 추가할 필요가 있습니다. 

var inputTxt:TextField;
var outputTxt:TextField;

inputTxt = new TextField();
inputTxt.type = TextFieldType.INPUT;
inputTxt.width = 200;
inputTxt.height = 18;
inputTxt.border = true;
inputTxt.background = true;
addChild(inputTxt);

outputTxt = new TextField();
outputTxt.autoSize = TextFieldAutoSize.LEFT;
outputTxt.y = 20;
addChild(outputTxt);

if (Capabilities.hasIME) {
    IME.enabled = true;
    try {
        IME.conversionMode = IMEConversionMode.JAPANESE_HIRAGANA;
    } catch (error:Error) {
        outputTxt.text = "Unable to change IME. ";
    }
    System.ime.addEventListener(IMEEvent.IME_COMPOSITION, imeCompositionHandler);
} else {
    outputTxt.text = "Please install IME and try again. ";
}

function imeCompositionHandler(event:IMEEvent) :void {
    outputTxt.text = "you typed:" + event.text;
}

상기의 코드는 2 개의 텍스트 필드를 작성해, 표시 리스트에 추가합니다. 최초의 텍스트 필드,inputTxt 는, 유저가 일본어 텍스트를 입력할 수 있는 입력 텍스트 필드입니다. 2 번째의 텍스트 필드,outputTxt 는, 유저에 대한 에러 메세지를 표시하는지, 유저가 inputTxt 텍스트 필드에 입력한 일본어 string를 에코하기 위한 동적 텍스트 필드입니다.