CANDIDATELIST 구조체(imm.h)
후보 목록에 대한 정보를 포함합니다.
구문
typedef struct tagCANDIDATELIST {
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[1];
} CANDIDATELIST, *PCANDIDATELIST, *NPCANDIDATELIST, *LPCANDIDATELIST;
멤버
dwSize
구조체, 오프셋 배열 및 모든 후보 문자열의 크기(바이트)입니다.
dwStyle
후보 스타일 값입니다. 이 멤버에는 다음 값 중 하나 이상이 있을 수 있습니다.
| 값 | 의미 |
|---|---|
| IME_CAND_UNKNOWN | 응시자는 여기에 나열된 스타일이 아닌 다른 스타일입니다. |
| IME_CAND_READ | 후보자는 같은 독서에 있습니다. |
| IME_CAND_CODE | 응시자는 코드 범위에 있습니다. |
| IME_CAND_MEANING | 후보자는 같은 의미입니다. |
| IME_CAND_RADICAL | 후보자는 동일한 급진적 인 성격을 사용합니다. |
| IME_CAND_STROKES | 응시자는 동일한 수의 스트로크에 있습니다. |
IME_CAND_CODE 스타일의 경우 후보 목록에는 dwCount 멤버의 값에 따라 특수 구조가 있습니다. dwCount가 1이면 dwOffset 멤버에 오프셋이 아닌 단일 DBCS 문자가 포함되며 후보 문자열이 제공되지 않습니다. dwCount 멤버가 1보다 크면 dwOffset 멤버에 유효한 오프셋이 포함되고 후보 문자열은 16진수 표기법으로 개별 DBCS 문자 값의 텍스트 표현입니다.
dwCount
후보 문자열의 수입니다.
dwSelection
선택한 후보 문자열의 인덱스입니다.
dwPageStart
후보 창에서 첫 번째 후보 문자열의 인덱스입니다. 이는 사용자가 PAGE UP 및 PAGE DOWN 키를 누를 때 달라집니다.
dwPageSize
후보 창의 한 페이지에 표시할 후보 문자열의 수입니다. 사용자는 PAGE UP 또는 PAGE DOWN 키와 같은 IME 정의 키를 눌러 다음 페이지로 이동할 수 있습니다. 이 숫자가 0이면 애플리케이션이 자체에 적절한 값을 정의할 수 있습니다.
dwOffset[1]
이 구조체의 시작을 기준으로 첫 번째 후보 문자열의 시작 부분에 대한 오프셋입니다. 후속 문자열의 오프셋은 이 멤버 바로 뒤에 32비트 오프셋 배열을 형성합니다.
설명
후보 문자열은 dwOffset 배열의 마지막 오프셋 바로 뒤에 옵니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 머리글 | imm.h(Immdev.h, Windows.h 포함) |