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

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

## application.workbooks.workbook
类 Worksheets

    java.lang.Object
      application.workbooks.workbook.Worksheets

    public class Worksheets

extends java.lang.Object

该类定义了工作表管理器对象的一些方法，如获取工作表，添加工作表，移动工作表，隐藏工作表，删除工作表等方法。

方法摘要
`void` | `acceptAllRevision(boolean accepted)` 全部接受或全部拒绝修订。
`void` | `activate(java.lang.String worksheetName)` 激活某一工作表。
`Worksheet` | `addWorksheet()` 在当前集成文件中添加一个新的工作表,位置位于最后。
`Worksheet` | `addWorksheet(java.lang.String name)` 添加工作表。
`void` | `close()` 关闭。
`void` | `copyWorksheets(java.lang.String[] worksheetNames, java.lang.String workbookName, java.lang.String worksheetName)` 将当前集成文件中指定的工作表拷贝到一个指定的目标集成文件中。
`void` | `copyWorksheetsToNew(java.lang.String[] worksheetNames)` 将当前集成文件中指定的工作表拷贝到一个新的集成文件中。
`Worksheet` | `getActiveWorksheet()` 获得当前活动工作表。
`Worksheet[]` | `getAllWorksheets()` 获得集成文件中所有工作表。
`int` | `getCount()` 获得工作表的数目。
`Names` | `getNames()` 获得名称管理器。
`Worksheet` | `getWorksheet(int index)` 通过工作表的索引号取得相应的工作表(索引号从1开始)。
`Worksheet` | `getWorksheet(java.lang.String name)` 通过工作表名称取得相应的工作表。
`Worksheet` | `insertWorksheet(int index)` 在指定的工作表前插入新工作表(索引号从1开始)。
`Worksheet` | `insertWorksheet(int index, java.lang.String name)` 在指定的工作表前插入指定的新工作表(索引号从1开始)。
`void` | `moveWorksheets(java.lang.String[] worksheetNames, java.lang.String worksheetName)` 将指定的工作表移动到本集成文件的其他工作表之前。
`void` | `moveWorksheets(java.lang.String[] worksheetNames, java.lang.String bookName, java.lang.String worksheetName)` 将当前集成文件中指定的工作表移动到一个指定的目标集成文件中。
`void` | `open()` 打开。
`void` | `removeWorksheet(java.lang.String sheetName)` 删除工作表。
`void` | `removeWorksheets(java.lang.String[] sheetsName)` 删除工作表。
`boolean` | `renameWorksheet(java.lang.String oldSheetName, java.lang.String newSheetName)` 工作表改名。
`void` | `selectWorksheet(java.lang.String worksheetName)` 选中某工作表。
`void` | `setTrackChanges(boolean isTrack)` 设置高亮显示修订选项。
`void` | `setTrackChanges(boolean isTrack, int timeIndex, int authorIndex, java.lang.String where, boolean list, boolean display)` 设置高亮显示修订选项。
`void` | `setWorksheetVisible(java.lang.String sheetName, boolean visible)` 工作表隐藏或解除隐藏。
`void` | `showAutoFilterDialog()`
`void` | `showWidthDialog()`

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

方法详细信息

### acceptAllRevision

    public void acceptAllRevision(boolean accepted)

  全部接受或全部拒绝修订。

  参数：
    `accepted` - true表示全部接受，false表示全部拒绝

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.setTrackChanges(true,TrackChangeConstants.TIME_ALL,TrackChangeConstants.AUTHOR_NONE,"",false,true);
         Worksheet worksheet = worksheets.getActiveWorksheet();
         worksheet.setCellValue(2,3,"Apple");
         worksheets.acceptAllRevision(true);

### activate

    public void activate(java.lang.String worksheetName)

  激活某一工作表。

  参数：
    `worksheetName` - 要激活的工作表的名字

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.activate("工作表2");

### addWorksheet

    public Worksheet addWorksheet()

  在当前集成文件中添加一个新的工作表,位置位于最后。

  返回：
    工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.addWorksheet();

### addWorksheet

    public Worksheet addWorksheet(java.lang.String name)

  添加工作表。

  参数：
    `name` - 工作表名
  返回：
    工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.addWorksheet("aa");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表名已存在

### close

    public void close()

  关闭。

### copyWorksheets

    public void copyWorksheets(java.lang.String[] worksheetNames,
                               java.lang.String workbookName,
                               java.lang.String worksheetName)

  将当前集成文件中指定的工作表拷贝到一个指定的目标集成文件中。

  参数：
    `worksheetNames` - 工作表
    `workbookName` - 目标集成文件名
    `worksheetName` - 目标集成文件中的一个工作表名，被拷贝的工作表就放置在此工作表之前 (注:当workbookName为NULL时表示在同一个工作表，当worksheetName为NULL时表示新工作表放置在末尾)

    例子：

         Workbook workbook =  Application.getWorkbooks().getActiveWorkbook();
         Application.getWorkbooks().openWorkbook("d:/temp/test.eio");
         Worksheets worksheets = workbook.getWorksheets();
         worksheets.copyWorksheets(new String[]{"工作表2"},"d:/temp/test.eio","工作表1");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在
    `application.exceptions.MacroRunException` - 当给定的集成文件不存在

### copyWorksheetsToNew

    public void copyWorksheetsToNew(java.lang.String[] worksheetNames)

  将当前集成文件中指定的工作表拷贝到一个新的集成文件中。

  参数：
    `worksheetNames` - 工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.copyWorksheetsToNew(new String[]{"工作表2","工作表3"});

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在

### getActiveWorksheet

    public Worksheet getActiveWorksheet()

  获得当前活动工作表。如果当前没有活动工作表，则返回null。

  返回：
    工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.getActiveWorksheet();

### getAllWorksheets

    public Worksheet[] getAllWorksheets()

  获得集成文件中所有工作表。

  返回：
    工作表实例的数组

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet[] wss = worksheets.getAllWorksheets();

### getCount

    public int getCount()

  获得工作表的数目。

  返回：
    工作表的数目

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         int size = worksheets.getCount();

### getNames

    public Names getNames()

  获得名称管理器。

  返回：
    名称管理器

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Names names = worksheets.getNames();

### getWorksheet

    public Worksheet getWorksheet(int index)

  通过工作表的索引号取得相应的工作表(索引号从1开始)。

  参数：
    `index` - 索引号
  返回：
    工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.getWorksheet(2);

### getWorksheet

    public Worksheet getWorksheet(java.lang.String name)

  通过工作表名称取得相应的工作表。

  参数：
    `name` - 工作表名
  返回：
    工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.getWorksheet("工作表3");

### insertWorksheet

    public Worksheet insertWorksheet(int index)

  在指定的工作表前插入新工作表(索引号从1开始)。

  参数：
    `index` - 工作表索引
  返回：
    新工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.insertWorksheet(1);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表索引错误或越界

### insertWorksheet

    public Worksheet insertWorksheet(int index,
                                     java.lang.String name)

  在指定的工作表前插入指定的新工作表(索引号从1开始)。

  参数：
    `index` - 工作表索引
    `name` - 工作表名称
  返回：
    新工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.insertWorksheet(2,"qq");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表名已存在
    `application.exceptions.MacroRunException` - 当给定的工作表索引错误或越界

### moveWorksheets

    public void moveWorksheets(java.lang.String[] worksheetNames,
                               java.lang.String worksheetName)

  将指定的工作表移动到本集成文件的其他工作表之前。

  参数：
    `worksheetNames` - 指定的工作表
    `worksheetName` - 集成文件中的一个工作表名，被移动的工作表就放置在此工作表之前

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.moveWorksheets(new String[]{"工作表2"},"工作表1");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在

### moveWorksheets

    public void moveWorksheets(java.lang.String[] worksheetNames,
                               java.lang.String bookName,
                               java.lang.String worksheetName)

  将当前集成文件中指定的工作表移动到一个指定的目标集成文件中。

  参数：
    `worksheetNames` - 指定的工作表
    `bookName` - 目标集成文件的名称
    `worksheetName` - 目标集成文件中的一个工作表名，被移动的工作表就放置在此工作表之前 (注：若bookName为NULL时表示在本集成文件中移动,若worksheetName为NULL,表示工作表移动到末尾)

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.moveWorksheets(new String[]{"工作表2"},"新集成文件","工作表1");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在
    `application.exceptions.MacroRunException` - 当给定的集成文件不存在

### open

    public void open()

  打开。

### removeWorksheet

    public void removeWorksheet(java.lang.String sheetName)

  删除工作表。

  参数：
    `sheetsName` - 工作表名称

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.removeWorksheet("工作表1");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在

### removeWorksheets

    public void removeWorksheets(java.lang.String[] sheetsName)

  删除工作表。

  参数：
    `sheetsName` - 工作表名称

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.removeWorksheets(new String[]{"工作表1"});

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在

### renameWorksheet

    public boolean renameWorksheet(java.lang.String oldSheetName,
                                   java.lang.String newSheetName)

  工作表改名。

  参数：
    `oldSheetName` - 原工作表名称
    `newSheetName` - 新工作表名称

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.renameWorksheet("工作表2","工作表123");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的原工作表不存在
    `application.exceptions.MacroRunException` - 当给定的新工作表已存在

### selectWorksheet

    public void selectWorksheet(java.lang.String worksheetName)

  选中某工作表。

  参数：
    `worksheetName` - 工作表名

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.selectWorksheet("工作表2");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在

### setTrackChanges

    public void setTrackChanges(boolean isTrack)

  设置高亮显示修订选项。

  参数：
    `isTrack` - true，跟踪修订信息；false，不跟踪
    `timeIndex` - 时间选项索引,其取值取如下常量：

         TIME_NONE     － 不选
         TIME_UNTRACKED   － 修订未经审阅
         TIME_ALL － 全部

    `authorIndex` - 作者选项索引,其取值取有如下常量之一：

         AUTHOR_NONE － 不选

    `where` - 本表中跟踪修订的位置
    `list` - true，在新表中列举修订信息；false，不在新表中列举修订信息
    `display` - true，高亮显示修订信息；false，不高亮显示

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.setTrackChanges(true);
         Worksheet worksheet = worksheets.getActiveWorksheet();
         worksheet.setCellValue(2,3,"Apple");

  另请参见：
    `TrackChangeConstants`

### setTrackChanges

    public void setTrackChanges(boolean isTrack,
                                int timeIndex,
                                int authorIndex,
                                java.lang.String where,
                                boolean list,
                                boolean display)

  设置高亮显示修订选项。

  参数：
    `isTrack` - true，跟踪修订信息；false，不跟踪
    `timeIndex` - 时间选项索引,其取值取如下常量：

         TIME_NONE     － 不选
         TIME_UNTRACKED   － 修订未经审阅
         TIME_ALL － 全部

    `authorIndex` - 作者选项索引,其取值取有如下常量之一：

         AUTHOR_NONE － 不选

    `where` - 本表中跟踪修订的位置
    `list` - true，在新表中列举修订信息；false，不在新表中列举修订信息
    `display` - true，高亮显示修订信息；false，不高亮显示

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.setTrackChanges(true,TrackChangeConstants.TIME_ALL,TrackChangeConstants.AUTHOR_NONE,"",false,true);
         Worksheet worksheet = worksheets.getActiveWorksheet();
         worksheet.setCellValue(2,3,"Apple");

  抛出：
    `application.exceptions.MacroRunException` - 当给定参数的数值错误或越界
  另请参见：
    `TrackChangeConstants`

### setWorksheetVisible

    public void setWorksheetVisible(java.lang.String sheetName,
                                    boolean visible)

  工作表隐藏或解除隐藏。

  参数：
    `sheetName` - 工作表名
    `visible` - TRUE表示解除隐藏，FALSE表示隐藏

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         worksheets.setWorksheetVisible("工作表1",false);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的工作表不存在

### showAutoFilterDialog

    public void showAutoFilterDialog()

### showWidthDialog

    public void showWidthDialog()

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

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