如何在Windows C++程序中调用文件资源管理器并仅显示指定类型文件

不需要自行实现文件浏览流程，Windows提供原生API可直接调用，快速实现点击按钮打开文件资源管理器并过滤指定类型文件的需求，推荐两种常用方式：

1. 现代COM接口：IFileOpenDialog（推荐用于Windows 10/11） #

这是微软推荐的现代文件对话框接口，适配Windows 11视觉风格，代码示例如下：

#include <windows.h>
#include <shobjidl.h>
#include <iostream>

#pragma comment(lib, "ole32.lib")
#pragma comment(lib, "shell32.lib")

bool OpenFilteredFileDialog(const wchar_t* filterDesc, const wchar_t* filterExt) {
    HRESULT hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED | COINIT_DISABLE_OLE1DDE);
    if (FAILED(hr)) return false;

    IFileOpenDialog* pFileOpen = NULL;
    hr = CoCreateInstance(CLSID_FileOpenDialog, NULL, CLSCTX_ALL, IID_IFileOpenDialog, reinterpret_cast<void**>(&pFileOpen));
    if (SUCCEEDED(hr)) {
        // 设置文件过滤规则
        COMDLG_FILTERSPEC filterSpec[] = {
            { filterDesc, filterExt }
        };
        pFileOpen->SetFileTypes(ARRAYSIZE(filterSpec), filterSpec);
        pFileOpen->SetFileTypeIndex(1); // 默认选中第一个过滤规则

        // 显示对话框
        hr = pFileOpen->Show(NULL);
        if (SUCCEEDED(hr)) {
            IShellItem* pItem = NULL;
            hr = pFileOpen->GetResult(&pItem);
            if (SUCCEEDED(hr)) {
                PWSTR pszFilePath = NULL;
                hr = pItem->GetDisplayName(SIGDN_FILESYSPATH, &pszFilePath);
                if (SUCCEEDED(hr)) {
                    // 此处处理选中的文件路径，比如执行上传逻辑
                    wprintf(L"选中文件：%s\n", pszFilePath);
                    CoTaskMemFree(pszFilePath);
                }
                pItem->Release();
            }
        }
        pFileOpen->Release();
    }

    CoUninitialize();
    return SUCCEEDED(hr);
}

// 在按钮点击事件中调用示例
// OpenFilteredFileDialog(L"文本文件", L"*.txt;*.md");

2. 传统Win32 API：GetOpenFileName #

若需兼容旧版Windows，可使用该传统对话框，代码示例：

#include <windows.h>
#include <iostream>

bool OpenLegacyFilteredFileDialog(const char* filter) {
    OPENFILENAMEA ofn = { 0 };
    char szFile[260] = { 0 };

    ofn.lStructSize = sizeof(OPENFILENAMEA);
    ofn.hwndOwner = NULL;
    ofn.lpstrFile = szFile;
    ofn.nMaxFile = sizeof(szFile);
    ofn.lpstrFilter = filter;
    ofn.nFilterIndex = 1;
    ofn.Flags = OFN_PATHMUSTEXIST | OFN_FILEMUSTEXIST | OFN_NOCHANGEDIR;

    if (GetOpenFileNameA(&ofn) == TRUE) {
        // 处理选中的文件路径
        printf("选中文件：%s\n", ofn.lpstrFile);
        return true;
    }
    return false;
}

// 在按钮点击事件中调用示例
// OpenLegacyFilteredFileDialog("文本文件\0*.txt;*.md\0所有文件\0*.*\0");

关键说明 #

• 两种方式均无需自行实现文件浏览UI，直接调用系统原生对话框，符合Windows 11交互规范
• 通过设置过滤规则，可让对话框仅显示指定类型文件（多类型用分号分隔，如*.txt;*.png）
• 将调用逻辑放在按钮点击事件处理函数中即可，比如MFC的OnButtonUpload或Win32的WM_COMMAND消息处理分支里

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