CFileDialog 扩展名注意事项
2024-03-17 17:33:41 #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 类

上一页
2024-03-17 17:33:41 #MFC
下一页