C#拖放技术相关方法和事件

1．方法

实现拖放效果时，C#中提供了一个系统方法DoDragDrop方法，用于实现开始拖放操作，该方法由Control类所定义，由于控件均直接或是间接派生于Control类，因此开发人员可以在任何可视化组件中调用DoDragDrop方法。DoDragDrop方法使用语法如下：

public DragDropEffects DoDragDrop ( Object data,DragDropEffects allowedEffects)

data：用户所要拖动的数据内容。必须将所要拖动的内容传入到这个方法的第一个参数位置。

allowedEffects：DragDropEffects枚举值之一，此类型包含了拖动操作的效果。DragDropEffects枚举值如表32.8所示。

表32.8　　 DragDropEffects枚举值

枚举值 说明
All        从拖动源复制、移除数据，并将其滚动到放置目标中
Copy    将数据复制到放置目标
Link     将拖动源中的数据链接到放置目标
Move    将拖动源的数据移动到放置目标
None    放置目标不接受该数据
Scroll   即将在放置目标中开始滚动，或当前正在滚动

开发人员在使用DoDragDrop方法时，必须指定参数allowedEffects为表**中的任何一个成员，另外，还可以使用位运算符，把其中的任何一个成员作为一个完整参数传入，以得到所需的拖动效果，实现关键代码如下：

DragDropEffects.Copy| DragDropEffects.None

2．事件

C#中提供了一个系统拖放事件，与拖放方法一起使用来达到更好的效果。常用的拖放事件如表所示。

表　 拖放事件

名称 说明
DragEnter                 当用户在拖放操作过程中首次将鼠标光标拖到控件上时，会引发该事件
DragDrop                  在完成拖放操作时发生
GiveFeedback             在执行拖动操作期间发生
DragLeave                 如果用户移出一个窗口，则引发DragLeave事件
DragOver                   如果鼠标移动但停留在同一个控件中，则引发DragOver事件
QueryContinueDrag    在拖放操作过程中，当键盘或鼠标按钮状态发生变化时，会引发QueryContinueDrag 事件。QueryContinueDrag事件允许拖动源确定是否应取消拖放操作

下面对拖放事件中比较重要的事件进行详细介绍。

（1）DragEnter事件

当用户在拖放操作过程中首次将鼠标光标拖到控件上时，触发该事件。

语法：

public event DragEventHandler DragEnter

该事件为DragEventHandler委托类型，该委托是专门设计用以处理控件的DragEnter、DragDrop、GiveFeedback、DragLeave和DragOver等相关事件的方法。DragEventHandler委托类型的定义语法如下：

public delegate void DragEventHandler(object sender,DragEventArgs e)

该委托封装的方法必须接受两个参数，第一个是object类型对象，该对象用来指定拖放目标对象；第二个为DragEventArgs 类型参数e，它主要包含拖动操作的相关数据。DragEventArgs 类型参数e的相关属性值及说明如表所示。

表　DragEventArgs类型参数e的属性值及说明

名称 说明
AllowedEffect    获取拖动事件的发起方（或源）所允许的拖放操作
Data               获取IDataObject，它包含与此事件关联的数据
Effect              获取或设置拖放操作中目标放置效果
KeyState         获取Shift、Ctrl 和 Alt键的当前状态以及鼠标按钮的状态
X                   获取鼠标指针在屏幕坐标系中的x坐标
Y                   获取鼠标指针在屏幕坐标系中的y坐标

（2）QueryContinueDrag事件

在拖放操作过程中，当键盘或鼠标按钮状态发生变化时，触发该事件。

语法：

public event QueryContinueDragEventHandler QueryContinueDrag

委托定义语法如下：

public delegate void DragEventHandler(object sender, QueryContinueDragEventArgs e)

该委托封装的方法必须接受两个参数，第一个是object类型对象，该对象用来指定为拖放目标对象；第二个为QueryContinueDragEventArgs 类型参数e，它主要包含拖动操作的相关数据。QueryContinueDragEventArgs 类型参数e有一个Action属性，该属性的属性值用来确定是否继续拖动、放置数据或取消操作。Action属性值及说明如表32.11所示。

表　QueryContinueDragEventArgs.Action属性值及说明

名称 说明
Continue          该操作将继续
Drop               该操作以放置而告终
Cancel             操作被取消，没有放置消息