详细解析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 结构体，开发者可高度定制文件对话框的行为，满足不同场景需求。