在PyQt5中拖放

在PyQt5教程的这一部分中，我们将讨论拖放操作。

在计算机图形用户界面中，拖放是单击虚拟对象并将其拖到不同位置或另一个虚拟对象上的操作(或支持操作)。通常，它可用于调用多种操作，或在两个抽象对象之间创建各种类型的关联。

拖放是图形用户界面的一部分。拖放操作使用户能够直观地完成复杂的操作。

通常，我们可以拖放两种东西:数据或一些图形对象。如果我们将图像从一个应用程序拖到另一个应用程序，我们将拖放二进制数据。如果我们在Firefox中拖动一个选项卡并将其移动到另一个位置，那么我们就拖放了一个图形组件。

QDrag

QDrag支持基于mime的拖放数据传输。它处理拖放操作的大部分细节。传输的数据包含在QMimeData对象中。

PyQt5中的简单拖放示例

在第一个例子中，我们有一个QLineEdit和一个QPushButton。我们从行编辑小部件中拖动纯文本，并将其放到按钮小部件上。按钮的标签将改变。

simple_dragdrop.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

This is a simple drag and
drop example.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys

from PyQt5.QtWidgets import (QPushButton, QWidget,
                             QLineEdit, QApplication)


class Button(QPushButton):

    def __init__(self, title, parent):
        super().__init__(title, parent)

        self.setAcceptDrops(True)

    def dragEnterEvent(self, e):

        if e.mimeData().hasFormat('text/plain'):
            e.accept()
        else:
            e.ignore()

    def dropEvent(self, e):

        self.setText(e.mimeData().text())


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        edit = QLineEdit('', self)
        edit.setDragEnabled(True)
        edit.move(30, 65)

        button = Button("Button", self)
        button.move(190, 65)

        self.setWindowTitle('Simple drag and drop')
        self.setGeometry(300, 300, 300, 150)


def main():

    app = QApplication(sys.argv)
    ex = Example()
    ex.show()
    app.exec_()


if __name__ == '__main__':
    main()

这个例子展示了一个简单的拖放操作。

class Button(QPushButton):

    def __init__(self, title, parent):
        super().__init__(title, parent)

        ...

为了在QPushButton小部件上放置文本，我们必须重新实现一些方法。因此，我们创建了自己的Button类，它将继承QPushButton类。

self.setAcceptDrops(True)

我们使用setAcceptDrops为小部件启用删除事件。

def dragEnterEvent(self, e):

    if e.mimeData().hasFormat('text/plain'):
        e.accept()
    else:
        e.ignore()

首先，我们重新实现dragEnterEvent方法。我们告知我们接受的数据类型。在我们的例子中，它是纯文本。

def dropEvent(self, e):

    self.setText(e.mimeData().text())

通过重新实现dropEvent方法，我们定义了在drop事件中发生的事情。这里我们更改按钮小部件的文本。

edit = QLineEdit('', self)
edit.setDragEnabled(True)

QLineEdit小部件具有对拖动操作的内置支持。我们所需要做的就是调用setDragEnabled方法来激活它。

拖放按钮小部件

下面的示例演示如何拖放按钮小部件。

drag_button.py

#!/usr/bin/python

"""
ZetCode PyQt5 tutorial

In this program, we can press on a button with a left mouse
click or drag and drop the button with  the right mouse click.

Author: Jan Bodnar
Website: zetcode.com
"""

import sys

from PyQt5.QtCore import Qt, QMimeData
from PyQt5.QtGui import QDrag
from PyQt5.QtWidgets import QPushButton, QWidget, QApplication


class Button(QPushButton):

    def __init__(self, title, parent):
        super().__init__(title, parent)

    def mouseMoveEvent(self, e):

        if e.buttons() != Qt.RightButton:
            return

        mimeData = QMimeData()

        drag = QDrag(self)
        drag.setMimeData(mimeData)
        drag.setHotSpot(e.pos() - self.rect().topLeft())

        dropAction = drag.exec_(Qt.MoveAction)

    def mousePressEvent(self, e):

        super().mousePressEvent(e)

        if e.button() == Qt.LeftButton:
            print('press')


class Example(QWidget):

    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):

        self.setAcceptDrops(True)

        self.button = Button('Button', self)
        self.button.move(100, 65)

        self.setWindowTitle('Click or Move')
        self.setGeometry(300, 300, 550, 450)

    def dragEnterEvent(self, e):
        e.accept()

    def dropEvent(self, e):
        position = e.pos()
        self.button.move(position)

        e.setDropAction(Qt.MoveAction)
        e.accept()


def main():
    
    app = QApplication(sys.argv)
    ex = Example()
    ex.show()
    app.exec_()


if __name__ == '__main__':
    main()

在我们的代码示例中，窗口上有一个QPushButton。如果我们用鼠标左键点击按钮，“press”消息将被打印到控制台。通过右键单击并移动按钮，我们对按钮小部件执行拖放操作。

class Button(QPushButton):

    def __init__(self, title, parent):
        super().__init__(title, parent)

我们创建了一个Button类，它派生自QPushButton。我们还重新实现了QPushButton的两个方法：mouseMoveEvent和mousePressEvent。mouseMoveEvent方法是拖放操作开始的地方。

if e.buttons() != Qt.RightButton:
    return

在这里，我们决定只能使用鼠标右键执行拖放操作。鼠标左键保留用于单击该按钮。

mimeData = QMimeData()

drag = QDrag(self)
drag.setMimeData(mimeData)
drag.setHotSpot(e.pos() - self.rect().topLeft())

创建QDrag对象。该类提供对基于MIME（MIME-based）的拖放数据传输的支持。

dropAction = drag.exec_(Qt.MoveAction)

拖放对象的exec_方法开始拖放操作。

def mousePressEvent(self, e):

    super().mousePressEvent(e)

    if e.button() == Qt.LeftButton:
        print('press')

如果我们用鼠标左键点击按钮，我们就会在控制台上打印“press”。注意，我们也在父类上调用mousePressEvent方法。否则，我们不会看到按钮被按下。

position = e.pos()
self.button.move(position)

在dropEvent方法中，我们指定在释放鼠标按钮并完成拖放操作后发生的事情。在我们的示例中，我们找出当前鼠标指针的位置并相应地移动按钮。

ee.setDropAction(Qt.MoveAction)
e.accept()

我们用setDropAction指定放操作的类型。在我们的例子中，它是一个移动动作。