Windows下为Qt应用添加右键菜单/Shell扩展实现文件打开功能

该需求无需开发Windows Shell扩展，也不用调用原生Windows API，用Qt自带组件或Qt Installer Framework（IFW）即可实现，全程可使用C++/QS脚本完成，门槛极低。

Windows资源管理器调用你的程序时，会自动把选中的文件路径作为启动参数传入，直接通过main函数的参数列表就能获取，无需额外开发，示例代码如下：

#include <QApplication>
#include <QFile>
#include <QDebug>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    // 接收右键菜单传入的文件路径
    QString targetFilePath;
    if (argc > 1) {
        // argv[1]就是选中文件的完整本地路径
        targetFilePath = QString::fromLocal8Bit(argv[1]);
        // 这里添加你自己的文件打开逻辑即可
        qDebug() << "待打开的文件路径：" << targetFilePath;
    }

    // 你的其他业务逻辑
    // MainWindow w;
    // w.show();

    return a.exec();
}

方案A：使用Qt Installer Framework安装时自动配置（推荐，适合发布安装包的场景） #

你提到的installscript.qs就是Qt IFW的安装脚本，可以直接操作Windows注册表完成菜单配置，无需额外编码。

1. 编写installscript.qs脚本 #

function Component()
{
    component.loaded.connect(this, function() {
        // 安装完成后执行注册表写入
        if (installer.isInstaller()) {
            component.installationFinished.connect(this, registerContextMenu);
        }
        // 卸载时删除注册表配置
        if (installer.isUninstaller()) {
            component.uninstallationStarted.connect(this, unregisterContextMenu);
        }
    });
}

function registerContextMenu() {
    // 替换为你的应用信息
    const appName = "MyQtAppName";
    const appExePath = installer.value("TargetDir") + "/MyQtAppName.exe"; // 安装目录下的exe路径
    const supportSuffixes = [".jpg", ".jpeg", ".png", ".gif"]; // 需要关联的后缀

    // 给每个后缀添加右键菜单
    supportSuffixes.forEach(suffix => {
        // 写注册表：HKEY_CLASSES_ROOT\后缀\shell\菜单名
        installer.setValue("HKEY_CLASSES_ROOT\\" + suffix + "\\shell\\" + appName + "\\", "默认", "使用" + appName + "编辑");
        // 设置菜单图标（可选，替换为你的exe路径即可自动提取exe图标）
        installer.setValue("HKEY_CLASSES_ROOT\\" + suffix + "\\shell\\" + appName + "\\", "Icon", appExePath);
        // 设置点击菜单后执行的命令，%1就是文件路径占位符
        installer.setValue("HKEY_CLASSES_ROOT\\" + suffix + "\\shell\\" + appName + "\\command\\", "默认", "\"" + appExePath + "\" \"%1\"");
    });
}

function unregisterContextMenu() {
    const appName = "MyQtAppName";
    const supportSuffixes = [".jpg", ".jpeg", ".png", ".gif"];
    supportSuffixes.forEach(suffix => {
        installer.deleteValue("HKEY_CLASSES_ROOT\\" + suffix + "\\shell\\" + appName + "\\");
    });
}

2. 配置package.xml #

在你的安装包对应组件的package.xml中添加以下内容，声明使用该安装脚本：

<Script>installscript.qs</Script>

重新打包安装程序后，用户安装软件时会自动注册右键菜单，卸载时自动删除，无需用户手动操作。

方案B：应用内手动注册（适合绿色版软件，无需安装包） #

用Qt自带的QSettings类即可直接操作Windows注册表，无需调用任何原生API：

#include <QSettings>
#include <QCoreApplication>

void registerContextMenu()
{
    const QString appName = "MyQtAppName";
    const QString appExePath = QCoreApplication::applicationFilePath(); // 自动获取当前exe路径
    const QStringList supportSuffixes = {".jpg", ".jpeg", ".png", ".gif"};

    QSettings reg("HKEY_CLASSES_ROOT", QSettings::NativeFormat);
    for (const QString& suffix : supportSuffixes) {
        // 写入菜单名称
        reg.setValue(suffix + "/shell/" + appName + "/.", "使用" + appName + "编辑");
        // 写入菜单图标
        reg.setValue(suffix + "/shell/" + appName + "/Icon", appExePath);
        // 写入执行命令
        reg.setValue(suffix + "/shell/" + appName + "/command/.", QString("\"%1\" \"%2\"").arg(appExePath, "%1"));
    }
}

// 取消关联时调用
void unregisterContextMenu()
{
    const QString appName = "MyQtAppName";
    const QStringList supportSuffixes = {".jpg", ".jpeg", ".png", ".gif"};
    QSettings reg("HKEY_CLASSES_ROOT", QSettings::NativeFormat);
    for (const QString& suffix : supportSuffixes) {
        reg.remove(suffix + "/shell/" + appName + "/");
    }
}

说明：可以在应用首次启动时弹窗询问用户是否要关联右键菜单，用户同意后调用上述registerContextMenu函数即可，调用时需要管理员权限（因为要修改HKEY_CLASSES_ROOT注册表项）。

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