概述 | 软件包 | 类 | 使用 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法

## application.workbooks.workbook.tables
类 TableCell

    java.lang.Object
      application.workbooks.workbook.tables.TableCell

    public class TableCell

extends java.lang.Object

封装了自由表格单元格类，提供了对单元格进行操作的各种功能。

方法摘要
`void` | `deleteText(long offset, long length)` 在指定位置删除指定长度的文本（包括图像，域，多媒体等对象）。
`long` | `getLength()` 返回当前区域文本的长度。
`void` | `insertText(long offset, java.lang.String text)` 在指定位置插入字符串（插入属性为当前位置的输入属性）。
`void` | `setBorderAttribute(long offset, long length, BorderAttribute borderAttr)` 设置指定位置的文字边框属性。
`void` | `setFontAttribute(FontAttribute font)` 对单元格中的字符串进行格式化。
`void` | `setFontAttribute(long offset, long length, FontAttribute font)` 对指定位置指定长度的字符串进行格式化。
`void` | `setShadingAttribute(long offset, long length, ShadingAttribute shadingAttr)` 设置指定位置的文字底纹属性。

从类 java.lang.Object 继承的方法
`equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

方法详细信息

### deleteText

    public void deleteText(long offset,
                           long length)

  在指定位置删除指定长度的文本（包括图像，域，多媒体等对象）。

  参数：
    `offset` - 删除时光标指定的起始位置（起始位置为0）
    `length` - 删除字符的个数（图像，域，多媒体等对象均属于一个字符）

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().
         getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         Tables tables = doc.getTables();
         tables.insertTable(baseText,0,5,5);
         Table table = tables.getActiveTable();
         TableCell cell = table.getTableCell(1,1);
         cell.insertText(0, "指定长度的文本");
         cell.deleteText(0,3);

  抛出：
    `application.exceptions.MacroRunException` - 当指定区域被保护
    `application.exceptions.MacroRunException` - 当offset小于0或offset大于单元格字符长度。

### getLength

    public long getLength()

  返回当前区域文本的长度。

  返回：
    当前区域文本的长度

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().
         getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         Tables tables = doc.getTables();
         tables.insertTable(baseText,0,5,5);
         Table table = tables.getActiveTable();
         TableCell cell = table.getTableCell(1,1);
         cell.insertText(0, "指定长度的文本");
         System.out.println("当前区域文本的长度:" + cell.getLength());

### insertText

    public void insertText(long offset,
                           java.lang.String text)

  在指定位置插入字符串（插入属性为当前位置的输入属性）。

  参数：
    `offset` - 插入字符串时的位置（起始位置为0）
    `text` - 需要插入的字符串

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().
         getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         Tables tables = doc.getTables();
         tables.insertTable(baseText,0,5,5);
         Table table = tables.getActiveTable();
         TableCell cell = table.getTableCell(1,1);
         cell.insertText(0,"cell");

  抛出：
    `application.exceptions.MacroRunException` - 当指定区域被保护
    `application.exceptions.MacroRunException` - 当offset小于0或offset大于单元格字符长度。

### setBorderAttribute

    public void setBorderAttribute(long offset,
                                   long length,
                                   BorderAttribute borderAttr)

  设置指定位置的文字边框属性。

  参数：
    `offset` - 起始位置
    `length` - 文字长度
    `borderAttr` - 边框属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().
         getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         Tables tables = doc.getTables();
         tables.insertTable(baseText,0,5,5);
         Table table = tables.getActiveTable();
         TableCell cell = table.getTableCell(1,1);
         cell.insertText(0,"cell");
         BorderAttribute borderAttr = new BorderAttribute();
         borderAttr.setBorderType(BorderAndShadingConstants.BORDERTYPE_SHADOW);
         borderAttr.setBorderLineType(BorderAndShadingConstants.TOP, 1);
         borderAttr.setBorderLineType(BorderAndShadingConstants.LEFT, 3);
         borderAttr.setBorderLineType(BorderAndShadingConstants.RIGHT, 6);
         borderAttr.setBorderLineType(BorderAndShadingConstants.BOTTOM, 8);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.TOP, Color.RED);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.LEFT, Color.CYAN);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.RIGHT, Color.YELLOW);
         borderAttr.setBorderLineColor(BorderAndShadingConstants.BOTTOM, Color.ORANGE);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.TOP, 8f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.LEFT, 5f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.RIGHT, 3f);
         borderAttr.setBorderLineWidth(BorderAndShadingConstants.BOTTOM, 1f);
         cell.setBorderAttribute(0,4,borderAttr);

  抛出：
    `application.exceptions.MacroRunException` - 当指定区域被保护
    `application.exceptions.MacroRunException` - 当offset小于0或offset大于单元格字符长度。

### setFontAttribute

    public void setFontAttribute(FontAttribute font)

  对单元格中的字符串进行格式化。

  参数：
    `font` - 字体属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().
         getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         Tables tables = doc.getTables();
         tables.insertTable(baseText,0,5,5);
         Table table = tables.getActiveTable();
         TableCell cell = table.getTableCell(1,1);
         cell.insertText(0,"cell");
         FontAttribute font  = new FontAttribute();
         font.setBold(true);
         cell.setFontAttribute(font);

### setFontAttribute

    public void setFontAttribute(long offset,
                                 long length,
                                 FontAttribute font)

  对指定位置指定长度的字符串进行格式化。

  参数：
    `offset` - 字符串起始位置
    `length` - 字符串的长度
    `font` - 字体属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().
         getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         Tables tables = doc.getTables();
         tables.insertTable(baseText,0,5,5);
         Table table = tables.getActiveTable();
         TableCell cell = table.getTableCell(1,1);
         cell.insertText(0,"this is a test!");
         FontAttribute font  = new FontAttribute();
         font.setBold(true);
         cell.setFontAttribute(5,10,font);

  抛出：
    `application.exceptions.MacroRunException` - 当指定区域被保护
    `application.exceptions.MacroRunException` - 当offset小于0或offset大于单元格字符长度。

### setShadingAttribute

    public void setShadingAttribute(long offset,
                                    long length,
                                    ShadingAttribute shadingAttr)

  设置指定位置的文字底纹属性。

  参数：
    `offset` - 起始位置
    `length` - 文字长度
    `shadingAttr` - 底纹属性

    例子:

         Document doc = Application.getWorkbooks().getActiveWorkbook().
         getDocuments().getActiveDocument();
         Section section = doc.getSection(0);
         BaseText baseText = section.getBaseText();
         Tables tables = doc.getTables();
         tables.insertTable(baseText,0,5,5);
         Table table = tables.getActiveTable();
         TableCell cell = table.getTableCell(1,1);
         cell.insertText(0,"cell");
         ShadingAttribute shadingAttr = new ShadingAttribute();
         shadingAttr.setTextureIndex(15);
         cell.setShadingAttribute(2,10,shadingAttr);

  抛出：
    `application.exceptions.MacroRunException` - 当指定区域被保护
    `application.exceptions.MacroRunException` - 当offset小于0或offset大于单元格字符长度。

概述 | 软件包 | 类 | 使用 | 树 | 索引 | 帮助

上一个类 下一个类 | 框架 无框架
摘要： 嵌套 | 字段 | 构造函数 | 方法 | 详细信息： 字段 | 构造函数 | 方法