Qt之QAbstractItemView視圖項拖拽(一)

一、需求說明   

     最近在搞視圖項的拖拽，也上網查了一些資料，好多的文檔都是一樣的，只是被不通的網站所收錄了(也有可能是被爬過去的，不明所以)，不過也有一些文檔寫的不錯，不過就是太簡易，都是點睛之筆，總之功能還是勉強可以實現，加之比較零散，剛好我自己也因為這個需求寫了一個demo，因此我就把自己寫這個demo的過程分析給大家，希望能幫到有這個需求的小伙伴。

二、效果展示   

    如圖1是demo的效果展示，比較丑，如果加上優秀的qss，那必然能讓人眼前一亮。

圖1 ListWidget拖拽

三、實現思路

1. 繼承QListWidget類，重寫其鼠標多拽時幾個虛方法，分別是：dragEnterEvent(鼠標拖拽進入)，dragLeaveEvent(鼠標拖拽時離開)，dragMoveEvent(拖拽時移動)，dropEvent(鼠標釋放)，(mousePressEvent)鼠標按下，mouseMoveEvent(鼠標移動)等。
2. 鼠標按下時，記錄鼠標按下位置和鼠標點擊項    
3. 鼠標移動時構造一個QDrag對象，並且執行其exec方法，這個方法執行后，直到dropEvent觸發后，mouseMoveEvent方法才會被再次觸發，否則鼠標移動消息一直派發給dragMouseEvent。exec方法的之后，后續的鼠標事件都會在drag打頭的方法中回調。  
4. 拖拽期間，鼠標移動，並回調在dragMoveEvent方法中，可以在這個方法中修改鼠標狀態。維護一些變量，比如效果圖上跟隨鼠標一起移動的一張圖片和綠色的指示插入位置的一條線。
5. 最后鼠標釋放時，判斷如果需要更新拖拽項位置，那么把原有項刪除，並構造新的項插入到目標位置。

四、代碼說明

1、首先來看幾個關鍵的類
    MimeData：存儲拖拽時數據
    ListItem：item項定制，展示自定義結構
    DragList：視圖窗口
2、下面就直接上代碼，步驟對應第三小節的思路

a、記錄鼠標按下時信息

void DragList::mousePressEvent(QMouseEvent *event)
{
    if (event->button() == Qt::LeftButton)
    {
        startPos = event->pos();
        dragItem = itemAt(event->pos());
    }
    QListWidget::mousePressEvent(event);
}

b、鼠標移動時啟動QDrag，鼠標移動事件此后進入drag相關函數，直到dropEvent函數被調用

void DragList::mouseMoveEvent(QMouseEvent * event)
{
    QListWidgetItem * item = itemAt(event->pos());
    if (dragItem == nullptr)
    {
        return;
    }

    m_Drag = new QDrag(this);

    ListItem * itemWidget = nullptr;
    if (itemWidget = ItemWidget(dragItem))
    {
        MimeData * mimeData = new MimeData(itemWidget->GetData());
        m_Drag->setMimeData(mimeData);
    }

    m_Drag->setDragCursor(style()->standardPixmap(QStyle::SP_TitleBarMinButton), Qt::LinkAction);
    m_Drag->setDragCursor(style()->standardPixmap(QStyle::SP_TitleBarMaxButton), Qt::MoveAction);

    m_Drag->setHotSpot(QPoint(0, -m_Drag->pixmap().height() * 2));
    Qt::DropAction dropAction = m_Drag->exec(Qt::MoveAction | Qt::LinkAction, Qt::LinkAction);
    if (dropAction == Qt::MoveAction)
    {
        if (itemWidget)
        {
            itemWidget->deleteLater();
        }
        delete dragItem;//刪除原有的item,在dropEvent(QDropEvent *event)函數中插入item  
    }

    QListWidget::mouseMoveEvent(event);
}

c、鼠標拖拽時移動

void DragList::dragMoveEvent(QDragMoveEvent * event)
{
    DragList * source = (DragList *)((void *)(event->source()));
    if (source && source == this) 
    {
        QListWidgetItem * item = itemAt(event->pos());
        if (dragItem != nullptr && item != nullptr && m_Drag != nullptr)
        {
            if ((dragItem == item) != m_IsSelf)
            {
                m_IsSelf = dragItem == item;

                if (m_IsSelf)
                {
                    event->setDropAction(Qt::LinkAction);
                }
                else
                {
                    event->setDropAction(Qt::MoveAction);
                }
            }
        }

        if (m_ShotPicture == nullptr)
        {
            InitShotLabel();
        }

        if (ListItem * newWidget = ItemWidget(dragItem))
        {
            m_ShotPicture->move(mapToGlobal(event->pos() - newWidget->mapFromParent(startPos)));
        }

        event->accept();
    }
}

d、鼠標釋放時處理拖拽結果

void DragList::dropEvent(QDropEvent * event)
{
    if (m_ShotPicture)
    {
        m_ShotPicture->close();
        m_ShotPicture->deleteLater();
        m_ShotPicture = nullptr;
    }
    DragList * source = (DragList *)((void *)(event->source()));
    if (source && source == this)
    {
        endPos = event->pos();//得到鼠標移動到的坐標  
        QListWidgetItem * itemRow = itemAt(endPos); //通過endPos獲取鼠標位置所在的行  
        if (itemRow == dragItem)
        {
            event->setDropAction(Qt::LinkAction);
        }
        else
        {
            int insertPos = row(itemRow);
            if (ListItem * oldWidget = ItemWidget(itemRow))
            {
                QPoint pos = oldWidget->mapFromParent(endPos);
                if (oldWidget->size().height() / 2 < pos.y())
                {
                    insertPos += 1;
                }
            }

            if (const MimeData * mimeData = dynamic_cast<const MimeData *>(event->mimeData()))
            {
                QListWidgetItem * newItem = new QListWidgetItem;
                ListItem * itemWidget = new ListItem;
                ItemData data = mimeData->GetData();
                itemWidget->SetData(data);

                insertItem(insertPos, newItem);
                setItemWidget(newItem, itemWidget);
            }
            event->setDropAction(Qt::MoveAction);
        }

        m_IsSelf = false;
        event->accept();
    }
}

e、初始化跟隨鼠標移動的label，並把當前拖拽的窗口截圖設置給label

void DragList::InitShotLabel()
{
    m_ShotPicture = new QLabel;
    m_ShotPicture->setWindowOpacity(0.5);
    m_ShotPicture->setWindowFlags(Qt::Popup);
    m_ShotPicture->setAttribute(Qt::WA_TransparentForMouseEvents, true);

    SetWindowLong((HWND)m_ShotPicture->winId(), GWL_EXSTYLE, GetWindowLong((HWND)m_ShotPicture->winId(), GWL_EXSTYLE) |
        WS_EX_TRANSPARENT//忽略一切消息（WM_PAINT除外）
        | WS_EX_LAYERED);

    if (ListItem * oldWidget = ItemWidget(dragItem))
    {
        m_ShotPicture->resize(oldWidget->size());
        m_ShotPicture->setPixmap(oldWidget->grab());
    }
    m_ShotPicture->show();
}

五、下載鏈接

　　Qt之QAbstractItemView視圖項拖拽

六、相關文章

    自定義拖放數據：這篇文章是講述怎么自定義QMimeData數據的，我使用的是其中第二個方法。

　 Qt之QAbstractItemView選擇無焦點
   

如果您覺得文章不錯，不妨給個 打賞，寫作不易，感謝各位的支持。您的支持是我最大的動力，謝謝！！！ 

---

 

  

---

很重要--轉載聲明

1. 本站文章無特別說明，皆為原創，版權所有，轉載時請用鏈接的方式，給出原文出處。同時寫上原作者：朝十晚八 or Twowords
2. 如要轉載，請原文轉載，如在轉載時修改本文，請事先告知，謝絕在轉載時通過修改本文達到有利於轉載者的目的。 

---

奮斗中的無名小卒。。。