本章节主要描述如何在TX Text Control中实现拖放操作,相应的源代码可以在以下目录中找到:
Samples\WinForms\VB.NET\DragDrop
Samples\WinForms\CSharp\DragDrop
(一)两种拖放类型
在大多数文字处理器中支持两种类型的拖放操作:
1. 文本拖放操作,在文档中选择一段文本,如何将其拖放到文档的另一个位置。
2. 文件拖放操作,在资源管理器中拖拽一个文件到文字处理器中,通过这种方式来打开该文件。
在Text Control中设置TextControl.AllowDrag = true和TextControl.AllowDrop = true便可自动自持文本拖放操作。文件拖放操作在Text Control中也完全支持,并且可以以多种方式来适应你的应用程序。
(二)文件拖放操作
可以使用 .NET中的三个事件来实现文件的拖放操作:
DragEnter:当某一对象被拖拽到目标对象的边界时会触发该事件,可在该事件中检查文件是否是应用程序接受的文件。
DragOver:当鼠标在目标对象中移动时触发该事件,如果当前拖拽的文件是应用程序接受的文件,将会改变鼠标状态,以此来告知用户文件为可接受的文件。
DragDrop:当用户在目标对象中松开鼠标按键时触发该事件,应用程序将加载被拖放的文件。
如果被拖拽的文件被释放到文本窗口,将会触发TX Text Control的事件;如何释放的位置超出了TX Text Control控件的边界,例如:释放到应用程序的工具栏,将会触发应用程序窗体的事件。各系统中对不同释放点所提供的处理行为也是多样化的,在MS Word 2007中,如果释放点在工具栏上将加载改文件,释放点在文本区域中却不会加载该文件。
(三)处理拖放事件
下面将展示示例程序中Drag和Drop事件的处理逻辑。示例中允许在系统的任意位置释放文件,而且这些处理逻辑都被封装在DragDropHander类中,可在你的系统中重复使用该类型。首先,创建一个FileDragDropHandler类的实例:
- [C#]
- FileDragDropHandler fileDragDrop = new FileDragDropHandler();
接下来,可以利用窗体或者控件的事件来处理被拖拽的文件,TX Text Control事件的处理逻辑都是依靠DragDropHandler类来完成的,窗体事件与TX Text Control控件的有着同样的处理方法。
- [C#]
- private void textControl1_DragDrop(object sender, DragEventArgs e)
- {
- loadFile(fileDragDrop.FileName, fileDragDrop.StreamType);
- }
-
- private void textControl1_DragEnter(object sender, DragEventArgs e)
- {
- fileDragDrop.Reset();
- fileDragDrop.CheckDraggedFiles((string[])e.Data.GetData(DataFormats.FileDrop));
- }
-
- private void textControl1_DragOver(object sender, DragEventArgs e)
- {
- if (fileDragDrop.CanDrop == true)
- e.Effect = fileDragDrop.GetDragDropEffect(e.AllowedEffect, e.KeyState);
- }
在DragEnter事件中将再次检查该文件是否是被支持。如果是支持的文件,CanDrop属性将返回true,CanDrop属性可用于决定DragDrop是否被允许。你还可以通过GetDragDropEffect方法返回一个基于当前Keystate的DragDropEffects类型的值,通过它可以控制当前的鼠标状态。