TX Text Control .NET 产品使用指南(13)实现拖放操作

发布时间:2012/11/16 00:11 发布者:葡萄城产品团队

返回博客中心

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


关于葡萄城

赋能开发者!葡萄城是专业的集开发工具、商业智能解决方案、低代码开发平台于一身的软件和服务提供商,为超过 75% 的全球财富 500 强企业提供服务。葡萄城专注控件软件领域30年,希望通过模块化的开发控件、灵活的低代码应用开发平台等一系列开发工具、解决方案和服务,帮助开发者快速响应复杂多变的业务需求,最大程度地发挥开发者的才智和潜能,让开发者的 IT 人生更从容更美好。

了解详情,请访问葡萄城官网