Qt Quick 中的 drag and drop（拖放）

    研究了一下 Qt Quick 里的 drag and drop 功能，大概讲一下。

类库

    Qt Quick与 drag and drop 相关的，有这么几个类库：

• DropArea
• DragEvent
• Drag

DropArea

    DropArea 其实是个方便类，它不可见，但是定义了一个可以接收拖放的区域。它的 entered 信号在有物体被拖入区域时发射，exited 信号在物体被拖出区域时发射，当物体在区域内被拖着来回移动时会不断发射 positionChanged 信号，当用户释放了物体，dropped 信号被发射。

    containsDrag 属性是个布尔值，指示自己的辖区内当前是否有物体被拖动。我们可以根据这个来显示点什么来表示拖动，待会的实例会用到。

    DropArea 还有一些属性，不提也罢，用到了看帮助吧。

DragEvent

    DragEvent ，看名字想必也能想到它是干什么的了。没错，它就是描述一个拖动事件的相关信息的， DropArea 的 entered 、 positionChanged 、 dropped 信号的参数都是 DragEvent 。

    DragEvent 属性很多，我们挑几个说说吧。

• accepted ：表示是否接受事件的布尔值，如果你处理了 entered 信号，需要把它设置为 true 。
• x , y ：拖动事件的位置，你可以根据它来显示点什么，我们的实例显示了一个如影随形的矩形。
• action : 拖动来源正在执行的动作的标识，有 Qt.CopyAction 、 Qt.MoveAction 、 Qt.LinkAction 、 Qt.IgnoreAction四种，望文生义即可。
• proposedActions ：建议的动作集合。
• supportedActions ：来源支持的动作集合

    其它的属性还有 hasColor 、 hasUrls 、 hasText 、 hasHtml 等等与 MIME 相关的属性用来判断在拖动时是否携带了某种数据，对应的就有 colorData 、 urls 、 text 、 html 等属性表示实际的数据。

    DragEvent 还定义了一些方法：

• accept(Action) ：调用它可以接受某一个动作，比如你接受 Qt.CopyAction 
• accept() ：接受拖动事件，表明你处理了这个事件了。
• acceptProposedAction() ： 接受被拖动物体（来源）建议的动作
• getDataAsString(format) ：获取某个格式对应的数据并转换为字符串，我们的实例里用这个来提取传输的数据

Drag

    Drag 这个类一般是附着在可能被拖动的 Item 上，用来设置一些拖动相关的信息。

    它提供很多附加属性，挑一些解释一下：

• active ：指示当前是否处在拖动状态。我们可以把这个属性和一个 MouseArea 的 drag 属性绑定，这样当用户拖动鼠标时就会产生拖动事件。当然你也可以手动设置它为 true ，那样会以被拖动 Item 的当前位置产生一个拖动进入事件。如果你设置 active 为 false ，会产生一个拖动离开事件。
• dragType ：一个枚举值，表示拖动类型，可以是 Drag.None（不自动开始拖动）、Drag.Automatic（自动开始拖动）、Drag.Internal（自动开始前向兼容的拖动）。我们用到了这个，待会儿看代码就明白了。
• mimeData ： 存放MIME数据以及自定义数据，可以传递给 DropArea 。Qt Quick 会把 mimeData 定义的数据打包到 DragEvent 里，带着它四处旅行，谁感兴趣都可以看看。
• supportedActions ：指定支持的动作。对应 DropArea 收到的 DragEvent 的 supportedActions 。
• proposedActions ： 指定推荐的动作。对应 DropArea 收到的 DragEvent 的 proposedActions 。
• source ： 指定拖动的来源对象
• target ：当 active 为 true （拖动处于活跃状态）时，这个属性保存被拖动物体进入的那个 DropArea ÿ