WinForms嵌套Qt Editbox场景下如何正确隐藏Input Method Editor

问题根源 #

调用ImmSetOpenStatus传入false会直接禁用当前输入法上下文的输入能力，而非仅隐藏IME候选/组合窗口，因此后续不重新启用上下文的情况下IME自然无法正常唤起，属于API选型错误。

正确实现方案 #

隐藏IME对话框仅需要向当前IME上下文发送关闭组合窗口的通知即可，不会影响后续IME的正常使用，具体实现如下：

1. 先声明所需的Win32 API和常量 #

private const int NI_CLOSECOMPOSITION = 0x0010;

[DllImport("Imm32.dll")]
private static extern IntPtr ImmGetContext(IntPtr hWnd);

[DllImport("Imm32.dll")]
private static extern bool ImmReleaseContext(IntPtr hWnd, IntPtr hImc);

[DllImport("Imm32.dll")]
private static extern bool ImmNotifyIME(IntPtr hImc, int dwAction, int dwIndex, int dwValue);

2. 焦点离开Qt Editbox时执行隐藏逻辑 #

当检测到点击Editbox外部、焦点切换到其他控件时，执行如下代码：

// 传入Qt Editbox的窗口句柄获取对应IME上下文
IntPtr hImc = ImmGetContext(qtEditBoxHandle);
if (hImc != IntPtr.Zero)
{
    // 发送关闭组合窗口通知，仅隐藏IME弹窗，不会禁用IME
    ImmNotifyIME(hImc, NI_CLOSECOMPOSITION, 0, 0);
    // 释放IME上下文，注意不要长期持有hImc句柄
    ImmReleaseContext(qtEditBoxHandle, hImc);
}

额外注意事项 #

如果当前有用户未完成的输入内容，可以在关闭组合窗口前先调用ImmGetCompositionString获取未提交的内容写入Editbox，避免用户输入丢失。如果确实需要临时禁用整个输入法上下文，记得在Qt Editbox重新获得焦点时主动调用ImmSetOpenStatus(hImc, true)重新启用，该方式不如通知关闭窗口的方式稳妥，非必要不建议使用。

内容的提问来源于stack exchange，提问作者TheFitGeekGirl