ImmGenerateMessage

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function enables an input method editor (IME) to generate messages that are sent to the window associated with the input method context (IMC). These messages are stored in the hMsgBuf member of the INPUTCONTEXT structure identified by the hIMC parameter.

Syntax

BOOL WINAPI ImmGenerateMessage( 
  HIMC hIMC
);
        

Parameters

  • hIMC
    [in] Handle to the INPUTCONTEXT structure that contains IME messages in its hMsgBuf member.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

This is a general purpose function, but it is typically called by an IME when the input method manager (IMM) calls the ImmNotifyIME function to notify an IME of a context update.

An IME user interface (UI) should not call this function only to update UI appearance. Instead, the IME UI should be updated when the IME is informed about an updated IMC. It is recommended that this function be used by an IME only when the IME changes the IMC without any keystroke activity from the user and needs to inform an application of the change.

Requirements

Header imm.h
Library Coreimm.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ImmNotifyIME
INPUTCONTEXT