如何在wxWebView中捕获键盘事件？WebView2后端事件拦截问题

WebView2引擎会优先抢占键盘焦点并拦截大部分事件，导致wx常规的wxEVT_KEY_DOWN绑定无法生效。以下是两种针对性的解决方法：

方法一：利用WebView2原生API拦截快捷键事件 #

通过获取WebView2底层的CoreWebView2实例，注册AcceleratorKeyPressed事件，可在浏览器处理快捷键前拦截并处理：

1. 绑定WebView加载完成事件（确保CoreWebView2已初始化）：

ctrl_->Bind(wxEVT_WEBVIEW_LOADED, &WxHtml::OnWebViewLoaded, this);

2. 在加载完成回调中注册事件处理器：

#include <WebView2.h>
#include <wrl.h>

using namespace Microsoft::WRL;

void WxHtml::OnWebViewLoaded(wxWebViewEvent& evt)
{
    // 获取WebView2底层的CoreWebView2对象
    ICoreWebView2* coreWebView2 = static_cast<ICoreWebView2*>(ctrl_->GetBackend()->GetUnderlyingHandle());
    if (!coreWebView2) return;

    // 注册AcceleratorKeyPressed事件
    coreWebView2->add_AcceleratorKeyPressed(
        Callback<ICoreWebView2AcceleratorKeyPressedEventHandler>(
            [this](ICoreWebView2*, ICoreWebView2AcceleratorKeyPressedEventArgs* args) -> HRESULT
            {
                UINT32 virtualKey = 0;
                args->get_VirtualKey(&virtualKey);
                fs::out << "快捷键按键码：" << virtualKey << std::endl;

                // 可选：阻止WebView2处理该快捷键，让事件可传递到wx父组件
                BOOL isBrowserAccel = FALSE;
                args->get_IsBrowserAccelerator(&isBrowserAccel);
                if (isBrowserAccel)
                {
                    args->put_Handled(TRUE); // 标记为已处理，WebView2不再响应
                    // 此处可自行处理快捷键逻辑或触发wx键盘事件
                }

                return S_OK;
            }).Get(),
        nullptr // 可传入事件令牌用于后续取消注册
    );
}

方法二：通过JavaScript监听网页内按键事件 #

若要捕获网页中的普通输入按键（如文本框输入），可通过注入JS监听事件，再通过WebMessage将按键信息传递给wx程序：

1. 注册脚本消息通道并绑定接收事件：

// 初始化WebView后注册消息通道
ctrl_->RegisterScriptMessageHandler("keyEventChannel");
// 绑定消息接收回调
ctrl_->Bind(wxEVT_WEBVIEW_SCRIPT_MESSAGE_RECEIVED, &WxHtml::OnKeyMessageReceived, this);

2. 向网页注入按键监听的JavaScript：

void WxHtml::OnWebViewLoaded(wxWebViewEvent& evt)
{
    ctrl_->RunScript(R"(
        document.addEventListener('keydown', function(e) {
            // 将按键信息发送给wx程序
            window.chrome.webview.postMessage({
                type: 'keydown',
                keyCode: e.keyCode,
                key: e.key
            });
        });
    )");
}

3. 处理接收到的脚本消息：

#include <wx/json/json.h>

void WxHtml::OnKeyMessageReceived(wxWebViewEvent& evt)
{
    wxString rawMsg = evt.GetString();
    wxJSONValue jsonMsg;
    wxJSONReader reader;

    if (reader.Parse(rawMsg, jsonMsg))
    {
        if (jsonMsg["type"].AsString() == "keydown")
        {
            int keyCode = jsonMsg["keyCode"].AsInt();
            fs::out << "网页按键码：" << keyCode << std::endl;
        }
    }
}

注意事项 #

• 方法一适合拦截浏览器级快捷键（如Ctrl+C、Ctrl+Tab），方法二适合捕获网页内用户输入按键。
• 使用CoreWebView2 API时，需确保项目已配置WebView2 SDK环境，包含对应头文件并链接相关库。
• 若阻止WebView2处理快捷键，需自行实现对应功能（如复制、粘贴），避免影响用户体验。

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