详细解析GetOpenFileName()
书籍：《Visual C++ 2017从入门到精通》的2.3.8 Win32控件编程
环境：visual studio 2022
内容：【例2.34】打开文件对话框和另存为。
说明：以下内容大部分来自腾讯元宝。
GetOpenFileName() 是 Windows API 中用于显示标准文件打开对话框的核心函数，其功能是允许用户选择文件并获取文件路径。以下是详细解析：
1. 函数概述
GetOpenFileName() 通过调用系统对话框让用户选择文件，但不会实际打开文件。它广泛应用于需要文件交互的场景，如文件导入、编辑器加载等。
2. 函数原型
BOOL GetOpenFileName(LPOPENFILENAME lpofn);- lpofn：指向
OPENFILENAME结构体的指针，用于初始化对话框属性并接收结果。
3. 关键参数解析
OPENFILENAME 结构体包含多个成员，以下是核心参数说明：
| 参数名 | 作用 | 示例/说明 |
|---|---|---|
| lpstrFilter | 定义文件类型过滤器，格式为 `"描述 | 扩展名"`，多个过滤器用分号分隔。 |
| lpstrFile | 接收用户选择的完整文件路径，需预先分配足够内存（建议≥256字节）。 | 需配合 nMaxFile 指定缓冲区大小 |
| lpstrTitle | 设置对话框标题栏文本。 | "选择配置文件" |
| Flags | 控制对话框行为的标志位组合，常用值： | - OFN_ALLOWMULTISELECT：允许多选文件- OFN_FILEMUSTEXIST：仅显示存在文件 |
| nFilterIndex | 默认选中的过滤器索引（从1开始）。 | 若设置 lpstrFilter 为多个过滤器，此参数指定默认显示的第一个过滤器 |
4. 返回值
- 成功：返回
TRUE，lpofn->lpstrFile包含完整路径。 - 取消/错误：返回
FALSE，可通过CommDlgExtendedError()获取错误代码。
5. 使用示例（VBA）
Sub OpenFile()
Dim filePath As Variant
filePath = Application.GetOpenFilename("文本文件 (*.txt),*.txt")
If Not filePath = False Then
MsgBox "选择的文件路径：" & filePath
Else
MsgBox "未选择文件"
End If
End Sub- 参数说明：
FileFilter："描述,扩展名"格式。MultiSelect：设为True允许多选（返回数组）。
6. 高级选项
- 新式对话框：设置
Flags包含OFN_EXPLORER可启用 Windows Explorer 风格界面。 - 旧式对话框：取消
OFN_EXPLORER并指定旧式钩子函数以兼容旧系统。 - 选择目录：需改用
SHBrowseForFolder函数。
7. 跨平台对比
在 Qt 中，类似功能通过 QFileDialog::getOpenFileName() 实现，参数直接映射 OPENFILENAME 的成员（如 filter 对应 lpstrFilter）。
通过合理配置 OPENFILENAME 结构体，开发者可高度定制文件对话框的行为，满足不同场景需求。