候选列表结构 (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 成员包含有效的偏移量，候选字符串是十六进制表示法中各个 DBCS 字符值的文本表示形式。
dwCount
候选字符串数。
dwSelection
所选候选字符串的索引。
dwPageStart
候选窗口中第一个候选字符串的索引。 当用户按下 PAGE UP 和 PAGE DOWN 键时，情况会有所不同。
dwPageSize
候选窗口的一页中要显示的候选字符串数。 用户可以通过按 IME 定义的键（例如 PAGE UP 或 PAGE DOWN 键）移动到下一页。 如果此数字为 0，则应用程序可以自行定义正确的值。
dwOffset[1]
相对于此结构的开头，偏移到第一个候选字符串的开头。 后续字符串的偏移量紧跟此成员，形成一个由 32 位偏移量组成的数组。
注解
候选字符串紧跟 dwOffset 数组中的最后一个偏移量。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 标头 | imm.h (包括 Immdev.h、Windows.h) |