Flutter FilePicker编辑框初始焦点设置及hwndOwner作用咨询

一、编辑框初始焦点问题解决（lockParentWindow=true时） #

当设置lockParentWindow=true时，文件对话框的编辑框无法自动获取焦点，原因是对话框关联了Flutter窗口作为父窗口（hwndOwner），导致Windows系统的焦点管理逻辑没有自动把焦点给到对话框内的编辑控件。要解决这个问题，需要通过对话框钩子函数在初始化时主动设置焦点：

修改FilePicker Windows实现步骤： #

1. 导入所需的Windows API（通过ffi）：

import 'dart:ffi';
import 'package:ffi/ffi.dart';

final user32 = DynamicLibrary.open('user32.dll');

// 定义API函数签名
typedef GetDlgItemC = Pointer<IntPtr> Function(Pointer<IntPtr> hDlg, int nIDDlgItem);
typedef GetDlgItemDart = Pointer<IntPtr> Function(Pointer<IntPtr> hDlg, int nIDDlgItem);
final getDlgItem = user32.lookupFunction<GetDlgItemC, GetDlgItemDart>('GetDlgItem');

typedef SetFocusC = Pointer<IntPtr> Function(Pointer<IntPtr> hWnd);
typedef SetFocusDart = Pointer<IntPtr> Function(Pointer<IntPtr> hWnd);
final setFocus = user32.lookupFunction<SetFocusC, SetFocusDart>('SetFocus');

typedef DialogProcC = IntPtr Function(IntPtr hDlg, UInt32 msg, IntPtr wParam, IntPtr lParam);
typedef DialogProcDart = int Function(int hDlg, int msg, int wParam, int lParam);

2. 添加对话框钩子函数，在初始化时设置焦点到文件名编辑框：

int _dialogHook(int hDlg, int msg, int wParam, int lParam) {
  const WM_INITDIALOG = 0x0110;
  const FILE_NAME_EDIT_ID = 0x480; // Windows文件对话框默认文件名编辑框ID

  if (msg == WM_INITDIALOG) {
    final editHandle = getDlgItem(Pointer.fromAddress(hDlg), FILE_NAME_EDIT_ID);
    if (editHandle.address != 0) {
      setFocus(editHandle);
    }
  }
  return 0;
}

3. 在_instantiateOpenFileNameW函数中启用钩子：
   修改flags设置，并添加钩子关联：

openFileNameW.ref.flags = ofnExplorer | ofnFileMustExist | ofnHideReadOnly | ofnEnableHook;
openFileNameW.ref.lpfnHook = Pointer.fromFunction<DialogProcC>(_dialogHook, 0);

修改后，对话框初始化时钩子函数会触发，主动将焦点设置到文件名编辑框，即可直接输入。

二、hwndOwner的具体作用 #

hwndOwner是Windows原生对话框的父窗口句柄，核心作用如下：

• 模态锁定：设置后对话框会成为父窗口的模态对话框，父窗口会被禁用（无法点击、输入），直到对话框关闭——这就是lockParentWindow=true时的核心行为。
• 窗口层级与显示：对话框会始终显示在父窗口上方，不会被父窗口遮挡；任务栏中不会单独显示对话框图标，与父窗口共享任务栏条目。
• 焦点与生命周期：对话框关闭后，系统会自动将焦点返还给父窗口；父窗口被销毁时，关联的对话框也会被强制关闭。
• 系统行为一致性：对话框的最小化、最大化等操作会跟随父窗口，符合Windows平台的窗口交互规范。

为什么lockParentWindow=true时会出现焦点问题？ #

当hwndOwner关联到Flutter窗口时，Flutter的自定义消息循环与Windows原生对话框的焦点管理逻辑存在冲突：系统默认的焦点分配被父窗口的消息处理拦截，导致对话框内部控件无法自动获取焦点。而lockParentWindow=false时，对话框是无父窗口的顶级窗口，系统会自动将焦点分配给编辑框，因此恢复正常。

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