Qt Creator中如何实现ListView右键点击弹出Windows popup menu？

实现逻辑 #

要弹出和Windows资源管理器完全一致的原生右键菜单，不能直接使用Qt自绘的QMenu控件，需要通过Windows Shell API获取对应文件/文件夹条目绑定的系统上下文菜单，再在右键点击位置触发弹出。

具体操作步骤 #

• 配置ListView的右键响应策略
  首先给目标ListView设置自定义上下文菜单策略，否则控件不会主动抛出右键点击事件：

  // 可以在窗口构造函数里添加这段配置
  ui->listView->setContextMenuPolicy(Qt::CustomContextMenu);
  

• 绑定右键点击信号到自定义处理槽
  关联控件的customContextMenuRequested信号，该信号会在用户右键点击控件时抛出，参数为点击位置相对于控件的局部坐标：

  connect(ui->listView, &QListView::customContextMenuRequested,
          this, &MainWindow::handleListViewRightClick);
  

• 实现右键点击槽函数，获取点击条目对应的路径
  先通过坐标换算拿到点击位置对应的模型索引，判断是否点击在有效条目上，再从模型中取出该条目对应的文件绝对路径，最后把坐标转成全局屏幕坐标传给菜单弹出函数：

  void MainWindow::handleListViewRightClick(const QPoint &localPos)
  {
      QModelIndex clickedIndex = ui->listView->indexAt(localPos);
      if (!clickedIndex.isValid()) {
          // 点在空白区域的逻辑可自行扩展，比如弹出文件夹空白处的原生菜单
          return;
      }
      // 如果用QFileSystemModel直接取FilePathRole即可，自定义模型就取存储路径的对应角色
      QString itemAbsPath = clickedIndex.data(QFileSystemModel::FilePathRole).toString();
      QPoint globalPos = ui->listView->mapToGlobal(localPos);
      showWinNativeContextMenu(itemAbsPath, globalPos);
  }
  

• 编写Windows原生菜单弹出函数
  这部分代码调用Windows Shell接口获取系统原生菜单并弹出，所有Windows平台专属代码必须用Q_OS_WIN宏包裹，避免跨平台编译报错：

  #ifdef Q_OS_WIN
  #include <windows.h>
  #include <shobjidl.h>
  #include <shlobj.h>
  
  void showWinNativeContextMenu(const QString &itemPath, const QPoint &globalPos)
  {
      std::wstring widePath = itemPath.toStdWString();
      LPITEMIDLIST pidl = nullptr;
      SFGAOF flag;
      // 解析路径为系统可识别的PIDL结构
      if (FAILED(SHParseDisplayName(widePath.c_str(), nullptr, &pidl, 0, &flag))) {
          return;
      }
  
      IShellFolder* parentFolder = nullptr;
      LPCITEMIDLIST childPidl = nullptr;
      // 绑定父文件夹Shell接口
      if (FAILED(SHBindToParent(pidl, IID_IShellFolder, (void**)&parentFolder, &childPidl))) {
          CoTaskMemFree(pidl);
          return;
      }
  
      IContextMenu* contextMenu = nullptr;
      // 获取条目对应的原生上下文菜单接口
      if (FAILED(parentFolder->GetUIObjectOf(nullptr, 1, (LPCITEMIDLIST*)&childPidl, 
                                              IID_IContextMenu, nullptr, (void**)&contextMenu))) {
          parentFolder->Release();
          CoTaskMemFree(pidl);
          return;
      }
  
      HMENU hMenu = CreatePopupMenu();
      // 填充原生菜单项
      if (SUCCEEDED(contextMenu->QueryContextMenu(hMenu, 0, 1, 0x7FFF, CMF_NORMAL))) {
          // 弹出菜单并获取用户选中的命令ID
          int cmdId = TrackPopupMenu(hMenu, TPM_RETURNCMD | TPM_LEFTBUTTON,
                                      globalPos.x(), globalPos.y(), 0,
                                      GetForegroundWindow(), nullptr);
          // 执行用户选中的菜单命令
          if (cmdId > 0) {
              CMINVOKECOMMANDINFO cmdInfo = {sizeof(CMINVOKECOMMANDINFO)};
              cmdInfo.lpVerb = MAKEINTRESOURCEA(cmdId - 1);
              cmdInfo.nShow = SW_SHOWNORMAL;
              contextMenu->InvokeCommand(&cmdInfo);
          }
      }
  
      // 释放所有资源，避免内存泄漏
      DestroyMenu(hMenu);
      contextMenu->Release();
      parentFolder->Release();
      CoTaskMemFree(pidl);
  }
  #endif
  

注意事项 #

• 必须在项目.pro文件中加入LIBS += -lshell32 -lole32配置，链接Windows Shell对应的系统库，否则编译时会报接口未定义错误。
• 如果使用自定义数据模型展示文件列表，不需要强制依赖QFileSystemModel，只要能从点击的QModelIndex中取出对应条目的绝对路径即可。
• 如果需要实现点击ListView空白区域弹出当前文件夹的原生右键菜单，只需要在clickedIndex.isValid()为false时，传入当前展示的文件夹根路径调用弹出函数即可。
• 所有调用Windows API的代码必须放在Q_OS_WIN宏块内，否则在Linux、macOS平台编译会直接报错。

内容的提问来源于stack exchange，提问作者Miguel Casales Fong