다음을 통해 공유


WM_IME_COMPOSITION 메시지

키 입력의 결과로 IME가 컴퍼지션 상태 변경할 때 애플리케이션으로 전송됩니다. 창은 WindowProc 함수를 통해 이 메시지를 받습니다.

LRESULT CALLBACK WindowProc(
  HWND  hwnd,     
  WM_IME_COMPOSITION,   
  WPARAM wParam,
  LPARAM lParam          
);

매개 변수

hwnd

창에 대한 핸들입니다.

wParam

컴퍼지션 문자열에 대한 최신 변경 사항을 나타내는 DBCS 문자입니다.

lParam

컴퍼지션 문자열 또는 문자가 변경된 방식을 지정하는 값입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다. 이러한 값에 대한 자세한 내용은 IME 컴퍼지션 문자열 값을 참조하세요.

GCS_COMPATTR

GCS_COMPCLAUSE

GCS_COMPREADSTR

GCS_COMPREADATTR

GCS_COMPREADCLAUSE

GCS_COMPSTR

GCS_CURSORPOS

GCS_DELTASTART

GCS_RESULTCLAUSE

GCS_RESULTREADCLAUSE

GCS_RESULTREADSTR

GCS_RESULTSTR

lParam 매개 변수에는 다음 값 중 하나 이상이 있을 수도 있습니다.

의미
CS_INSERTCHAR
현재 삽입 지점에 wParam 컴퍼지션 문자를 삽입합니다. 애플리케이션이 이 메시지를 처리하는 경우 컴퍼지션 문자를 표시해야 합니다.
CS_NOMOVECARET
메시지 처리의 결과로 캐리트 위치를 이동하지 마세요. 예를 들어 IME가 CS_INSERTCHAR 및 CS_NOMOVECARET 조합을 지정하는 경우 애플리케이션은 지정된 문자를 현재 캐리트 위치에 삽입해야 하지만 다음 위치로는 이동해서는 안 됩니다. GCS_RESULTSTR 포함된 후속 WM_IME_COMPOSITION 메시지가 이 문자를 대체합니다.

 

반환 값

이 메시지에는 반환 값이 없습니다.

설명

애플리케이션은 컴퍼지션 문자 자체를 표시하는 경우 이 메시지를 처리해야 합니다. 그렇지 않으면 IME 창으로 메시지를 보내야 합니다.

애플리케이션에서 IME 창을 만든 경우 해당 창에 이 메시지를 전달해야 합니다. DefWindowProc 함수는 이 메시지를 기본 IME 창에 전달하여 처리합니다. IME 창은 지정된 변경 플래그에 따라 모양을 업데이트하여 이 메시지를 처리합니다. 애플리케이션은 ImmGetCompositionString을 호출하여 새 컴퍼지션 상태 검색할 수 있습니다.

GCS_ 값이 설정되지 않은 경우 메시지는 현재 컴퍼지션이 취소되었으며 컴퍼지션 문자열을 그리는 애플리케이션이 문자열을 삭제해야 했음을 나타냅니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
Windows 2000 Server[데스크톱 앱만]
헤더
Winuser.h(Windows.h 포함);
Imm.h(Windows.h 포함)

추가 정보

입력 메서드 관리자

입력 방법 관리자 메시지

ImmGetCompositionString