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 |