[This is preliminary documentation and subject to change.]
The ImmAssociateContextEx function changes the association between the input method context and the specified window or its children.
BOOL ImmAssociateContextEx(
HWND hWnd, // handle to window
HINC hIMC, // handle to input method context
DWORD dwFlags // flag
);
Value | Meaning |
---|---|
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. |
If the function succeeds, the return value is TRUE.
If the function fails, the return value is FALSE.
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.
Windows NT: Requires version 5.0 or later.
Windows: Requires Windows 98.
Windows CE: Unsupported.
Header: Declared in imm.h.
Import Library: Use imm32.lib.
Input Method Editor Overview, Input Method Editor Functions