如何检测日文输入法Candidate Window，解决按键冲突问题？

针对类似Spotlight的应用与中日韩输入法候选窗口的按键冲突问题，不同操作系统有各自的原生API可用于检测候选窗口的显示状态，以下是具体实现方案：

Windows平台 #

Windows提供专门的输入法管理器（IME）API来获取候选窗口状态：

• 使用ImmGetCandidateWindow函数：先通过ImmGetContext获取当前线程的IME上下文，再调用该函数获取候选窗口信息，通过CANDIDATEWINDOW结构体的dwStyle和窗口尺寸判断是否可见。
• 备选方案：使用GetGUIThreadInfo获取前台线程GUI信息，检查GUITHREADINFO中的窗口关联，或遍历查找类名为IME_CANDIDATE_WINDOW的窗口。

示例代码（C++）：

#include <windows.h>
#include <imm.h>

bool IsCandidateWindowVisible() {
    HWND hwndForeground = GetForegroundWindow();
    DWORD threadId = GetWindowThreadProcessId(hwndForeground, nullptr);
    HKL hkl = GetKeyboardLayout(threadId);
    if (!ImmIsIME(hkl)) {
        return false; // 当前未启用IME
    }

    HIMC himc = ImmGetContext(hwndForeground);
    if (!himc) return false;

    CANDIDATEWINDOW cw;
    bool visible = false;
    if (ImmGetCandidateWindow(himc, 0, &cw)) {
        // 候选窗口未隐藏且有有效尺寸则判定为可见
        visible = (cw.dwStyle & CFS_HIDE) == 0 && cw.rcCandidate.right > cw.rcCandidate.left;
    }

    ImmReleaseContext(hwndForeground, himc);
    return visible;
}

macOS平台 #

macOS可通过AppKit框架的文本输入上下文API检测：

• 使用NSTextInputContext的isCandidateListVisible属性直接判断候选窗口状态，同时可通过candidates数组确认是否存在候选内容。
• 也可监听NSTextInputContextCandidateListDidChangeNotification通知，实时捕获候选窗口的显示/隐藏变化。

示例代码（Swift）：

import AppKit

func isCandidateWindowVisible() -> Bool {
    guard let inputContext = NSTextInputContext.currentInputContext else {
        return false
    }
    return inputContext.isCandidateListVisible && !inputContext.candidates.isEmpty
}

// 监听候选窗口状态变化
NotificationCenter.default.addObserver(forName: .NSTextInputContextCandidateListDidChange, object: nil, queue: .main) { notification in
    guard let inputContext = notification.object as? NSTextInputContext else { return }
    let isVisible = inputContext.isCandidateListVisible
    // 根据状态调整应用按键拦截逻辑
}

Linux平台 #

Linux下基于X11的桌面环境，可通过IBus框架或Xlib窗口遍历实现：

• 使用IBus API：调用ibus_context_get_candidate_list获取候选列表，通过ibus_candidate_list_get_visible判断窗口可见性。
• 备选方案：遍历X11窗口，查找类名匹配输入法候选窗口的对象，通过XGetWindowAttributes检查窗口映射状态。

示例代码（C，基于IBus）：

#include <ibus.h>

gboolean is_candidate_window_visible() {
    IBusBus *bus = ibus_bus_new();
    if (!ibus_bus_is_connected(bus)) {
        g_object_unref(bus);
        return FALSE;
    }

    IBusContext *context = ibus_bus_get_global_context(bus);
    IBusCandidateList *list = ibus_context_get_candidate_list(context);
    gboolean visible = list != NULL && ibus_candidate_list_get_visible(list);

    g_object_unref(list);
    g_object_unref(context);
    g_object_unref(bus);
    return visible;
}

通用优化建议 #

• 除检测候选窗口状态，还可监听输入法激活/停用事件，动态调整按键拦截逻辑：IME激活时，优先让输入法处理方向键、回车键，避免冲突。
• 跨平台应用可封装抽象层，根据当前操作系统自动调用对应检测方法。

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