Qt学习之路(53): 拖放技术之二

版权声明：原创作品，允许转载，转载时请务必以超链接形式标明文章 原始出处 、作者信息和本声明。否则将追究法律责任。http://devbean.blog.51cto.com/448512/286796
很长时间没有来写博客了，前段时间一直在帮同学弄一个 spring-mvc 的项目，今天终于做完了，不过公司里面又要开始做 flex 4，估计还会忙一段时间吧！
接着上次的说，上次说到了拖放技术，今天依然是一个例子，同样是来自《C++ GUI Programming with Qt 4, 2nd Edition》的。
这次的 demo 还算是比较实用：实现的是两个 list 之间的数据互拖。在很多项目中，这一需求还是比较常见的吧！下面也就算是抛砖引玉了啊！
projectlistwidget.h

1. #ifndef PROJECTLISTWIDGET_H
2. #define PROJECTLISTWIDGET_H
3.
4. #include <QtGui>
5.
6. class ProjectListWidget : public QListWidget
7. {
8. Q_OBJECT
9.
10. public:
11. ProjectListWidget(QWidget *parent = 0);
12.
13. protected:
14. void mousePressEvent(QMouseEvent *event);
15. void mouseMoveEvent(QMouseEvent *event);
16. void dragEnterEvent(QDragEnterEvent *event);
17. void dragMoveEvent(QDragMoveEvent *event);
18. void dropEvent(QDropEvent *event);
19.
20. private:
21. void performDrag();
22.
23. QPoint startPos;
24. };
25.
26. #endif // PROJECTLISTWIDGET_H

projectlistwidget.cpp

1. #include "projectlistwidget.h"
2.
3. ProjectListWidget::ProjectListWidget(QWidget *parent)
4. : QListWidget(parent)
5. {
6. setAcceptDrops(true);
7. }
8.
9. void ProjectListWidget::mousePressEvent(QMouseEvent *event)
10. {
11. if (event->button() == Qt::LeftButton)
12. startPos = event->pos();
13. QListWidget::mousePressEvent(event);
14. }
15.
16. void ProjectListWidget::mouseMoveEvent(QMouseEvent *event)
17. {
18. if (event->buttons() & Qt::LeftButton) {
19. int distance = (event->pos() - startPos).manhattanLength();
20. if (distance >= QApplication::startDragDistance())
21. performDrag();
22. }
23. QListWidget::mouseMoveEvent(event);
24. }
25.
26. void ProjectListWidget::performDrag()
27. {
28. QListWidgetItem *item = currentItem();
29. if (item) {
30. QMimeData *mimeData = new QMimeData;
31. mimeData->setText(item->text());
32.
33. QDrag *drag = new QDrag(this);
34. drag->setMimeData(mimeData);
35. drag->setPixmap(QPixmap(":/images/person.png"));
36. if (drag->exec(Qt::MoveAction) == Qt::MoveAction)
37. delete item;
38. }
39. }
40.
41. void ProjectListWidget::dragEnterEvent(QDragEnterEvent *event)
42. {
43. ProjectListWidget *source =
44. qobject_cast<ProjectListWidget *>(event->source());
45. if (source && source != this) {
46. event->setDropAction(Qt::MoveAction);
47. event->accept();
48. }
49. }
50.
51. void ProjectListWidget::dragMoveEvent(QDragMoveEvent *event)
52. {
53. ProjectListWidget *source =
54. qobject_cast<ProjectListWidget *>(event->source());
55. if (source && source != this) {
56. event->setDropAction(Qt::MoveAction);
57. event->accept();
58. }
59. }
60.
61. void ProjectListWidget::dropEvent(QDropEvent *event)
62. {
63. ProjectListWidget *source =
64. qobject_cast<ProjectListWidget *>(event->source());
65. if (source && source != this) {
66. addItem(event->mimeData()->text());
67. event->setDropAction(Qt::MoveAction);
68. event->accept();
69. }
70. }

我们从构造函数开始看起。Qt 中很多组件是可以接受拖放的，但是默认动作都是不允许的，因此在构造函数中，我们调用 setAcceptDrops(true); 函数，让组件能够接受拖放事件。
在 mousePressEvent() 函数中，我们检测鼠标左键点击，如果是的话就记录下当前位置。需要注意的是，这个函数最后需要调用系统自带的处理函数，以便实现通常的那种操作。这在一些重写事件的函数中都是需要注意的！
然后我们重写了 mouseMoveEvent() 事件。下面还是先来看看代码：

1. void ProjectListWidget::mouseMoveEvent(QMouseEvent *event)
2. {
3. if (event->buttons() & Qt::LeftButton) {
4. int distance = (event->pos() - startPos).manhattanLength();
5. if (distance >= QApplication::startDragDistance())
6. performDrag();
7. }
8. QListWidget::mouseMoveEvent(event);
9. }

在这里判断了如果鼠标拖动的时候一直按住左键(也就是 if 里面的内容)，那么就计算一个 manhattanLength() 值。从字面上翻译，这是个“曼哈顿长度”。这是什么意思呢？我们看一下 event.pos() - startPos 是什么。还记得在 mousePressEvent() 函数中，我们将鼠标按下的坐标记录为 startPos，而 event.pos() 则是鼠标当前的坐标：一个点减去另外一个点，没错，这就是向量！其实，所谓曼哈顿距离就是两点之间的距离(至于为什么叫这个奇怪的名字，大家查查百科就知道啦！)，也就是这个向量的长度。下面又是一个判断，如果大于 QApplication::startDragDistance()，我们才进行 drag 的操作。当然，最后还是要调用系统默认的鼠标拖动函数。这一判断的意义在于，防止用户因为手的抖动等因素造成的鼠标拖动。用户必须将鼠标拖动一段距离之后，我们才认为他是希望进行拖动操作，而这一距离就是 QApplication::startDragDistance() 提供的，这个值通常是 4px。
performDrag() 开始处理拖放过程。我们创建了一个 QDrag 对象，将 this 作为 parent。QDrag 使用 QMimeData 存储数据。例如我们使用 QMimeData::setText() 函数将一个字符串存储为 text/plain 类型的数据。QMimeData 提供了很多函数，用于存储诸如 URL、颜色等类型的数据。使用 QDrag::setPixmap() 则可以设置拖动发生时鼠标的样式。QDrag::exec() 会阻塞拖动的操作，直到用户完成操作或者取消操作。它接受不同类型的动作作为参数，返回值是真正执行的动作。这些动作的类型为 Qt::CopyAction，Qt::MoveAction 和 Qt::LinkAction。返回值会有这三种动作，同时增加一个 Qt::IgnoreAction 用于表示用户取消了拖放。这些动作取决于拖放源对象允许的类型，目的对象接受的类型以及拖放时按下的键盘按键。在 exec() 调用之后，Qt 会在拖放对象不需要的时候 delete 掉它。
ProjectListWidget 不仅能够发出拖动事件，而且能够接受同一应用程序中的不同 ProjectListWidget 对象的数据。在 dragEnterEvent() 中，我们使用 event->source() 获取这样的对象：如果拖放数据来自同一类型的对象，并且来自同一应用程序则返回其指针，否则返回 NULL。我们使用 qobject_cast 宏将指针转换成 ProjectListWidget* 类型，然后设置接受 Qt::MoveAction 类型的拖动。dragMoveEvent() 则和这个函数具有相同的代码，因为我们需要重写拖动移动的代码。
最后在 dropEvent() 函数中，我们取出 QDrag 中的 mimeData 数据，调用 addItem() 添加到当前的列表中。这样，一个相对完整的拖放的代码就完成了。
拖放技术是 Qt 中功能强大的一个技术，但是对于不涉及数据的同一组件中拖动，或许仅仅简单的实现 mouse event 就足够了，具体还是要自己斟酌啦！

本文出自 “豆子空间” 博客，请务必保留此出处http://devbean.blog.51cto.com/448512/286796