如何解决CefSharp.Wpf.Hwnd导致WPF应用无法检测键盘布局切换？

问题根源 #

CefSharp.Wpf.Hwnd使用原生Win32窗口作为渲染容器，当焦点落在该窗口内时，键盘输入及布局变化的系统消息会被CEF的原生窗口过程直接处理，不会进入WPF的消息分发机制，导致InputLanguageManager、常规全局钩子等方案失效。

方案一：利用CEF原生IKeyboardHandler接口拦截检测 #

通过实现CEF提供的IKeyboardHandler，在键盘事件回调中实时获取当前键盘布局，适用于需要响应键盘操作时的布局变化检测。

public class CustomKeyboardHandler : IKeyboardHandler
{
    // 记录上次布局，避免重复触发
    private IntPtr _lastLayout = IntPtr.Zero;

    public bool OnKeyEvent(IWebBrowser chromiumWebBrowser, IBrowser browser, KeyType type, int windowsKeyCode, int nativeKeyCode, CefEventFlags modifiers, bool isSystemKey)
    {
        // 获取CEF窗口所属线程的键盘布局
        uint threadId = GetWindowThreadProcessId(browser.GetHost().GetWindowHandle(), out _);
        IntPtr currentLayout = GetKeyboardLayout(threadId);

        if (currentLayout != _lastLayout)
        {
            _lastLayout = currentLayout;
            // 此处处理布局变化逻辑，比如触发自定义事件通知WPF
            Console.WriteLine($"CEF内键盘布局更新: {currentLayout}");
        }

        return false; // 返回false让CEF继续处理键盘事件
    }

    public bool OnPreKeyEvent(IWebBrowser chromiumWebBrowser, IBrowser browser, KeyType type, int windowsKeyCode, int nativeKeyCode, CefEventFlags modifiers, bool isSystemKey, ref bool isKeyboardShortcut)
    {
        return false;
    }

    // P/Invoke声明
    [DllImport("user32.dll")]
    static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);

    [DllImport("user32.dll")]
    static extern IntPtr GetKeyboardLayout(uint idThread);
}

// 初始化ChromiumWebBrowser时绑定Handler
chromiumWebBrowser.KeyboardHandler = new CustomKeyboardHandler();

方案二：拦截CEF窗口的WM_INPUTLANGCHANGE消息 #

系统在键盘布局变化时会向焦点窗口发送WM_INPUTLANGCHANGE消息，通过给CEF的原生窗口设置子类化过程，直接捕获该消息，是最精准的实时检测方案。

private IntPtr _cefWindowHandle;
private IntPtr _originalWndProc;
private WndProcDelegate _wndProcDelegate;

private delegate IntPtr WndProcDelegate(IntPtr hWnd, uint msg, IntPtr wParam, IntPtr lParam);
private const uint WM_INPUTLANGCHANGE = 0x0051;
private const int GWLP_WNDPROC = -4;

public void AttachCefWindowHook(IntPtr cefHwnd)
{
    _cefWindowHandle = cefHwnd;
    _wndProcDelegate = CefWndProc;
    // 保存原窗口过程，后续需恢复
    _originalWndProc = GetWindowLongPtr(_cefWindowHandle, GWLP_WNDPROC);
    // 设置自定义窗口过程
    SetWindowLongPtr(_cefWindowHandle, GWLP_WNDPROC, Marshal.GetFunctionPointerForDelegate(_wndProcDelegate));
}

private IntPtr CefWndProc(IntPtr hWnd, uint msg, IntPtr wParam, IntPtr lParam)
{
    if (msg == WM_INPUTLANGCHANGE)
    {
        // wParam直接包含新的键盘布局标识符
        IntPtr newLayout = wParam;
        // 处理布局变化逻辑
        Console.WriteLine($"CEF窗口布局变更: {newLayout}");
    }
    // 调用原窗口过程，保证CEF正常功能
    return CallWindowProc(_originalWndProc, hWnd, msg, wParam, lParam);
}

// 在CEF初始化完成后绑定钩子
private void ChromiumWebBrowser_IsBrowserInitializedChanged(object sender, DependencyPropertyChangedEventArgs e)
{
    var browser = sender as ChromiumWebBrowser;
    if (browser != null && browser.IsBrowserInitialized)
    {
        AttachCefWindowHook(browser.GetBrowser().GetHost().GetWindowHandle());
    }
}

// 程序关闭时恢复原窗口过程，避免内存泄漏
private void OnAppExit(object sender, ExitEventArgs e)
{
    if (_cefWindowHandle != IntPtr.Zero && _originalWndProc != IntPtr.Zero)
    {
        SetWindowLongPtr(_cefWindowHandle, GWLP_WNDPROC, _originalWndProc);
    }
}

// P/Invoke声明
[DllImport("user32.dll")]
static extern IntPtr SetWindowLongPtr(IntPtr hWnd, int nIndex, IntPtr dwNewLong);

[DllImport("user32.dll")]
static extern IntPtr GetWindowLongPtr(IntPtr hWnd, int nIndex);

[DllImport("user32.dll")]
static extern IntPtr CallWindowProc(IntPtr lpPrevWndFunc, IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);

方案三：定时检测布局（简易方案） #

当CEF窗口获得焦点时启动定时器，定期对比当前键盘布局与上次记录值，适合对实时性要求不高的场景，实现成本最低。

private DispatcherTimer _layoutCheckTimer;
private IntPtr _lastLayout = IntPtr.Zero;

private void ChromiumWebBrowser_GotFocus(object sender, RoutedEventArgs e)
{
    _lastLayout = GetCurrentKeyboardLayout();
    // 每100ms检测一次，可根据需求调整间隔
    _layoutCheckTimer = new DispatcherTimer(TimeSpan.FromMilliseconds(100), DispatcherPriority.Normal, (s, args) =>
    {
        var currentLayout = GetCurrentKeyboardLayout();
        if (currentLayout != _lastLayout)
        {
            _lastLayout = currentLayout;
            Console.WriteLine($"布局更新: {currentLayout}");
        }
    }, Application.Current.Dispatcher);
}

private void ChromiumWebBrowser_LostFocus(object sender, RoutedEventArgs e)
{
    _layoutCheckTimer?.Stop();
    _layoutCheckTimer = null;
}

private IntPtr GetCurrentKeyboardLayout()
{
    IntPtr foregroundWnd = GetForegroundWindow();
    uint threadId = GetWindowThreadProcessId(foregroundWnd, out _);
    return GetKeyboardLayout(threadId);
}

// P/Invoke声明
[DllImport("user32.dll")]
static extern IntPtr GetForegroundWindow();

[DllImport("user32.dll")]
static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint lpdwProcessId);

[DllImport("user32.dll")]
static extern IntPtr GetKeyboardLayout(uint idThread);

方案对比 #

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