CANDIDATELIST结构包含有关候选列表的信息。
typedef struct _tagCANDIDATELIST {en
DWORD dwSize;
DWORD dwStyle;
DWORD dwCount;
DWORD dwSelection;
DWORD dwPageStart;
DWORD dwPageSize;
DWORD dwOffset[];
} CANDIDATELIST;
会员
的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键。如果这个数字为零,应用程序可以自己定义一个合适的值。
dwOffset
偏移到第一个候选字符串的开头,相对于此结构的开始。后续字符串的偏移立即跟随该成员,形成一个32位偏移量的数组。
备注
候选字符串紧跟在dwOffset数组中的最后一个偏移量。