如何使用Qt实现任务栏固定应用的路径控制

前置说明 #

任务栏固定应用属于Windows平台特有的功能设计，Qt框架本身未提供对应跨平台封装接口，所有管控操作需要结合Windows原生Shell API混合开发实现，仅适用于Windows系统，macOS、Linux等平台需单独适配对应桌面环境的规则。

环境配置 #

在Qt项目的.pro配置文件中添加以下Windows平台依赖：

• 引入Shell32库用于调用原生接口：win32: LIBS += -lshell32
• 配置管理员运行权限（部分操作需要高权限才能执行）：win32: QMAKE_LFLAGS += /MANIFESTUAC:\"level='requireAdministrator' uiAccess='false'\"

固定应用路径查询实现 #

Windows系统的任务栏固定项全部以快捷方式（.lnk）文件的形式存储在两个固定目录中：

• 用户级固定项存储路径：%APPDATA%\Microsoft\Internet Explorer\Quick Launch\User Pinned\TaskBar
• 系统公共级固定项存储路径：%ProgramData%\Microsoft\Internet Explorer\Quick Launch\User Pinned\TaskBar

查询逻辑如下：

1. 使用Qt的QDir类遍历上述两个目录下的所有后缀为.lnk的文件
2. 调用Windows原生IShellLink接口解析每个快捷方式对应的目标应用路径，参考实现代码如下：

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

QString parseLnkTargetPath(const QString& lnkFilePath) {
    HRESULT hr = CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED);
    if (FAILED(hr)) return {};

    IShellLinkW* pShellLink = nullptr;
    hr = CoCreateInstance(CLSID_ShellLink, nullptr, CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pShellLink));
    if (SUCCEEDED(hr)) {
        IPersistFile* pPersistFile = nullptr;
        hr = pShellLink->QueryInterface(IID_PPV_ARGS(&pPersistFile));
        if (SUCCEEDED(hr)) {
            hr = pPersistFile->Load(lnkFilePath.toStdWString().c_str(), STGM_READ);
            if (SUCCEEDED(hr)) {
                WCHAR targetPath[MAX_PATH] = {0};
                pShellLink->GetPath(targetPath, MAX_PATH, nullptr, SLGP_RAWPATH);
                pPersistFile->Release();
                pShellLink->Release();
                CoUninitialize();
                return QString::fromWCharArray(targetPath);
            }
            pPersistFile->Release();
        }
        pShellLink->Release();
    }
    CoUninitialize();
    return {};
}

固定应用调整管控实现 #

修改固定应用对应路径 #

直接通过IShellLink接口修改对应.lnk快捷方式的目标路径、启动参数、工作目录等字段，修改完成后调用IPersistFile::Save()接口保存修改，最后发送系统设置变更消息刷新任务栏即可生效：

// 刷新任务栏示例
SendMessageW(HWND_BROADCAST, WM_SETTINGCHANGE, 0, reinterpret_cast<LPARAM>(L"TraySettings"));

注意：Win10 1709及更高版本的Windows系统对任务栏固定项的操作做了权限限制，直接修改快捷方式可能会被系统还原，建议搭配系统组策略配置一同使用。

新增/删除固定应用 #

• Win7、早期Win10版本可直接在对应存储目录新增/删除.lnk文件，刷新任务栏后即可生效
• 高版本Windows不允许程序直接修改固定项列表，需要调用Shell公开的动词操作接口，或者通过模拟用户右键菜单点击的方式实现。

注意事项 #

• 所有操作执行前建议先校验程序是否有管理员权限，无权限时部分操作会静默失败
• 不同版本Windows的任务栏固定逻辑存在差异，建议做版本兼容判断

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