ImmAssociateContext

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function associates the specified input context with the specified window.

Syntax

HIMC ImmAssociateContext(
  HWND hWnd, 
  HIMC hIMC
);

Parameters

  • hWnd
    [in] Handle to the window to be associated with the input context.
  • hIMC
    [in] Handle to the input context.

Return Value

The handle to the input context previously associated with the window indicates success.

Remarks

If an application associates an input context with a window, the application must remove that association before destroying the input context. One way to do this is to save and re-associate the handle to the default input context with the window.

If the hIMC parameter is NULL, the ImmAssociateContext function removes any association the window may have with an input context. By default, the system associates the default input context with each window as it is created.

An application can specify only the default input context or NULL.

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