ImmAssociateContextEx

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function changes the association between the input method context and the specified window or its children.

Syntax

BOOL ImmAssociateContextEx( 
  HWND hWnd, 
  HINC hIMC, 
  DWORD dwFlags
);

Parameters

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

  • dwFlags
    [in] Value that specifies the type of association between the window and the input method context. The following table shows the values this parameter can take.

    Value Description

    IACE_CHILDREN

    Associate the input method context to the child windows of hWnd only.

    IACE_DEFAULT

    Restore the window's default input method context.

    IACE_IGNORENOCONTEXT

    Do not associate the input method context with windows that are not associated with any input method context.

Return Value

TRUE indicates success. FALSE indicates failure.

Remarks

If the application calls this function with IACE_CHILDREN, the system associates the specified input method context with child windows of hWnd. It associates the input method context only with child windows of the thread that created hWnd. Any child window that is created after this function has been called will not be affected. Instead, the default input method context will be associated with it.

If the application calls this function with IACE_DEFAULT, the system restores the window's default input method context. In this case, the hIMC parameter is ignored.

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