CFileDialog 扩展名注意事项
2025-07-01 20:55:10 #MFC

在 MFC 中，打开和保存对话框都是用 CFileDialog 来实现的，构造函数的第一个参数决定了是"打开"还是"保存"。

#打开对话框

一个简单的对话框如下

1
2
3
4
5
CFileDialog dlg(TRUE, nullptr, nullptr, 0, _T("ALL|*.*||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();
    const auto fileName = dlg.GetFileName();
}

这个对话框有两个问题：

  1. 用户如果未输入扩展名，ext将为空。
  2. 允许用户输入不存在的文件名。

#解决问题一

可以将第二个参数为默认的扩展名，当用户没有输入扩展名的时候，会自动附加默认扩展名。

1
2
3
4
5
CFileDialog dlg(TRUE, _T("txt"), nullptr, 0, _T("ALL|*.*||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();
    const auto fileName = dlg.GetFileName();
}

输入123，会得到文件名123.txt。

  • 过滤器优先于默认扩展名。如果用户未输入文件名，但是选择了有效的过滤器：
1
2
3
4
5
CFileDialog dlg(TRUE, _T("ini"), nullptr, 0, _T("ALL|*.*|TXT|*.txt||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();
    const auto fileName = dlg.GetFileName();
}

如果用户选择了txt过滤器，但是输入123作为文件名，将会得到123.txt，而不是123.ini。

  • 如果过滤器有多个扩展名，则采用第一个：
1
2
3
4
5
CFileDialog dlg(TRUE, _T("ini"), nullptr, 0, _T("ALL|*.*|TXT|*.txt;*.doc||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();
    const auto fileName = dlg.GetFileName();
}

输入了123作为文件名，得到123.txt。

  • 当默认扩展名为nullptr时，即使选择了过滤器也不会追加扩展名。
1
2
3
4
5
CFileDialog dlg(TRUE, nullptr, nullptr, 0, _T("ALL|*.*|TXT|*.txt||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();
    const auto fileName = dlg.GetFileName();
}

选择过滤器txt，输入123作为文件名将会得到123文件名，而不是123.txt。

#解决问题二

可以在第四个参数上指定OFN_FILEMUSTEXIST，意味着必须输入一个存在的文件名

1
2
3
4
5
CFileDialog dlg(TRUE, nullptr, nullptr, OFN_FILEMUSTEXIST, _T("ALL|*.*||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();
    const auto fileName = dlg.GetFileName();
}

如果用户输入123且文件不存在就会出现警告，这样可以保证DoModal返回时文件名必然有效。

#保存对话框

  • 当默认扩展名为nullptr时，即使选择了过滤器也不会追加扩展名。
1
2
3
4
5
CFileDialog dlg(FALSE, nullptr, nullptr, OFN_OVERWRITEPROMPT, _T("TXT|*.txt||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();  // ""
    const auto fileName = dlg.GetFileName(); // "123"
}

输入123得到123。

  • 以用户输入的扩展名为准。
1
2
3
4
5
CFileDialog dlg(FALSE, _T(""), nullptr, OFN_OVERWRITEPROMPT, _T("TXT|*.txt||"));
if (dlg.DoModal() == IDOK) {
    const auto ext = dlg.GetFileExt();
    const auto fileName = dlg.GetFileName();
}

输入123.doc得到123.doc，而不是123.txt。

#总结

  1. 如果用户输入了扩展名，则以用户输入为最终值。
  2. 如果用户未输入扩展名，且设置了默认扩展名，就先采用过滤器中的扩展名，只有用户选择通配符*.*时才采用默认扩展名。
  3. 默认扩展名为nullptr时，在任何情况下都不会自动追加扩展名。

#对于打开对话框

相信没有人会愿意打开不存在的文件，那么OFN_FILEMUSTEXIST几乎是必选项，而这正好也确保了文件名是正确的，所以默认扩展名可有可无。

#对于保存对话框

建议总是设置一个默认扩展名。如果默认扩展名为nullptr，即使选择了有效的过滤器，对话框则也不会追加扩展名，用户必须手动输入才行。

#参考

CFileDialog 类

上一页
下一页