Qt嵌入Windows外部窗口焦点异常问题求助

问题核心 #

嵌入外部窗口后，点击窗口区域无法触发焦点转移、键盘输入失效，本质是Qt焦点管理与Windows原生窗口机制的冲突——外部窗口会拦截输入事件，但未正确完成焦点传递。

方案一：容器事件过滤器拦截鼠标点击 #

给Qt容器安装事件过滤器，监听鼠标点击事件，手动调用Win32 API将焦点转移到外部窗口：

// 初始化嵌入窗口后，给容器安装事件过滤器
embedding->installEventFilter(this);

// 实现事件过滤器逻辑
bool YourWidget::eventFilter(QObject *watched, QEvent *event)
{
    if (watched == embedding && event->type() == QEvent::MouseButtonPress)
    {
#ifdef __WIN32
        // hwnd为外部窗口的原生句柄
        SetForegroundWindow(hwnd);
        SetFocus(hwnd);
#endif
        return true; // 阻止事件继续传递，避免Qt额外处理
    }
    return QWidget::eventFilter(watched, event);
}

说明：SetForegroundWindow确保外部窗口被激活，SetFocus设置键盘焦点，比单纯发送WM_ACTIVATE消息更可靠，适配Windows前台窗口权限控制逻辑。

方案二：设置外部窗口为Qt容器的子窗口 #

通过Win32 API将外部窗口的父窗口设为Qt容器的原生句柄，让Windows窗口管理器自动处理焦点传递：

QWindow* window = QWindow::fromWinId(id);
embedding = QWidget::createWindowContainer(window, ui->game);

#ifdef __WIN32
    // 获取Qt容器的原生HWND
    HWND containerHwnd = reinterpret_cast<HWND>(embedding->winId());
    // 设置外部窗口为容器的子窗口
    SetParent(hwnd, containerHwnd);
    // 移除外部窗口的标题栏等样式（可选，适配嵌入场景）
    SetWindowLongPtr(hwnd, GWL_STYLE, GetWindowLongPtr(hwnd, GWL_STYLE) & ~WS_OVERLAPPEDWINDOW);
    // 同步外部窗口大小与容器一致
    RECT clientRect;
    GetClientRect(containerHwnd, &clientRect);
    SetWindowPos(hwnd, nullptr, 0, 0, clientRect.right, clientRect.bottom, SWP_NOZORDER);
#endif

说明：此方式让外部窗口完全纳入Qt容器的窗口层级，Windows会自动处理点击焦点转移，键盘输入也能正常传递。需监听容器的resize事件，同步调整外部窗口大小。

方案三：修正自定义QWindow的错误用法 #

你之前强制类型转换QWindow::fromWinId返回值的方式无效，Qt内部创建的QWindow实例无法直接转为自定义子类，正确做法是给原生QWindow安装事件过滤器：

QWindow* window = QWindow::fromWinId(id);
window->installEventFilter(this);

// 实现事件过滤器
bool YourWidget::eventFilter(QObject *watched, QEvent *event)
{
    if (watched == window)
    {
        if (event->type() == QEvent::MouseButtonPress)
        {
#ifdef __WIN32
            SetForegroundWindow(hwnd);
            SetFocus(hwnd);
#endif
        }
    }
    return QWidget::eventFilter(watched, event);
}

关键避坑点 #

1. 不要设置Qt::WindowDoesNotAcceptFocus或Qt::WindowTransparentForInput标志，这会让Qt容器放弃处理输入事件，导致点击无响应。
2. setFocusProxy仅对Qt内部Widget生效，对外部窗口完全无效，因为外部窗口的焦点由Windows管理。
3. 确保hwnd是有效且正确的外部窗口句柄，避免空指针或无效句柄导致API调用失败。

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