ImmCreateIMCC (Compact 2013)

3/28/2014

This function enables an input method editor (IME) to create a new input method context (IMC) component that is a member of an IMC.

Syntax

HIMCC WINAPI ImmCreateIMCC( 
  DWORD dwSize
);

Parameters

  • dwSize
    [in] Size of the new IMC component.

Return Value

The IMC component handle indicates success. Zero indicates failure.

Remarks

The IMC component created by this function is initialized with zero.

An IME monitors the user's keystrokes, anticipates the characters the user may want, and presents a list of candidate characters from which to choose.

An IMC is a structure, maintained by the IME and used by IME windows, that contains information about the status of the IME. By default, the system creates and assigns an IMC to a thread if it calls a function that requires the use of an IMC. Within the thread, this default input context is a shared resource and is associated with each newly created window. An IMC requires considerable system resources, so use them judiciously.

Requirements

Header

imm.h

Library

Coreimm.lib

See Also

Reference

Input Method Manager (IMM) Functions