TX Text Control系列教程— ASP.NET ：使用MailMerge实现条件表单元格颜色

MailMerge是一个强大的，可扩展的框架，允许您将自定义逻辑注入合并过程。TXTextControl.DocumentServer.MailMerge.FieldMerged事件可用于处理结果，但也可以访问TXTextControl.TableCell类的周围实例。这使您可以根据特定的过滤器指令来实现诸如条件表单元格颜色之类的功能。

TX Text Control Server for ASP.NET (incl. WPF)是一个企业级的服务器端文字处理控件。它为用于ASP.NET服务器环境提供一个完全可编程的文字处理引擎，并且包含一个WPF客户端版本。

TX Text Control Server for ASP.NET (incl. WPF)最新试用版

MailMerge是一个强大的，可扩展的框架，允许您将自定义逻辑注入合并过程。

TXTextControl.DocumentServer.MailMerge.FieldMerged事件可用于处理结果，但也可以访问TXTextControl.TableCell类的周围实例。这使您可以根据特定的过滤器指令来实现诸如条件表单元格颜色之类的功能。

在此示例中，如果数量大于10，则表单元格“数量”应突出显示为红色，否则应为绿色。

该示例显示了两个有趣的方面：

• 显示了如何使用JavaScript API将数据存储在TableCell对象中。
• 说明了如何使用MailMerge在服务器端合并创建的文档。

该示例实现HTML表单元素以设置表单元格的条件。如果输入位置在表格单元格内部，则以下代码用于通过将对象序列化为Json字符串将条件存储在表格单元格中：

// stores the selected conditions in the cell namefunction setTableCellConditions(empty = false) {    TXTextControl.tables.getItem(function (table) {        if (table === null)            return; // no table        // create a cellFilterInstructions object        var cellFilterInstructions = {            compareValue: document.getElementById("compareValue").value,            operator: document.getElementById("operator").value,            trueColor: document.getElementById("trueColor").value,            falseColor: document.getElementById("falseColor").value        }        table.cells.getItemAtInputPosition(function (cell) {            if (cell === null)                return; // no cell            if (empty === true)                cell.setName(""); // delete instructions            else                // sel instructions to cell name                cell.setName(JSON.stringify(cellFilterInstructions));        });    })}

如果将输入位置更改为另一个单元格，则会更新表单元素以反映该单元格的条件：

// check cell status on input position changesTXTextControl.addEventListener("inputPositionChanged", function () {    TXTextControl.tables.getItem(function (table) { // table at input pos       if (table === null) { // return if no table available            EnableFormElements(                ["operator", "compareValue", "trueColor", "falseColor", "enableCondition"],                false); return;        }        // enable form elements        EnableFormElements(            ["operator", "compareValue", "trueColor", "falseColor", "enableCondition"],            true);        table.cells.getItemAtInputPosition(function (cell) { // cell at input pos            if (cell == null) { // return if more cells are selected                enableCellConditions(false);                document.getElementById("enableCondition").setAttribute(                    "disabled", "disabled");                return;            }            // check the cell name that stores the conditions            cell.getName(function (cellName) {                if (cellName === "") { enableCellConditions(false); return; }                updateSettings(JSON.parse(cellName));            });        });    })});

最后，当单击合并时，将保存文档并将其发送到后端控制器：

function mergeDocument() {    TXTextControl.saveDocument(TXTextControl.streamType.InternalUnicodeFormat,        function (e) {            var serviceURL = "/Home/MergeDocument";            $.ajax({                type: "POST",                url: serviceURL,                contentType: 'application/json',                data: JSON.stringify({                    Document: e.data,                }),                success: successFunc,                error: errorFunc            });            function successFunc(data, status) {                TXTextControl.loadDocument(TXTextControl.streamType.InternalUnicodeFormat, data);            }            function errorFunc(error) {                console.log(error);            }        });}

在控制器中，HttpPost方法接受文档并调用MergeJsonData方法以将数据合并到给定的模板中：

[HttpPost]public string MergeDocument(string Document){    using (TXTextControl.ServerTextControl tx = new TXTextControl.ServerTextControl())    {        tx.Create();        tx.Load(Convert.FromBase64String(Document),                TXTextControl.BinaryStreamType.InternalUnicodeFormat);        using (TXTextControl.DocumentServer.MailMerge mailMerge =               new TXTextControl.DocumentServer.MailMerge())        {            mailMerge.TextComponent = tx;            mailMerge.FieldMerged += MailMerge_FieldMerged;            string data = System.IO.File.ReadAllText(Server.MapPath("~/App_Data/data.json"));            mailMerge.MergeJsonData(data, false);        }        byte[] results;        tx.Save(out results, TXTextControl.BinaryStreamType.InternalUnicodeFormat);        return Convert.ToBase64String(results);    }}

附加了FieldMerged事件以处理自定义条件。 如果字段在表格单元格内，则将TableCell.Name属性反序列化为CellFilterInstructions对象，以便根据定义的指令应用表格单元格的颜色。

private void MailMerge_FieldMerged(object sender,  TXTextControl.DocumentServer.MailMerge.FieldMergedEventArgs e){    // custom field handling    if (e.TableCell == null)        return;    // if TableCell.Name has instructions, create a CellFilterInstructions object    // and evaluate the instructions and set the table cell color    if (e.TableCell.Name != "")    {        CellFilterInstructions instructions =          (CellFilterInstructions)JsonConvert.DeserializeObject(            e.TableCell.Name, typeof(CellFilterInstructions));        // retrieve the color        Colorcolor = instructions.GetColor(e.MailMergeFieldAdapter.ApplicationField.Text);        // apply the color        if (color != null)            e.TableCell.CellFormat.BackColor = (Color)color;    }}

如果您对Text Control感兴趣，可以咨询在线客服>>购买正版授权软件。

标签：