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             操作被取消,没有放置消息

 


 

posted @ 2012-05-30 01:30  许海彪  阅读(544)  评论(0编辑  收藏  举报