调用CFileDialog的SetControlText时如何避免无效参数异常

问题分析 #

你遇到的异常根源在于旧版控件IDcmb13在现代Windows的资源管理器风格文件对话框中已不再有效。尽管你添加了OFN_EXPLORER标志，但该标志启用的是新的对话框架构，控件结构与旧版完全不同，直接使用cmb13会导致找不到目标控件，从而触发参数无效异常。

此外，原代码中直接拼接后缀的逻辑存在缺陷：如果用户已经输入了后缀，会导致重复添加（例如file.tif.tif）。

正确实现方案 #

改用MFC CFileDialog提供的标准接口修改文件名，而非直接操作底层控件，同时优化后缀处理逻辑：

修正后的CSaveMaskDlg代码 #

// 原FILE_DIALOG_NAME宏已不再使用，可删除

// CStarMaskDlg dialog
/* ------------------------------------------------------------------- */

class CSaveMaskDlg : public CFileDialog
{
    DECLARE_DYNAMIC(CSaveMaskDlg)

public :
    CSaveMaskDlg(bool bOpenFileDialog, 
        LPCTSTR lpszDefExt = nullptr,
        LPCTSTR lpszFileName = nullptr,
        DWORD dwFlags = OFN_HIDEREADONLY | OFN_OVERWRITEPROMPT | OFN_EXPLORER,
        LPCTSTR lpszFilter = nullptr,
        CWnd* pParentWnd = nullptr)
        : CFileDialog(bOpenFileDialog, lpszDefExt, lpszFileName, dwFlags, lpszFilter, pParentWnd)
    {
    };
    virtual ~CSaveMaskDlg() {};

protected:
    virtual void OnTypeChange()
    {
        // 调用基类完成默认处理
        CFileDialog::OnTypeChange();

        CString strFileName = GetFileTitle();
        if (strFileName.IsEmpty())
            return;

        // 移除已存在的目标后缀，避免重复拼接
        int dotPos = strFileName.ReverseFind('.');
        if (dotPos != -1)
        {
            CString ext = strFileName.Mid(dotPos + 1);
            if (ext.CompareNoCase(_T("tif")) == 0 || ext.CompareNoCase(_T("fits")) == 0)
            {
                strFileName = strFileName.Left(dotPos);
            }
        }

        // 根据当前过滤器索引添加对应后缀
        if (m_ofn.nFilterIndex == 1)
            strFileName += _T(".tif");
        else
            strFileName += _T(".fits");

        // 使用MFC标准接口更新文件名，兼容所有Windows版本
        SetPathName(strFileName);
    };
};
IMPLEMENT_DYNAMIC(CSaveMaskDlg, CFileDialog)

/* ------------------------------------------------------------------- */

IMPLEMENT_DYNAMIC(CStarMaskDlg, CDialog)

关键改进点 #

1. 替换控件操作方式：用SetPathName替代SetControlText，该方法是MFC为CFileDialog提供的标准接口，会自动处理不同Windows版本的对话框架构，避免直接操作控件的兼容性问题。
2. 优化后缀处理：先检查并移除已存在的目标后缀，防止重复添加。
3. 保留兼容性标志：继续保留OFN_EXPLORER标志，确保对话框以资源管理器风格运行。

内容的提问来源于stack exchange，提问作者David Partridge