FlutterEngine::ProcessExternalWindowMessage 介绍

当您向 Flutter 应用添加任何外部窗口时，都需要将它们包含在窗口的应用生命周期逻辑中。要包含该窗口，其 WndProc 函数应调用 FlutterEngine::ProcessExternalWindowMessage。

针对 Flutter 3.13 或更高版本构建的 Windows 应用程序，且该应用程序会打开非 Flutter 窗口。

在 Windows 上实现应用程序生命周期涉及监听窗口消息以更新生命周期状态。为了让额外的非 Flutter 窗口影响生命周期状态，它们必须从其 WndProc 函数将窗口消息转发到 FlutterEngine::ProcessExternalWindowMessage。此函数返回一个 std::optional<LRESULT>，当消息被接收但未被处理时，它为 std::nullopt。当返回结果具有值时，表示消息已被处理，WndProc 中的进一步处理应停止。

以下示例 WndProc 过程调用 FlutterEngine::ProcessExternalWindowMessage

cppLRESULT Window::Messagehandler(HWND hwnd, UINT msg, WPARAM wparam, LPARAM lparam) {
    std::optional<LRESULT> result = flutter_controller_->engine()->ProcessExternalWindowMessage(hwnd, msg, wparam, lparam);
    if (result.has_value()) {
        return *result;
    }
    // Original contents of WndProc...
}

落地版本：3.14.0-3.0.pre
稳定版本：3.16

FlutterEngine::ProcessExternalWindowMessage 介绍

概述

影响范围

变更说明

迁移指南

时间线

参考资料