QTable搭配QFileSystemModel时拖拽复制功能无法实现的问题

你遇到的核心问题是：MainWindow的拖拽事件仅响应窗口级别的拖拽（比如拖出表格），而表格内部的拖拽事件由QTableView本身处理，所以需要自定义QTableView子类，重写它的拖拽相关方法来实现需求。

解决方案步骤 #

1. 自定义QTableView子类，接管表格内部的拖拽事件
2. 重写拖拽事件方法，处理文件复制与覆盖逻辑
3. 确保QFileSystemModel和表格的拖拽配置正确

完整代码实现 #

自定义FileTableView类

#include <QTableView>
#include <QDragEnterEvent>
#include <QDragMoveEvent>
#include <QDropEvent>
#include <QMessageBox>
#include <QFileSystemModel>
#include <QUrl>
#include <QFile>

class FileTableView : public QTableView
{
    Q_OBJECT
public:
    explicit FileTableView(QWidget *parent = nullptr) : QTableView(parent)
    {
        // 配置拖拽基础属性
        setDragEnabled(true);
        setAcceptDrops(true);
        setDropIndicatorShown(true);
        setDragDropMode(QAbstractItemView::DragDrop);
        setDefaultDropAction(Qt::CopyAction); // 默认复制动作
    }

protected:
    // 拖拽进入表格时触发
    void dragEnterEvent(QDragEnterEvent *event) override
    {
        if (event->mimeData()->hasUrls()) {
            event->acceptProposedAction();
        } else {
            QTableView::dragEnterEvent(event);
        }
    }

    // 拖拽在表格内移动时触发
    void dragMoveEvent(QDragMoveEvent *event) override
    {
        if (event->mimeData()->hasUrls()) {
            event->acceptProposedAction();
        } else {
            QTableView::dragMoveEvent(event);
        }
    }

    // 拖拽释放时处理文件复制与覆盖
    void dropEvent(QDropEvent *event) override
    {
        if (!event->mimeData()->hasUrls()) {
            QTableView::dropEvent(event);
            return;
        }

        QFileSystemModel* fileModel = qobject_cast<QFileSystemModel*>(model());
        if (!fileModel) return;

        // 获取目标路径：如果拖到文件上，取文件所在目录；拖到空白处取当前根目录
        QModelIndex targetIdx = indexAt(event->pos());
        QString targetPath;
        if (targetIdx.isValid()) {
            QFileInfo targetInfo = fileModel->fileInfo(targetIdx);
            targetPath = targetInfo.isDir() ? targetInfo.absoluteFilePath() : targetInfo.dir().absolutePath();
        } else {
            targetPath = fileModel->rootPath();
        }

        // 遍历拖拽的所有文件/文件夹
        for (const QUrl& url : event->mimeData()->urls()) {
            QString sourcePath = url.toLocalFile();
            QFileInfo sourceInfo(sourcePath);
            QString destPath = QString("%1/%2").arg(targetPath, sourceInfo.fileName());

            // 处理文件覆盖逻辑
            if (QFile::exists(destPath)) {
                QMessageBox::StandardButton reply = QMessageBox::question(
                    this, "确认覆盖",
                    QString("文件「%1」已存在，是否覆盖？").arg(sourceInfo.fileName()),
                    QMessageBox::Yes | QMessageBox::No
                );
                if (reply == QMessageBox::Yes) {
                    QFile::remove(destPath);
                    QFile::copy(sourcePath, destPath);
                }
            } else {
                QFile::copy(sourcePath, destPath);
            }
        }

        event->acceptProposedAction();
        fileModel->refresh(); // 刷新模型，显示新复制的文件
    }

    // 启动拖拽时，传递正确的文件路径数据
    void startDrag(Qt::DropActions supportedActions) override
    {
        QModelIndexList selectedIdx = selectedIndexes();
        if (selectedIdx.isEmpty()) {
            QTableView::startDrag(supportedActions);
            return;
        }

        QMimeData* mimeData = new QMimeData();
        QList<QUrl> urls;
        QFileSystemModel* fileModel = qobject_cast<QFileSystemModel*>(model());
        if (fileModel) {
            for (const QModelIndex& idx : selectedIdx) {
                if (idx.isValid()) {
                    urls.append(QUrl::fromLocalFile(fileModel->filePath(idx)));
                }
            }
            mimeData->setUrls(urls);
        }

        QDrag* drag = new QDrag(this);
        drag->setMimeData(mimeData);
        drag->exec(supportedActions, defaultDropAction());
    }
};

在MainWindow中使用自定义表格

#include "FileTableView.h"
#include <QFileSystemModel>
#include <QMainWindow>

MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent)
{
    FileTableView* tableView = new FileTableView(this);
    QFileSystemModel* fileModel = new QFileSystemModel(this);
    
    fileModel->setReadOnly(false); // 必须开启可写
    fileModel->setRootPath(QDir::homePath());
    
    tableView->setModel(fileModel);
    tableView->setRootIndex(fileModel->index(QDir::homePath()));
    
    setCentralWidget(tableView);
}

关键说明 #

• 事件接管：表格内部的拖拽事件由QTableView处理，而非MainWindow，所以必须重写QTableView的拖拽方法
• 数据传递：startDrag方法确保拖拽时传递的是本地文件URL，让drop事件能正确识别文件路径
• 覆盖逻辑：在dropEvent中判断目标路径是否存在文件，通过弹窗确认后执行覆盖操作
• 模型刷新：复制完成后调用refresh()更新视图，确保新文件立即显示

内容的提问来源于stack exchange，提问作者Илья Горбатюк