ImmAssociateContextEx

ImmAssociateContextEx function

Changes the association between the input method context and the specified window or its children.

Syntax


BOOL ImmAssociateContextEx(
  _In_ HWND  hWnd,
  _In_ HIMC  hIMC,
  _In_ DWORD dwFlags
);

Parameters

hWnd [in]

Handle to the window to associate with the input context.

hIMC [in]

Handle to the input method context.

dwFlags [in]

Flags specifying the type of association between the window and the input method context. This parameter can have one of the following values.

ValueMeaning
IACE_CHILDREN

Associate the input method context to the child windows of the specified window only.

IACE_DEFAULT

Restore the default input method context of the window.

IACE_IGNORENOCONTEXT

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

 

Return value

Returns TRUE if successful or FALSE otherwise.

Remarks

If the application calls this function with IACE_CHILDREN, the operating system associates the specified input method context with child windows of the window indicated by hWnd. It associates the input method context only with child windows of the thread that creates 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 operating system restores the default input method context for the window. In this case, the hIMC parameter is ignored.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Version

East Asian language support installed.

Header

Imm.h (include Windows.h)

Library

Imm32.lib

DLL

Imm32.dll

See also

Input Method Manager
Input Method Manager Functions

 

 

Show:
© 2016 Microsoft