Spread 7 for WinForms 新增的GcTextBoxCellType (水印、自动换行、自动大写、长度限制等)

发布时间:2013/11/14 00:11 发布者:roger

返回博客中心

Spread 7 for WinForms 新引入了2 个新的 CellTypes:

GcTextBoxCellType   文本输入

GcDateTimeCellType 日期输入

      本文就GcTextBoxCellType的几个常用的功能进行说明:

    GcTextBoxCellType 相对TextCellType而言,属于增强型CellType。 事实上,它相当于TextBox控件一样可以做任何事,最重要的是,不用写自定义CellType的继承类。 如,早期的TextCellType无法处理CrLf和Tab制表符--当拷贝、粘贴的时候。而GcTextBoxCellType 仅仅通过2个属性的设置即可实现类似功能-  AcceptsCrLf、AcceptsTabChar。

    下面就GcTextBoxCellType控件的几个属性一一说明,其他属性参见文档

    AlternateText(水印文字)

    用GcTextBoxCelltype你可以设置替代文本GcTextBox。您可以在空白单元格设置文本作为水印:单元格成为空为空时候,AlternateText文字替代显示。看看下面的例子:

      1: GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType textcell = new GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType();
      2: textcell.AlternateText.Null.ForeColor = System.Drawing.Color.Red;
      3: textcell.AlternateText.Null.Text = "This cell is blank";
      4: fpSpread1.Sheets[0].Cells[0, 0, 10, 0].CellType = textcell;
      效果截图:

    AlternateText-270x300

    AutoConvert(自动大小写转换)

    GcTextBoxCellType引入AutoConvert属性使用它可以将输入的数据自动转换到文本的FormatString。因此,这可以被用来作为输入掩码。例如,您可以进行设置,用户输入小写字母中的数据,可被自动转换为大写字母。看看下面的例子:

      1: GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType textcell = new GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType();
      2: textcell.AutoConvert = true;
      3: textcell.FormatString = "A";
      4: fpSpread1.Sheets[0].Cells[0, 0, 10, 0].CellType = textcell;

     

    WrapMode(文字、单词换行)

    尽管TextCellType只允许您设置多行和WordWrap属性。 有了GcTextBoxCellType,你现在可以更进一步:它允许你还可以设置WrapMode的类型,

    如是否要通过字符换行或Word换行。

      1: GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType textcell = new GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType();
      2: textcell.WrapMode = GrapeCity.Win.Spread.InputMan.CellType.WrapMode.WordWrap;
      3: textcell.Multiline = true;
      4: fpSpread1.Sheets[0].Cells[0, 0, 10, 0].CellType = textcell;

     

    截图如下:

    WrapMode-300x295

    MaxLineCount(限制列输入个数)

    您可以设置GcTextBoxCell使用MaxLineCount属性的最大数量。此属性很有用,如您想来限制在一个单元格格中的数据录入。您还可以设置的最大长度的单元,

    通过使用MaxLengthUnit属性。此属性获取或设置控制在允许的最大数量的字符是否是基于字节,字符或文本元素。使用下面的代码在一个单元格格中的字符设置限制:

      1: GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType inputcell1 = new GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType();
      2: inputcell1.MaxLengthUnit = GrapeCity.Win.Spread.InputMan.CellType.LengthUnit.Char;
      3: inputcell1.MaxLength = 10;
      4: fpSpread1.Sheets[0].Cells[1, 1].CellType = inputcell1;

    请通过我们的在线文档GcTextBoxCellType, 获得更多信息。

    源码下载:


    关于葡萄城

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

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