qt中的拖拽及其使用技巧

关于qt中的拖放操作，首先可以看这篇官方文档：http://doc.qt.io/qt-5.5/dnd.html

一、QDrag

首先是创建QDrag，可以在mousePressEvent或者mouseMoveEvent中创建。

void DragDropWidget::mousePressEvent(QMouseEvent *event)
{
	if (event->button() == Qt::LeftButton)
	{
		QDrag *drag = new QDrag(this);
		QMimeData *data = new QMimeData;
		drag->setMimeData(data);
		drag->exec(Qt::MoveAction);
	}
}

或者

void DragDropWidget::mousePressEvent(QMouseEvent *event)
{
	if (event->buttons() & Qt::LeftButton)
	{
		startPos = event->pos();
	}
}

void DragDropWidget::mouseMoveEvent(QMouseEvent *event)
{
	if (event->buttons() & Qt::LeftButton)
	{
		if ((event->pos() - startPos).manhattanLength() < QApplication::startDragDistance())
		{
			QDrag *drag = new QDrag(this);
			QMimeData *data = new QMimeData;
			drag->setMimeData(data);
			drag->exec(Qt::LinkAction);
		}
	}
}

QDrag在exec前，一定要设置QMimeData，否则会弹出警告“QDrag: No mimedata set before starting the drag”。并且不会开始拖拽操作。

QMimeData在拖拽中非常有用，可以用来保存拖拽操作附带的信息，比如字符串、文件或者图片，同时也可以用来验证其所保存的信息格式，并以此来判断是否可接收。未来再补充QMimeData的用法。

另外要注意，在windows下，QDrag::exec()是个同步操作，要在exec()返回后，才会继续执行下面的代码。

二、drag相关事件

首先，当需要一个控件接收drag和drop，就要先调用控件的方法：setAcceptDrops(true)。

qt中一共有三个drag相关事件，dragEnterEvent、dragMoveEvent、dragLeaveEvent。这三个事件触发条件类似鼠标移入，鼠标移动，鼠标移出。当鼠标拖拽进入控件触发dragEnterEvent，在控件内拖拽移动触发dragMoveEvent，鼠标拖拽离开控件触发dragLeaveEvent。

dragEnterEvent事件有一个参数，参数类型是QDragEnterEvent，继承自QDragMoveEvent。

dragMoveEvent事件有一个参数，参数类型是QDragMoveEvent。

dragLeaveEvent事件有一个参数，参数类型是QDragLeaveEvent，继承自QEvent，无特别用法。

当鼠标拖拽进入控件时，会触发dragEnterEvent，如果不做处理，后续将不会接收到dragMoveEvent事件和dragLeaveEvent事件。在dragEnterEvent事件中，如果调用了QDragMoveEvent::accept()函数，后续将可以收到dragMoveEvent事件和dragLeaveEvent事件。而如果调用QDragMoveEvent::ignore()函数，效果相当于不处理，不会接收后续事件。

void DragDropWidget::dragEnterEvent(QDragEnterEvent *event)
{
	if (event->source() == this)
		event->ignore();
	else
		event->accept();
}

发起drag的控件自身也是可以接受到来自自身的drag的相关事件的，这个要注意，处理不好容易出bug。

三、dropEvent

当drag为accept状态，然后释放鼠标，就会产生dropEvent。我们可以在这个事件里处理本次拖拽附带的Mime信息。

四、使用技巧

在我的一个项目中，需要通过拖拽操作连接两个控件，然后在两个控件之间画连接线。这里有两种控件，画布控件CanvasWidget，和节点控件NodeWidget。NodeWidget在CanvasWidget上，连接线也是在CanvasWidget上绘制。我们可以在NodeWidget的dropEvent事件里给CanvasWidget发送连接信号，告诉CanvasWidget两个NodeWidget已经相连了。

void NodeWidget::dropEvent(QDropEvent *event)
{
	auto src = event->source();
	event->setDropAction(Qt::LinkAction);
	event->accept();
	emit linked(src, this);
}

然后我又想在拖拽的过程中就看到一条动态的连接线，这时候就要用到CanvasWidget的drag相关事件。在CanvasWidget的dragMoveEvent事件中这样处理：

void CanvasWidget::dragMoveEvent(QDragMoveEvent *event)
{
	m_lineDraging.end = event->pos();
	update();
}

m_lineDraging就是用来绘制的动态连接线。设置完连接线的端点，然后再update()一下，就可以显示了。当然这只是一个简单方案，还没有验证过在绘制量较大时，在move事件中update会不会很卡。

下面是效果图

Qt Drag and Drop思维导图

 

参考资料：

1. http://doc.qt.io/qt-5.5/dnd.html
2. http://blog.csdn.net/pcsuite/article/details/6147191