PyQt5的拖放

拖放涉及到的主要的一些類如下所示：

一、拖放的基本原理

1.1 拖放的動作

拖放操作包括兩個動作：

• 拖動(drag)
• 放下(drop 或稱為放置)。

當(dāng)被拖動時拖動的數(shù)據(jù)會被存儲為 MIME 類型的對象， MIME 類型使用 QMimeData 類來描述。 MIME 類型通常由剪貼板和拖放系統(tǒng)使用，以識別不同類型的數(shù)據(jù)。

• 拖動點(diǎn)(drag site)：拖動的起始位置。
• 放下點(diǎn)(drop site)：被拖動的對象放下的位置，若部件不能接受拖動的對象， Qt 會改變光標(biāo)的形狀(一個禁用形狀)來向用戶進(jìn)行說明。

1.2 拖動的啟動和結(jié)束

啟動拖放：

拖放通過調(diào)用 QDrag::exec()函數(shù)而啟動，該函數(shù)是一個阻塞函數(shù)(但不會阻塞主事件循環(huán))，這意味著在拖放操作結(jié)束之前，不會返回該函數(shù)，調(diào)用 QDrag::exec()函數(shù)后， Qt 擁有對拖動對象的所有權(quán)，并會在必要時將其刪除。

結(jié)束拖放：

當(dāng)用戶放下拖動或取消拖動操作時結(jié)束拖放。

1.3 拖放產(chǎn)生的過程和事件

啟動拖放后，會使數(shù)據(jù)被拖動，這時需要按住鼠標(biāo)按鍵才能拖動需要拖動的數(shù)據(jù)，松開鼠標(biāo)按鍵時意味著拖動結(jié)束。

默認(rèn)情況下，部件不接受放下事件。使用 QWidget::setAcceptDrops()函數(shù)可設(shè)置部件是否接受放下事件(即，拖放完成時發(fā)送的事件)。只有在部件接受放下事件的情形下，才會產(chǎn)生以下事件。

QDragEnterEvent：拖動進(jìn)入事件

當(dāng)拖動操作進(jìn)入部件時，該事件被發(fā)送到部件，忽略該事件，將會導(dǎo)至后續(xù)的拖放事件不能被發(fā)送。 通常在該部件上光標(biāo)會在外觀上顯示為禁用的圖形。

QDragMoveEvnet：拖動移動事件

當(dāng)拖動操作正在進(jìn)行時，以及當(dāng)具有焦點(diǎn)時按下鍵盤的修飾鍵(比如 Ctrl)時， 發(fā)送該事件， 要使部件能接收到該事件，則該部件必須接受 QDragEnterEvent 事件。

QDropEvent：放下事件

在完成拖放操作時發(fā)送該事件，即當(dāng)用戶在部件上放下一個對象時，發(fā)送此事件。要使部件能接收到該事件，則該部件必須接受 QDragEnterEvent事件，且不能忽略 QDragMoveEvnt 事件。

QLeaveEvent：當(dāng)拖放操作離開部件時發(fā)送該事件

注意：要使部件能接收到該事件，必須要使拖動先進(jìn)入該部件(即產(chǎn)生 QDragEnterEvent 事件)，然后再離開該部件，才會產(chǎn)生 QLeaveEvent 事件。因很少使用該事件，因此本文不做重點(diǎn)介紹。

上文中提到的必須接受是指必須重新實現(xiàn)該事件的處理函數(shù)并接受該事件，不能忽略是指在處件事理函數(shù)中不明確調(diào)用 ignore()函數(shù)忽略該事件，這意味著可以不必重新實現(xiàn)該事件的處理函數(shù)。

以上事件產(chǎn)生的順序為： QDragEnterEvent、 QDragMoveEvnet、 QDropEvent

1.4 編寫拖放程序的步驟

在需要接受放下數(shù)據(jù)的部件上調(diào)用 QWidget::setAcceptDrops()函數(shù)以使該部件能接受拖放事件。

啟動拖放： 通常在 mousePressEvent()或 mouseMoveEvent()函數(shù)中啟動拖放，記住啟動拖放就是調(diào)用 QDrag 對象的 exec()函數(shù)，因此也可以在 keyPressEvent()等函數(shù)中啟動拖放(因很少這樣做，所以本文不介紹這種情況下的拖放)。 在此步把需要拖動的數(shù)據(jù)保存在 QMimeData 對象中。

重新實現(xiàn)需要接受放下數(shù)據(jù)的部件的 dragEnterEvent()事件處理函數(shù)。

根據(jù)需要重新實現(xiàn) dragMoveEvent 或 dropEvent()函數(shù)

1.5 簡單的拖放示例代碼

本示例程序示范了如何把數(shù)據(jù)從按鈕A拖至按鈕B:

from PyQt5.QtWidgets import QApplication, QWidget, QPushButton, QHBoxLayout
from PyQt5.QtCore import QMimeData, qDebug
from PyQt5 import QtGui
from PyQt5.QtGui import QDrag
import sys

???????class MyButton(QPushButton):
    def __init__(self, text:str) -> None:
        super().__init__(text)
        
    def mousePressEvent(self, e: QtGui.QMouseEvent) -> None:
        '''
        在該事件中啟動拖放
        '''
        # 將需要拖動的數(shù)據(jù)放入QMimeData對象中，該對象用于保存需要傳遞的數(shù)據(jù)
        # 數(shù)據(jù)的內(nèi)容完全由程序員自行設(shè)定。通常為界面上所選擇的內(nèi)容。
        my_mime_data = QMimeData()
        
        # 這是QMimeData中存儲的內(nèi)容，即拖放的數(shù)據(jù)
        my_mime_data.setText(self.text())
        
        # 設(shè)置拖動的數(shù)據(jù)，該函數(shù)會獲得QMimeData的所有權(quán)
        my_drag = QDrag(self)
        my_drag.setMimeData(my_mime_data)
        
        # 啟動拖放
        my_drag.exec_()
        
    def dragEnterEvent(self, e: QtGui.QDragEnterEvent) -> None:
        '''
        處理是否接受拖動事件
        '''
        # 接受拖動進(jìn)入事件
        e.accept()
        
        # 若忽略該事件，則不會再發(fā)送之后的事件，拖放至此結(jié)束，這會導(dǎo)致鼠標(biāo)光標(biāo)顯示為禁用的圖形
        # e.ignore()
        
    def dropEvent(self, e: QtGui.QDropEvent) -> None:
        '''
        處理拖動的數(shù)據(jù)（當(dāng)然了，也可以不做任何處理）
        '''
        # 設(shè)置此部件的文本為拖動對象中的文本
        self.setText(e.mimeData().text())
        
        # 此事件不影響后續(xù)事件，可接受也可忽略
        # e.accept()
        # e.ignore()
        
class MyWidget(QWidget):
    def __init__(self, parent=None) -> None:
        super().__init__(parent)
        self.__init_ui()
        
    def __init_ui(self):
        btn_a = MyButton('AAA')
        btn_b = MyButton('BBB')
        btn_a.setAcceptDrops(False)
        btn_b.setAcceptDrops(True)
        
        layout = QHBoxLayout()
        layout.addWidget(btn_a)
        layout.addWidget(btn_b)
        self.setLayout(layout)
        
if __name__ == '__main__':
    app = QApplication(sys.argv)
    my_widget = MyWidget()
    my_widget.show()
    sys.exit(app.exec_())

運(yùn)行效果如下：

原始狀態(tài)：

在按鈕AAA上按下鼠標(biāo)左鍵不動并拖動到圖示位置，由于主窗口不接受放下事件，因此光標(biāo)顯示為禁用的狀態(tài)

拖動AAA到按鈕BBB上時，會發(fā)送QDragEnterEvent事件，同時光標(biāo)改變形狀，表示BBB按鈕可以接受拖動的數(shù)據(jù)，

在按鈕BBB上釋放鼠標(biāo)時，此時發(fā)送QDropEvent事件，按鈕BBB的文本被修改為拖動對象中保存的數(shù)據(jù)。

至此，拖動結(jié)束。

到此這篇關(guān)于Python PyQt5實現(xiàn)拖放效果的原理詳解的文章就介紹到這了,更多相關(guān)Python PyQt5拖放內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論