ImmGetProperty 함수(imm.h)

지정된 입력 로캘과 연결된 IME의 속성 및 기능을 검색합니다.

구문

DWORD ImmGetProperty(
       HKL   unnamedParam1,
       DWORD unnamedParam2
);

unnamedParam1

unnamedParam2

dwIndex 매개 변수의 값에 따라 속성 또는 기능 값을 반환합니다. dwIndex가 IGP_PROPERTY 설정된 경우 함수는 다음 값 중 하나 이상을 반환합니다.

값	의미
IME_PROP_AT_CARET	설정한 경우 변환 창이 캐럿 위치에 있습니다. 지우면 창이 케어 위치 근처에 있습니다.
IME_PROP_SPECIAL_UI	설정된 경우 IME에는 비표준 사용자 인터페이스가 있습니다. 애플리케이션은 IME 창에 그려서는 안 됩니다.
IME_PROP_CANDLIST_START_FROM_1	설정한 경우 후보 목록의 문자열은 1부터 시작하여 번호가 매겨집니다. 지우면 문자열이 0에서 시작됩니다.
IME_PROP_UNICODE	설정된 경우 IME는 유니코드 IME로 표시됩니다. 운영 체제와 IME는 유니코드 IME 인터페이스를 통해 통신합니다. 명확한 경우 IME는 ANSI 인터페이스를 사용하여 운영 체제와 통신합니다.
IME_PROP_COMPLETE_ON_UNSELECT	설정되면 IME가 비활성화될 때 IME가 컴퍼지션 문자열을 완료합니다. 지우면 IME가 비활성화될 때(예: 키보드 레이아웃 변경에서) 컴퍼지션 문자열이 취소됩니다.
IME_PROP_ACCEPT_WIDE_VKEY	설정한 경우 IME는 VK_PACKET을 사용하여 SendInput 함수에서 가져온 삽입된 유니코드를 처리합니다. 지우면 IME가 삽입된 유니코드를 처리하지 않을 수 있으며 삽입된 유니코드를 애플리케이션에 직접 보낼 수 있습니다.

dwIndex가 IGP_UI 설정된 경우 함수는 다음 값 중 하나 이상을 반환합니다.

값	의미
UI_CAP_2700	텍스트 이스케이프 값 0 또는 2700을 지원합니다. 자세한 내용은 LOGFONT 구조체의 lfEscapement 멤버를 참조하세요.
UI_CAP_ROT90	텍스트 이스케이프 값 0, 900, 1800 또는 2700을 지원합니다. 자세한 내용은 lfEscapement를 참조하세요.
UI_CAP_ROTANY	텍스트 이스케이프먼트 값을 지원합니다. 자세한 내용은 lfEscapement를 참조하세요.

dwIndex가 IGP_SETCOMPSTR 설정된 경우 함수는 다음 값 중 하나 이상을 반환합니다.

값	의미
SCS_CAP_COMPSTR	SCS_SETSTR 값으로 ImmSetCompositionString 함수를 호출하여 컴퍼지션 문자열을 만듭니다.
SCS_CAP_MAKEREAD	lpRead를 설정하지 않고 SCS_SETSTR ImmSetCompositionString 함수를 사용할 때 해당 컴퍼지션 문자열에서 읽기 문자열을 만듭니다.
SCS_CAP_SETRECONVERTSTRING:	이 IME는 재변환을 지원할 수 있습니다. ImmSetCompositionString을 사용하여 다시 변환을 수행합니다.

dwIndex가 IGP_SELECT 설정된 경우 함수는 다음 값 중 하나 이상을 반환합니다.

값	의미
SELECT_CAP_CONVMODE	새 IME를 선택할 때 변환 모드를 상속합니다.
SELECT_CAP_SENTENCE	새 IME를 선택할 때 문장 모드를 상속합니다.

dwIndex가 IGP_GETIMEVERSION 설정된 경우 함수는 다음 값 중 하나 이상을 반환합니다.

값	의미
IMEVER_0310	IME는 Windows 3.1용으로 만들어졌습니다.
IMEVER_0400	IME는 Windows Me/98/95용으로 만들어졌습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당],동아시아 언어 지원 설치
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	imm.h(Immdev.h, Windows.h 포함)
라이브러리	Imm32.lib
DLL	Imm32.dll