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

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

## application.workbooks.workbook
类 Tables

    java.lang.Object
      application.workbooks.workbook.Tables

    public class Tables

extends java.lang.Object

封装了某个区域所有自由表格的一个集合，是一个表格管理器，提供了插入，删除表格，得到表格等功能。

方法摘要
`Table` | `addTable(TextRange range, int row, int column)` 在指定区域的起始位置处插入一张表格，并覆盖区域原来的内容。
`Table` | `addTable(TextRange range, int row, int column, int autoFit, float cellWidth)` 在指定区域的起始位置处插入一张表格。
`Table` | `addTable(TextRange range, int row, int column, java.lang.String tableName)` 在指定区域的起始位置处插入一张表格，并覆盖区域原来的内容。
`Table` | `addTable(TextRange range, int row, int column, java.lang.String tableName, int autoFit, float cellWidth)` 在指定区域的起始位置处插入一张表格。
`Table` | `getActiveTable()` 得到当前表格。
`Table[]` | `getAllTables()` 得到当前集合中的所有表格对象。
`int` | `getCount()` 得到集合中的表格总数。
`Table` | `getTable(int index)` 得到指定的表格对象。
`Table` | `getTable(java.lang.String tableName)` 得到指定名字的表格对象。
`boolean` | `isVoidFrameVisible()` 判断文档是否允许显示表格的虚框。
`void` | `removeTable(int index)` 删除集合中指定的表格。
`void` | `removeTable(java.lang.String tableName)` 删除集合中指定名字的表格
`void` | `setAllowDeleted(boolean deleted)` 设置集合中的表格对象是否允许被删除。
`void` | `setAllowSelected(boolean seleted)` 设置集合中的表格对象是否允许被选中。
`void` | `setVoidFrameVisible(boolean isVoid)` 设置文档是否允许显示表格的虚框。

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

方法详细信息

### addTable

    public Table addTable(TextRange range,
                          int row,
                          int column)

  在指定区域的起始位置处插入一张表格，并覆盖区域原来的内容。 说明：新插入的表格固定列宽，宽度值设为自动，即根据当前页面宽度自动计算出列宽。

  参数：
    `range` - 指定的文本编辑区域
    `row` - 表格的行数
    `column` - 表格的列数
  返回：
    返回新插入的表格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         System.out.println("表格名字为：" + table.getName());

  另请参见：
    `addTable(TextRange, int, int, String)`, `addTable(TextRange, int, int, int, float)`, `addTable(TextRange, int, int, String, int, float)`

### addTable

    public Table addTable(TextRange range,
                          int row,
                          int column,
                          int autoFit,
                          float cellWidth)

  在指定区域的起始位置处插入一张表格。

  参数：
    `range` - 指定的文本编辑区域
    `row` - 表格的行数
    `column` - 表格的列数
    `autoFit` - 插入表格时列宽是否要自适应文本内容，只能取以下整形值之一：

                TableConstants.FIXED_COLUMN_WIDTH  固定列宽
                TableConstants.AUTOFIT_CONTENT     列宽自适应文本内容
                TableConstants.AUTOFIT_WINDOW      根据窗口调整表格

    `cellWidth` - 当固定列宽时，表格的列宽值，以磅为单位。参数取值范围为0~1584磅。 说明：如果其值为0，则表格的列宽值设为自动。此值根据插入表格时页面的宽度自动计算出列的宽度。 如果参数autoFit设置为AUTOFIT_CONTENT或AUTOFIT_WINDOW，则此参数不起作用。
  返回：
    返回新插入的表格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5, TableConstants.AUTOFIT_CONTENT, 0);
         System.out.println("表格名字为：" + table.getName());

  另请参见：
    `addTable(TextRange, int, int)`, `addTable(TextRange, int, int, String)`, `addTable(TextRange, int, int, String, int, float)`

### addTable

    public Table addTable(TextRange range,
                          int row,
                          int column,
                          java.lang.String tableName)

  在指定区域的起始位置处插入一张表格，并覆盖区域原来的内容。 说明：新插入的表格固定列宽，宽度值设为自动，即根据当前页面宽度自动计算出列宽。

  参数：
    `range` - 指定的文本编辑区域
    `row` - 表格的行数
    `column` - 表格的列数
    `tableName` - 表格的名字
  返回：
    返回新插入的表格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5, "我的表格");
         System.out.println("表格名字为：" + table.getName());

  另请参见：
    `addTable(TextRange, int, int)`, `addTable(TextRange, int, int, int, float)`, `addTable(TextRange, int, int, String, int, float)`

### addTable

    public Table addTable(TextRange range,
                          int row,
                          int column,
                          java.lang.String tableName,
                          int autoFit,
                          float cellWidth)

  在指定区域的起始位置处插入一张表格。

  参数：
    `range` - 指定的文本编辑区域
    `row` - 表格的行数
    `column` - 表格的列数
    `tableName` - 表格的名字
    `autoFit` - 插入表格时列宽是否要自适应文本内容，只能取以下整形值之一：

                TableConstants.FIXED_COLUMN_WIDTH  固定列宽
                TableConstants.AUTOFIT_CONTENT     列宽自适应文本内容
                TableConstants.AUTOFIT_WINDOW      根据窗口调整表格

    `cellWidth` - 当固定列宽时，表格的列宽值，以磅为单位 说明：如果其值为0，则表格的列宽值设为自动。此值根据插入表格时页面的宽度自动计算出列的宽度。 参数取值范围为0~1584磅
  返回：
    返回新插入的表格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5, "我的表格", TableConstants.FIXED_COLUMN_WIDTH, 50.0f);
         System.out.println("表格名字为：" + table.getName());

  另请参见：
    `addTable(TextRange, int, int)`, `addTable(TextRange, int, int, String)`, `addTable(TextRange, int, int, int, float)`

### getActiveTable

    public Table getActiveTable()

  得到当前表格。如果当前没有表格，则返回null。

  返回：
    Table 所得到的当前表格

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range,5,5);
         Table table = tables.getActiveTable();
         System.out.println(table.getName());

### getAllTables

    public Table[] getAllTables()

  得到当前集合中的所有表格对象。

  返回：
    所有表格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5, "我的表格");
         range.insertText("无锡永中科技有限公司\n无锡永中科技有限公司\n无锡永中科技有限公司\n");
         range = doc.getRange(doc.getLength());
         tables.addTable(range, 3, 4);
         Table[] alltable = tables.getAllTables();
         System.out.println("表格1名字为：" + alltable[0].getName());
         System.out.println("表格2名字为：" + alltable[1].getName());

  另请参见：
    `getTable(int)`, `getTable(String)`

### getCount

    public int getCount()

  得到集合中的表格总数。

  返回：
    返回集合中的表格数

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5, "我的表格");
         range.insertText("无锡永中科技有限公司\n无锡永中科技有限公司\n无锡永中科技有限公司\n");
         range = doc.getRange(doc.getLength());
         tables.addTable(range, 3, 4);
         Table[] alltable = tables.getAllTables();
         System.out.println("集合中的表格数为：" + tables.getCount());

### getTable

    public Table getTable(int index)

  得到指定的表格对象。

  参数：
    `index` - 表格集合中的索引值
  返回：
    返回表格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5);
         Table table = tables.getTable(0);
         System.out.println("表格名字为：" + table.getName());

  另请参见：
    `getTable(String)`, `getAllTables()`

### getTable

    public Table getTable(java.lang.String tableName)

  得到指定名字的表格对象。

  参数：
    `tableName` - 表格的名字
  返回：
    返回表格对象

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5, "我的表格");
         Table table = tables.getTable("我的表格");
         System.out.println("表格名字为：" + table.getName());

  另请参见：
    `getTable(int)`, `getAllTables()`

### isVoidFrameVisible

    public boolean isVoidFrameVisible()

  判断文档是否允许显示表格的虚框。 说明：表格的虚框是指当表格的边框样式设置为无时，显示表格轮廓的虚线。根据这个属性可显示或隐藏表格的虚框。

  返回：
    返回是否允许显示表格的虚框，如果为false，则隐藏表格虚框，否则显示虚框

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5, 5);
         System.out.println("返回文档是否允许显示表格的虚框：" + tables.isVoidFrameVisible());

  另请参见：
    `setVoidFrameVisible(boolean)`

### removeTable

    public void removeTable(int index)

  删除集合中指定的表格。

  参数：
    `index` - 被删表格对象在集合中的索引值

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5, "我的表格");
         range.insertText("无锡永中科技有限公司\n无锡永中科技有限公司\n无锡永中科技有限公司\n");
         range = doc.getRange(doc.getLength());
         tables.addTable(range, 3, 4);
         tables.removeTable(0);

  另请参见：
    `removeTable(String)`, `Table.delete()`

### removeTable

    public void removeTable(java.lang.String tableName)

  删除集合中指定名字的表格

  参数：
    `tableName` - 表格的名字

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5, "我的表格");
         range.insertText("无锡永中科技有限公司\n无锡永中科技有限公司\n无锡永中科技有限公司\n");
         range = doc.getRange(doc.getLength());
         tables.addTable(range, 3, 4);
         tables.removeTable("我的表格");

  另请参见：
    `removeTable(int)`, `Table.delete()`

### setAllowDeleted

    public void setAllowDeleted(boolean deleted)

  设置集合中的表格对象是否允许被删除。

  参数：
    `deleted` - 是否允许被删除，如果为true，则可以被删除

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5);
         tables.setAllowDeleted(false);

### setAllowSelected

    public void setAllowSelected(boolean seleted)

  设置集合中的表格对象是否允许被选中。

  参数：
    `seleted` - 是否允许被选中，如果为true，则可以被选中

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         tables.addTable(range, 5, 5);
         tables.setAllowSelected(false);

### setVoidFrameVisible

    public void setVoidFrameVisible(boolean isVoid)

  设置文档是否允许显示表格的虚框。 说明：表格的虚框是指当表格的边框样式设置为无时，显示表格轮廓的虚线。根据这个属性可显示或隐藏表格的虚框。

  参数：
    `isVoid` - 是否允许显示表格的虚框，如果为false，则隐藏表格虚框，否则显示虚框

    例子：

         Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
         TextRange range = doc.getRange(0);
         Tables tables = doc.getTables();
         Table table = tables.addTable(range, 5,5);
         BorderAttribute borderAttribute = table.getBorderAttribute();
         borderAttribute.setBorderType(BorderAndShadingConstants.BORDERTYPE_NONE);
         table.setBorderAttribute(borderAttribute);
         tables.setVoidFrameVisible(false);

  另请参见：
    `isVoidFrameVisible()`

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

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

版权所有 2001-2008 无锡永中科技有限公司