本章节主要描述如何在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类型的值,通过它可以控制当前的鼠标状态。