输入法编辑器（IME）程序设计（3）

Composition String

The composition string is the current text in the composition window. This is the text that the IME converts to final characters. Each composition string consists of one or more clauses, where a clause is the smallest combination of characters that the IME can convert to a final character. To get and set the composition string, call the ImmGetCompositionString and ImmSetCompositionString functions.

As the user enters text in the composition window, the IME tracks the status of the composition string. This status includes attribute information, clause information, typing information, and cursor position. You can retrieve the composition status by using the ImmGetCompositionString function.

In the attribute information array, all characters of one clause must have the same attribute. The attribute information is an array of 8-bit values that specifies the status of characters in the composition string. There is one value for each byte in the string, including one byte each for the lead and second bytes of any double-byte characters in the string. For each value in the array, bits 0 through 3 can be one combination of the following values.

       字母组合字符串（composition string）是指字母组合窗口中的当前文本。这是将被IME转换为最终字符的文本。每个字母组合字符串由一个或多个子串组成（clauses），子串是IME能转换成最终字符的最小字符组合。要获取或设置字母组合字符串，调用ImmGetCompositionString 和ImmSetCompositionString函数。

       当用户在字母组合窗口中输入文本时，IME会跟踪字母组合字符串的状态。这些状态包括属性信息、子串信息、录入信息和子串的位置。你可以通过使用ImmGetCompositionString函数来检索字母组合的状态。

       在属性信息数组中，同一个子串中的所有字母都必须具有相同的属性。属性信息是一个由8位值组成的数组，用于确定字母组合字符串中的字符。字符串中的每个字节都对应有一个值，其中，字符串中每个双字节字符的第一和第二字节也都对应的一个值。数组中的每个值，从第0位到第3位可以是下面各值的组合：