你的位置:首页 > ASP.net教程

[ASP.net教程]文字处理控件TX Text Control的使用


这几天一直在研究TX Text Control的使用,由于这方面的资料相对比较少,主要靠下载版本的案例代码进行研究,以及官方的一些博客案例进行学习,使用总结了一些心得,特将其总结出来,供大家分享学习。本篇随笔主要介绍TX Text Control V20的相关使用心得。

1、TX Text Control控件介绍

TX Text Control是一款功能类似于 MS Word 的文字处理控件,包括文档创建、编辑、打印、邮件合并、格式转换、拆分合并、导入导出、批量生成等功能。广泛应用于企业文档管理,网站内容发布,电子病历中病案模板创建、病历书写、修改历史、连续打印、病案归档等功能的实现。

这个控件主要的功能就是可以作为Word以及其他文档的编辑器使用,虽然展示WORD内容的控件也有一些,如我们可以利用DevExpress里面的RTF文档编辑器来实现,同样运行的很好,结合Aspose.Word后台的文档处理,我们可以做到类似报表的数据生成,而且可以把生成后的文档进行显示、编辑等操作处理。

TX Text Control虽然作为文档编辑各方面都表现不错,不过其MailMerge邮件合并功能还是经常使用的一个功能,就是把我们的数据和文档模板来一个合并,然后显示最终的文档内容,这种可以用来做一些类似发票、邮件、员工信息等的数据处理和显示,MailMerge邮件合并可以绑定主从表的数据,能够符合大多数的要求。

我本来想用它做一个类似电子病历一样的功能模块,不说在文档里面,我们很难做到一些下拉列表的处理( 官方博客里面有一个简单的案例,不过不好用),一般情况下,如果我们只是做文档展示、数据合并等常规的操作,还是很不错的。

这个控件的功能介绍,可以参考葡萄城里面的网页介绍(http://www.gcpowertools.com.cn/products/textcontrol_winform_features.htm),这个控件的相关开发人员使用然后分享经验的文章很少,能在网上搜到的大多数是葡萄城人员对这个控件的Demo代码进行一个简单粘贴说明,没有进一步的深入介绍和应用场景的介绍。虽然葡萄城列举了几个电子病历的公司产品案例,不过这几家公司的电子病历产品是很难下载到,也无从知道真假或者使用情况。

这几天我把这个控件的各种特性做了一些学习,并重新把官网的文档编辑例子进行了全新开发,参考着做了一个完全一样的编辑器版本,也基本上对它的各个属性、方法处理有了一个更加深入的了解。

我们先通过一个软件界面来了解整个软件的一些功能(这个是我仿照官方案例做的一个程序)。

这个控件默认安装后,会带有很多Demo案例,具体可以参考目录C:\Users\Administrator\Documents\TX Text Control 20.0.NET for Windows Forms\Samples\ 进行了解。

 

2、TX Text Control控件的汉化

这个控件界面默认是英文版本的,控件的相关菜单以及提示都是英文,因此我们需要对资源做一些中文本地化处理才能正确显示。

官方没有提供中文汉化包,只提供一个标准的英文资源,如下所示。

我们需要做的就是将它们进行中文翻译,然后重新编译(使用buildres.bat脚本编译)为中文资源dll。

我们先使用VS编辑工具,把这些英文资源记录转换为英文(这是一个比较繁琐的工作,官方网站上有一些旧版本的中文包可供参考,以及最新的V20软件(编辑器软件)下载下来运行参考)。

我们逐一进行中文处理,可以使用百度、Google的翻译,以及软件界面的参考哦。

以管理员方式运行VS的命令行,然后执行命令进行编译资源即可。

buildres.bat zh-CN

编译成功后,在目录里面,会增加两个资源程序集。

txdocumentserver.resources.dll

txtextcontrol.resources.dll

然后我们把它复制到运行目录下,并放在zh-CN的目录里面即可。有了这些中文化的资源程序集,我们就可以利用它进行对控件的内置菜单提示进行中文化了。

中文化操作和其他常规的做法一样,我们在Main函数里面,添加如下代码即可。

Thread.CurrentThread.CurrentUICulture = new System.Globalization.CultureInfo("zh-CN");Thread.CurrentThread.CurrentCulture = new System.Globalization.CultureInfo("zh-CN");

运行程序,我们使用右键菜单,发现里面的资源都已经正常汉化了,其他相关的内置菜单和界面也都可以看到正常汉化。

 

3、TX Text Control的使用

有了汉化,只是我们正常使用控件的第一步,我们需要在程序里面整合控件,那么就需要对它进行使用,以及对控件的属性、事件进行处理,才能得到最佳的应用效果。

我们在VS工具栏里面加入对应的控件,可以看到有以下相关的控件对象可供使用,一般情况下我们使用TextControl,然后在其基础上创建其他RulerBar、ButtonBar、StatusBar即可,而如果我们需要合并数据(很常用)就需要加入MailMerge控件对象。

添加控件后,我们可以对控件的相关基础的复制、粘贴、剪切等操作可以直接利用控件的API即可实现。

    private void menuEdit_Undo_Click(object sender, EventArgs e)    {      _textControl.Undo();    }    private void menuEdit_Redo_Click(object sender, EventArgs e)    {      _textControl.Redo();    }    private void menuEdit_Cut_Click(object sender, EventArgs e)    {      _textControl.Cut();    }

其中查找、替换对话框也是可以通过API进行调出。

    private void menuEdit_Find_Click(object sender, EventArgs e)    {      _textControl.Find();    }    private void menuEdit_Replace_Click(object sender, EventArgs e)    {      _textControl.Replace();    }

利用这些最基础的API是常规的操作。

而利用插入相关的对象,如图片、文本框等,就需要做一些简单的编码,方便把对象加入到TextControl对象里面。

    private void menuInsert_Image_Click(object sender, EventArgs e)    {      TXTextControl.Image imageNew = new TXTextControl.Image();      _textControl.Images.Add(imageNew, TXTextControl.HorizontalAlignment.Left, -1, TXTextControl.ImageInsertionMode.DisplaceText);    }    private void menuInsert_TextFrame_Click(object sender, EventArgs e)    {      try      {        // Force Exception if standard version:        _textControl.TextFrames.GetItem();        Size sizeTextFrame = new Size(2268, 2268);  // 4 x 4 cm        TXTextControl.TextFrame textFrameNew = new TXTextControl.TextFrame(sizeTextFrame);        _textControl.TextFrames.Add(textFrameNew, TXTextControl.HorizontalAlignment.Left, -1, TXTextControl.TextFrameInsertionMode.DisplaceCompleteLines);      }      catch (Exception ex)      {        MessageBox.Show(ex.Message, ProductName);      }    }

这个控件最常见的就是MailMerge进行合并数据的操作了,这个也是我们利用它来处理很多模板化文档的目的。

MailMerge对象合并数据的操作,主要是接受集合对象或者是DataTable对象,所以我们必须将我们的数据转换为这种格式,否则合并数据得不到要的结果。

合并数据的处理方式,最开始就是需要设计好模板,这点很重要,模板的设计还是沿用了常规Word文档域对象的概念,需要添加一些域来做后续数据替换的对象占位符,如下是我测试的一个模板。

这个里面主要是主从表整合的一个模板,我们需要绑定常规的主表记录,也需要绑定明细表的集合记录,不过最后我们都需要把数据对象转换为集合(如DataSet),然后才能绑定到文档对象上去。

在上面的文档里面,你知识看到了域对象,而没有看到一个隐藏的一个集合记录的开始和结束的书签设置。关于书签的作用和如何操作,可以了解我之前的随笔文章《利用Aspose.Word控件实现Word文档的操作》、《利用Aspose.Word控件和Aspose.Cell控件,实现Word文档和Excel文档的模板化导出》

书签的作用很重要,否则无法正常解析集合的记录并绑定在WORD界面上的,我们打开书签管理对话框,可以看到上述文档里面有两个位置,书签标记的开始和结束位置。

这样我们设计好模板后,第二步就是通过代码生成相关对象,然后和文档进行合并就可以了。

例如我构建一个主表和一个从表的记录,统一把它们生成一个DataSet对象供使用。

    public static DataSet CreateDataSet()    {      DataSet ds = new DataSet();      DataTable dtMain = DataTableHelper.CreateTable("Company,HandNo,Creator,CreateTime|DateTime");      dtMain.TableName = "main";      DataRow dr = dtMain.NewRow();      dr["Company"] = "广州爱奇迪软件科技有限公司";      dr["HandNo"] = "123456";      dr["Creator"] = "伍华聪";      dr["CreateTime"] = DateTime.Now;      dtMain.Rows.Add(dr);      DataTable dt = DataTableHelper.CreateTable("ID,ProductName,Description,Price|decimal,Quantity|int");      dt.TableName = "ProductInfo";      dr = dt.NewRow();      dr["ID"] = "1";      dr["ProductName"] = "海飞丝洗发水";      dr["Description"] = "海飞丝洗发水, 550ml";      dr["Price"] = 19.8M;      dr["Quantity"] = 100;      dt.Rows.Add(dr);      dr = dt.NewRow();      dr["ID"] = "2";      dr["ProductName"] = "联想品牌电脑";      dr["Description"] = "联想Y700-15ISK-ISE 旗舰版";      dr["Price"] = 6500M;      dr["Quantity"] = 10;      dt.Rows.Add(dr);      dr = dt.NewRow();      dr["ID"] = "3";      dr["ProductName"] = "IPhone7 128G";      dr["Description"] = "苹果IPhone7, 128G";      dr["Price"] = 5800M;      dr["Quantity"] = 10;      dt.Rows.Add(dr);      ds.Tables.Add(dtMain);      ds.Tables.Add(dt);      return ds;    }

先加载模板文档

if (setting == null){  setting = new TXTextControl.LoadSettings();  setting.ApplicationFieldFormat = TXTextControl.ApplicationFieldFormat.MSWord;}_textControl.Load(Application.StartupPath + "\\Template\\template1.docx", TXTextControl.StreamType.WordprocessingML, setting);

整合合并数据

DataSet ds = PurchaseInfoHelper.CreateDataSet();mailMerge1.MergeBlocks(ds);mailMerge1.Merge(ds.Tables["main"], true);

最后就可以看到我们所需要的结果了。

当然,如果很熟悉Aspose.Word控件的使用,我们其实也可以利用Aspose.Word控件来做后台的数据整合处理,Aspose.Word控件支持很多变量定义,以及更加复杂的处理,如我把原来在框架模块里面的人员信息导出Word功能抽取出来,这个模块原先是利用Aspose.Word来处理数据合并的,我不修改其中的逻辑,只是把合并后的数据展示在TX Text Control即可,如下代码所示。

var saveFile = StaffHelper.GenerateDoc();//加载文档_textControl.Load(saveFile, StreamType.MSWord);

最后就生成了我们开始介绍的软件界面效果。

这个控件目前使用起来还算不错,不过对于一些数据源的处理方面,以后希望继续增加更多的接口,继续保持观察,希望能将研究的成果用在具体的项目上。