ImmAssociateContextEx function

ImmAssociateContextEx function

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

Syntax

C++

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.

Value	Meaning
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