[3D UI] Dx로 EditBox 만들기

IME 란 입력기 또는 입력 방식 편집기 (Input method Editor, IME)로 한글, 한자 처럼 컴퓨터 자판에 있는 글쇠보다 더 많은 수의 문자(즉, 조합해서 사용해야 하는 문자)를 계산하거나 입력해주는 시스템 소프트웨어이다. 

MS의 IME는 IME함수 및 메시지 인터페이스를 통해 입력과정을 수행하는 DLL이다.

IME를 이용한 한글 입력기

풀 모드상에서 한글 입력을 어떻게 받는지? IME를 어떻게 제어하는지?

기본적으로 WM_CHAR에서 받고, 조합 중인 글자만 IME함수를 사용해서 얻어오면 된다. 그리고 한자키를 누르면 특수 문자 및 한자를 얻어와 화면에 9개를 찍어주면 된다.

윈도우 메시지 조작이 아니기 때문에 메시지 루틴 내의 가공이 필요하다. 

메시지 루틴 내에서 메시지 루틴에 들어가기 전

LRESULT CALLBACK WndProc(HWND hWnd,UINT msg,WPARAM wParam,LPARAM lParam) { if(GetText(hWnd,msg,wParam,lParam) == 0) { return 0; } switch(msg) { // ... } }

이렇게 한 후 imm32.lib를 링크하면 된다.

char strText[_MAX_FNAME]; // 텍스트를 저장하기 위한 변수 char strCombine[10]; // 조합 중인 문자 char strSpecial[_MAX_FNAME]; // 특수 문자를 위한 변수 int nSpecialPos; // 특수 문자의 위치 int nSpecialMax; // 특수 문자의 최대 개수 int GetText(HWND hWnd,UINT msg,WPARAM wParam,LPARAM lParam) { HIMC m_hIMC = NULL; // IME 핸들 switch(msg) { case WM_IME_COMPOSITION: // 글씨 조합중 return 0; case WM_CHAR: // 문자 넘어오기 return 0; case WM_IME_NOTIFY: // 한자 입력 return 0; case WM_KEYDOWN: // 키 다운 return 0; } return 1; }

텍스트를 저장하기 위한 변수에는 글이 들어간다.

조합 중인 문자는 특수문자 혹은 변수등을 위해 쓰인다.

조합중인 문자의 길이는 4byte정도만 있어도 된다.

조합중이라는 메시지는 문자를 조합하는 중이라는 뜻이고 IME 함수를 사용해 조합중인 글씨를 얻어온다.

WM_CHAR는 영어면 그냥 넘어가고, 한글같은 문자이면 한 글자가 완성되면 넘어온다.

아래에 있는 메시지는 한자키를 눌렀을 때 나오는 메시지 이고, 한자키를 눌러서 나온 특수문자 박스의 좌우 이동을 위한 것도 있다.

char strText[_MAX_FNAME]; // 텍스트를 저장하기 위한 변수 char strCombine[10]; // 조합 중인 문자 char strSpecial[_MAX_FNAME]; // 특수 문자를 위한 변수 int nSpecialPos; // 특수 문자의 위치 int nSpecialMax; // 특수 문자의 최대 개수 int GetText(HWND hWnd,UINT msg,WPARAM wParam,LPARAM lParam) { int nLen; HIMC m_hIMC = NULL; // IME 핸들 switch(msg) { case WM_IME_COMPOSITION: // 글씨 조합중 { // 메시지 처리 루틴 m_hIMC = ImmGetContext(hWnd); // IME 핸들을 얻는 것으로 IME 함수를 쓰려면 꼭 얻어야한다. // GCS_RESULTSTR 이란 완성된 문자라는 것 if(lParam & GCS_RESULTSTR) { // ImmGetCompositionString : // 현재 IME에 입력되어 있는 한글코드의 크기 및 내용을 취득한다. if((nLen = ImmGetCompositionString(m_hIMC,GCS_RESULTSTR,NULL,0)) > 0) { // 현재 IME의 스트링 길이를 얻는다. // strCombine에 조합 중인 문자열을 받아낸다. ImmGetCompositionString(m_hIMC,GCS_RESULTSTR,strCombine,nLen); strCombine[nLen] = NULL; // 맨 마지막 NULL처리 strcpy(strText+strlen(strText),strCombine); // 전체 내용 뒤에 보여준 후 // 초기화 memset(strCombine,0,10); // 한 문자가 조합 중에 다음 문자가 들어오면 .. } } // GCS_COMPSTR 이란 조합중인 문자라는 것 else if(lParam & GCS_COMPSTR) { // 조합 중인 문자열의 길이를 얻는다. nLen = ImmGetCompositionString(m_hIMC,GCS_COMPSTR,NULL,0); // strCombine에 조합 중인 문자열을 받아낸다. ImmGetCompositionString(m_hIMC,GCS_COMPSTR,strCombine,nLen); strCombine[nLen] = NULL; // 맨 마지막 NULL처리 // 글씨 찍을 때는 strText + strCombine 해서 보여주면 된다. } // 핸들 반환 ImmReleaseContext(hWnd,m_hIMC); } return 0; case WM_CHAR: // 문자 넘어오기 { /************************************************************************/ /* 일반적인 IME의 동작 일반적으로 핸들을 상속받아 만든 윈도우는 영어입력을 받으면 WM_KEYDOWN 다음에 WM_CHAR메시지가 발생하지만, 한글의 경우 WM_KEYDOWN 다음에 WM_IME_COMPOSITION이 발생하고, 한글이 완성되면 WM_CHAR가 2번 발생하게 된다. 왜 2번이냐면, 한글은 2byte이기 때문에 한번에 전달할 수 없기때문이다. 이 때문에 한글 처리는 글자 단위로 해야한다. */ /************************************************************************/ // 만약 Backspace라면, if(wParam == 8) { // 길이가 0보다 크고, 지울 것이 0보다 작으면이라는 의미 // 본 의도는 완성형에서 앞글자인지 뒷글자인지 알려주는 함수가 있다. if(strlen(strText) > 0) { if(strlen(strText) < 0) { // 글자 하나를 지운다. strText[strlen(strText) - 1] = 0; } // 글자 하나를 지운다. strText[strlen(strText) - 1] = 0; } } else { nLen = strlen(strText); strText[nLen] = wParam & 0xff; // 넘어온 문자를 문자열에 넣기 strText[nLen] = NULL; } } return 0; case WM_IME_NOTIFY: // 한자 입력 { GetCandi(hWnd,wParam,lParam,0); } return 0; case WM_KEYDOWN: // 키 다운 { if(strSpecial[0] == 0) { // 특수 문자 창에 글씨가 없으면, 창이 안열렸으면 break; } if(wParam == VK_PROCESSKEY) { // 프로 세스 키로 들어가는 경우 특수 문자 창이 열렸을 경우 이렇게 들어간다. if((lParam & 0xff0000) == VK_LEFT) // 왼쪽이면 { if(nSpecialPos > 0) { // 0보다 크면 9를 뺀다 nSpecialPos -= 9; } } else if((lParam & 0xff0000) == VK_RIGHT) // 오른쪽이면 { if(nSpecialPos + 9 < nSpecialMax) { nSpecialPos += 9; } GetCandi(hWnd,wParam,lParam,nSpecialPos); break; } } } return 0; } return 1; }

// 화면에 찍는 함수 void PutString(HWND hWnd) { char str[_MAX_FNAME]; memset(str,0,_MAX_FNAME); HDC hdc = GetDC(hWnd); TextOut(hdc,0,60,strSpecial,strlen(strSpecial)); // 특수문자가 있다면 찍어주기 strcpy(str,strText); if(strCombine[0] != 0) { strcpy(str+strlen(strText),strCombine); } strcpy(str+strlen(str),"_"); TextOut(hdc,0,0,str,strlen(str)); ReleaseDC(hWnd,hdc); }

IME 메시지

시스템은 IME 윈도우의 변화나 조립 문자열 등의 변화등 모든 상태 변화에 대헤 IME메시지를 윈도우로 보낸다. 이 메시지를 무시하고, DefWindowProc으로 보낼 경우 응용 프로그램은 완성된 문자에 대해서만 WM_CHAR 메시지를 받게 될 것이다.

한글 조합에 관련된 메시지

- WM_IMG_STARTCOMPOSITION 

IME가 조립 문자열을 만들기 직전에 보낸다. 조립을 시작한다는 단순한 통지일 뿐 전달되는 인자 혹은 리턴 값은 없다.

만약 Custom IME윈도우를 작성할 경우 이 메시지를 커스텀 IME 윈도우에 전달해야 한다.

디폴트 IME 윈도우는 이 메시지를 받았을 때 조립 윈도우를 보여준다. 만약 DefWindowProc으로 보내지 않으면 조립 윈도우는 나타나지 않는다.

즉, 한글입력이 시작됬을 때 발생한다.

- WM_IME_ENDCOMPOSITION

조립이 끝났다는 통지 메시지 이며, 역시 인자, 리턴 값이 없다. 

즉, 한글 입력 도중 다른 문자가 입력되었을 때 발생

- WM_IMG_COMPOSITION 

가장 중요하고 핵심적인 메시지로 조립 상태가 변경될 때마다 보내진다. 조립 중인 상태를 보여주고 싶다면, 이메시지를 처리해야한다.

wParam 에는 조립중인 문자 코드가 전달되는데, 이 코드는 2byte의 DBCS 문자로 조립중인 중간 문자 코드이다.

lParam 에는 조립 상태가 어떻게 변경되었는지, 이 문자를 어떻게 처리해야 하는지를 나타내는 플래그의 집합이다. 

많은 플래그 중 2개의 플래그가 중요하다.

GCS_COMPSTR : 아직 조립중인 문자라는 뜻으로, 한 음절이 완성되지 않았다는 것이다.

GCS_RESULTSTR : 한 음절이 완성됬다는 뜻이다.

lParam을 보면 문자가 완성 됬는지 조립중인지 위 플래그로 알 수 있다.

- WM_IME_SETCONTEXT

응용 프로그램이 활성화 또는 비활성화될 때 보내진다. wParam이 TRUE이면 활성화되었다는 뜻이고, FALSE이면 비활성화 됬다는 뜻이다.

한글 윈도우의 경우 DefWindowProc으로 이 메시지를 보내면된다. 커스텀 IME 윈도우를 생성할 경우 이 메시지를 받았을 때, ImmIsUIMessage 함수를 호출해 조립 윈도우와 후보 윈도우를 보이도록 해야한다.

윈도우가 활성화 될 때 기본 IME의 초기화를 위해서 발생된다. 프로그램 내에서 미완성 글자를 표시한다면 lParam에서 

ISC_SHOWUICOMPOSITIONWINDOW와 ISC_SHOWUIALLCANDIDATEWINDOW를 제거해야 한다. 

- WM_IME_CHAR 

문자 하나가 완성 되었을 때 보내진다. wParam 으로 완성된 문자의 코드가 전달되는데 1byte문자만 전달하는 WM_CHAR와 달리 이 코드는 DBCS일 수가 있다. 유니코드에서는 WM_CHAR와 완전히 동일하다.

완성된 문자를 직접처리하려면 이 메시지를 처리하고, 아니면 DefWindowProc으로 보낸다. 

이 메시지를 무시하면 한글 한 문자에 WM_CHAR메시지를 2번 받는다.

- WM_IME_NOTIFY

IME윈도우가 변경되었다는 통지메시지로 wParam으로 어떤 변경메시지인지가 전달된다. 한/영 입력모드가 변경되었을 때 이메시지가 전달되며, 특정 IME 이벤트에 반응하고자 할 때, 이 메시지를 처리한다.