ImmSetCompositionString (Windows Embedded CE 6.0)
1/6/2010
This function sets the characters, attributes, and clauses of the composition and reading strings.
Syntax
BOOL ImmSetCompositionString(
HIMC hIMC,
DWORD dwIndex,
LPCVOID lpComp,
DWORD dwCompLen,
LPCVOID lpRead,
DWORD dwReadLen
);
Parameters
- hIMC
[in] Handle to the input context.
dwIndex
[in] Value that specifies the type of information to set. This parameter can be one of one of the following values:Value Description SCS_SETSTR
Sets the composition string, the reading string, or both. At least one of the lpComp and lpRead parameters must point to a valid string. If either string is too long, the IME truncates it.
SCS_CHANGEATTR
Sets attributes for the composition string, the reading string, or both. At least one of the lpComp and lpRead parameters must point to a valid attribute array.
SCS_CHANGECLAUSE
Sets the clause information for the composition string, the reading string, or both. At least one of the lpComp and lpRead parameters must point to a valid clause information array.
- lpComp
[in] Long pointer to the buffer containing the information to set for the composition string. The information is as specified by the dwIndex value.
- dwCompLen
[in] Size, in bytes, of the information buffer for the composition string.
- lpRead
[in] Long pointer to the buffer containing the information to set for the reading string. The information is as specified by the dwIndex value.
- dwReadLen
[in] Size, in bytes, of the information buffer for the reading string.
Return Value
Nonzero indicates success. Zero indicates failure.
Remarks
When changing attributes, all characters in a clause must have the same attribute. Converted characters must be either ATTR_CONVERTED or ATTR_TARGET_CONVERTED; unconverted characters either ATTR_INPUT or ATTR_TARGET_NOTCONVERTED.
When changing clause information, only the target clause can be changed and only one boundary of the clause can be changed at a time. The target clause has the ATTR_TARGET_CONVERTED or ATTR_TARGET_NOTCONVERTED attribute.
When the IME completes the changes, it sends a WM_IME_COMPOSITION message to the application notifying it of the changes.
Requirements
| Header | imm.h |
| Library | Coreimm.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |