Overview | Package | Class | Tree | Index | Help

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## application.workbooks.workbook
Class Worksheets

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

public class Worksheets
extends java.lang.Object

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

Method Summary
`void` | `activate(java.lang.String worksheetName)` 激活某一工作表。
`void` | `addCustomView(java.lang.String name, boolean hide)` 定义一个用户的自定义视图。
`Worksheet` | `addWorksheet()` 在当前集成文件中添加一个新的工作表。
`void` | `close()` 关闭电子表格文档。
`void` | `copySelectedWorksheets(java.lang.String workbookName, java.lang.String worksheetName)` 将当前集成文件中选中的工作表拷贝到一个指定的目标集成文件中去。
`void` | `deleteCustomView(java.lang.String name)` 删除一个用户的自定义视图。
`void` | `deleteRangeName(java.lang.String name)` 删除单元格或单元格区域名称。
`void` | `deleteWorksheet()` 删除当前的工作表。
`void` | `deleteWorksheets(java.lang.String[] sheetsName)` 删除指定的一个或多个工作表。
`void` | `fillAcrossWorksheet(int type)` 跨工作表填充。
`Worksheet` | `getActiveWorksheet()` 获得当前活动工作表实例。
`Worksheet[]` | `getAllWorksheets()` 获得集成文件中所有工作表的实例。
`PageSetup` | `getPageSetup()` 得到页面设置
`Print` | `getPrint()` 得到打印设置。
`int` | `getSheetCount()` 得到当前Worksheets中的工作表数。
`Worksheet` | `getWorksheet(int index)` 通过工作表的索引号取得相应的工作表实例。
`Worksheet` | `getWorksheet(java.lang.String name)` 通过工作表的名字取得相应的工作表实例。
`application.workbooks.workbook.charts.Chart` | `getWorksheetChart(java.lang.String chartName)` 得到独占工作表的图表。
`int` | `getZoom()` 得到当前缩放百分比。
`void` | `hideWorksheet()` 隐藏当前活动的工作表。
`void` | `hideWorksheet(java.lang.String worksheetName)` 隐藏指定工作表。
`Worksheet` | `insertWorksheet()` 在当前工作表前插入一个新的工作表。
`Worksheet` | `insertWorksheet(int index)` 在指定当前工作表前插入一个新的工作表。
`Worksheet` | `insertWorksheet(int index, java.lang.String name)` 在指定工作表前插入一个新的工作表,并重新命名。
`void` | `moveWorksheet(java.lang.String worksheetName)` 将当前集成文件中指定的单个工作表移动到一个新的集成文件中去。
`void` | `moveWorksheets(java.lang.String[] worksheetNames)` 将当前集成文件中指定的多个工作表移动到一个新的集成文件中去。
`void` | `moveWorksheetsAfter(java.lang.String[] worksheetNames, int index)` 将指定的工作表移动到一个指定的工作表之前去。
`void` | `moveWorksheetsBefore(java.lang.String[] worksheetNames, int index)` 将指定的工作表移动到一个指定的工作表之前去。
`void` | `moveWorksheetsBefore(java.lang.String[] worksheetNames, java.lang.String worksheetName)` 将指定的工作表移动到一个指定的工作表之前去。
`void` | `moveWorksheetsBefore(java.lang.String[] worksheetNames, java.lang.String bookName, java.lang.String worksheetName)` 将当前集成文件中选中的工作表移动到一个指定的目标集成文件中去。
`void` | `newWindow()` 新建一个内容与当前窗口内容完全相同的窗口。
`void` | `open()` 打开电子表格文档。
`void` | `renameWorksheet(java.lang.String oldName, java.lang.String newName)` 将当前活动的工作表重新命名。
`void` | `selectAllWorksheets()` 选中当前集成文件中的所有工作表。
`void` | `selectWorksheets(java.lang.String[] worksheetNames)` 选中一个或多个工作表。
`void` | `setDefaultBackground(FillAttribute fa)` 该方法设置整个电子表格的默认背景。
`void` | `setDefaultBorder(SsBorderAttribute ba)` 该方法设置整个电子表格的默认边框。
`void` | `setDefaultFont(CellAttribute ca)` 该方法设置整个电子表格的默认字体属性。
`void` | `setDefaultFormat(CellAttribute attr)` 该方法设置整个电子表格的默认单元格属性。
`void` | `setTrackChanges(boolean isTrack, int timeIndex, int authorIndex, java.lang.String where, boolean list, boolean display)` 设置高亮显示修订选项。
`void` | `showCustomView(java.lang.String name)` 显示一个用户的自定义视图。
`java.lang.String` | `toString()`
`void` | `unhideWorksheet(java.lang.String worksheetName)` 对指定的被隐藏的工作表，解除它的隐藏属性。

Methods inherited from class java.lang.Object
`equals, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Method Detail

### activate

    public void activate(java.lang.String worksheetName)

  激活某一工作表。

  Parameters:
    `worksheetName` - 要激活的工作表的名字

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.activate("sheet3");

### addCustomView

    public void addCustomView(java.lang.String name,
                              boolean hide)

  定义一个用户的自定义视图。

  Parameters:
    `name` - 自定义视图名称
    `hide` - 是否保存行列隐藏信息和过滤信息

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.addCustomView("v1",false);

### addWorksheet

    public Worksheet addWorksheet()

  在当前集成文件中添加一个新的工作表。

  例子：

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

### close

    public void close()

  关闭电子表格文档。 此方法将此book中的spreadsheet窗体关闭. 如果当前只有spreadsheet,则将整个文档关闭. Worksheets worksheets = Application.getWorkbooks() .getActiveWorkbook() .getWorksheets(); worksheets.getActiveWorksheet().insertWordDocument(); worksheets.close();

### copySelectedWorksheets

    public void copySelectedWorksheets(java.lang.String workbookName,
                                       java.lang.String worksheetName)

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

  Parameters:
    `workbookName` - 目标集成文件的名字
    `worksheetName` - 目标集成文件中的一个工作表名，被拷贝的工作表就放置在此工作表之前

    例子：

         Worksheets worksheets = Application.getWorkbooks().getActiveWorkbook()
         		.getWorksheets();
         Application.getWorkbooks().addWorkbook("龙的传人", 0);
         worksheets.copySelectedWorksheets("龙的传人", "工作表1");

### deleteCustomView

    public void deleteCustomView(java.lang.String name)

  删除一个用户的自定义视图。

  Parameters:
    `name` - 要删除的视图名字

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.deleteCustomView("v1");

### deleteRangeName

    public void deleteRangeName(java.lang.String name)

  删除单元格或单元格区域名称。

  Parameters:
    `name` - 单元格或单元格区域名称

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                            .getActiveWorkbook()
                                            .getWorksheets();
         worksheets.deleteRangeName("ABC");

### deleteWorksheet

    public void deleteWorksheet()

  删除当前的工作表。

  例子：

       Worksheets worksheets = Application.getWorkbooks()
                                         .getActiveWorkbook()
                                         .getWorksheets();
       worksheets.deleteWorksheet();

### deleteWorksheets

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

  删除指定的一个或多个工作表。

  Parameters:
    `sheetsName` - 待删除工作表的名字的列表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.deleteWorksheets(new String[] {"sheet1","sheet2"});

### fillAcrossWorksheet

    public void fillAcrossWorksheet(int type)

  跨工作表填充。

  Parameters:
    `type` - 填充方式 FillConstants.WORKSHEETS_ALL 填充内容和格式。 FillConstants.WORKSHEETS_CONTENT 只填充内容 FillConstants.WORKSHEETS_FORMAT 只填充格式

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         Range range = worksheets.getActiveWorksheet().getRange("a1:g10");
         range.fillRandom();
         worksheets.selectWorksheets(new String[]{"工作表1","工作表2","工作表3"});
         worksheets.fillAcrossWorksheet(FillConstants.WORKSHEETS_ALL);

### getActiveWorksheet

    public Worksheet getActiveWorksheet()

  获得当前活动工作表实例。

  Returns:
    工作表实例.如果当前没有活动工作表,则返回null.

    例子：

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

  See Also:
    `Worksheet`

### getAllWorksheets

    public Worksheet[] getAllWorksheets()

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

  Returns:
    工作表实例的数组

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();

  See Also:
    `Worksheet`

### getPageSetup

    public PageSetup getPageSetup()

  得到页面设置

### getPrint

    public Print getPrint()

  得到打印设置。

  Returns:
    打印设置

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         Print print = worksheets.getPrint();
         print.setPageNumbers("1,2,3");
         print.setCopies(2);
         print.setCollate(true);
         print.print();

  See Also:
    `Print`

### getSheetCount

    public int getSheetCount()

  得到当前Worksheets中的工作表数。

  Returns:
    当前Worksheets中的工作表数

    例子：

         Application.getWorkbooks()
                    .getActiveWorkbook()
                    .getWorksheets()
                    .getSheetCount();

### getWorksheet

    public Worksheet getWorksheet(int index)

  通过工作表的索引号取得相应的工作表实例。

  Parameters:
    `index` - 索引号
  Returns:
    工作表的实例。如果对应index的工作表不存在，则返回null。

    例子：

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

  See Also:
    `Worksheet`

### getWorksheet

    public Worksheet getWorksheet(java.lang.String name)

  通过工作表的名字取得相应的工作表实例。

  Parameters:
    `name` - 工作表名
  Returns:
    工作表实例。如果对应名字的工作表不存在，则返回null。

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.getWorksheet("sheet3"});

  See Also:
    `Worksheet`

### getWorksheetChart

    public application.workbooks.workbook.charts.Chart getWorksheetChart(java.lang.String chartName)

  得到独占工作表的图表。

  Parameters:
    `chartName` - 图表的名称

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.getWorksheetChart("chart1");

  Returns:
    得到的图表
  See Also:
    `Chart`

### getZoom

    public int getZoom()

  得到当前缩放百分比。

  Returns:
    当前缩放百分比，100为100％

    例子：

          int zoom = Application.getWorkbooks()
                    .getActiveWorkbook()
                    .getWorksheets()
                    .getZoom();
          System.out.println("zoom is "+zoom);

### hideWorksheet

    public void hideWorksheet()

  隐藏当前活动的工作表。

  例子：

       Worksheets worksheets = Application.getWorkbooks()
                                         .getActiveWorkbook()
                                         .getWorksheets();
       worksheets.hideWorksheet();

  See Also:
    `unhideWorksheet(java.lang.String)`

### hideWorksheet

    public void hideWorksheet(java.lang.String worksheetName)

  隐藏指定工作表。

  Parameters:
    `worksheetName` - 待隐藏的工作表名

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.hideWorksheet("sheet1");

  See Also:
    `unhideWorksheet(java.lang.String)`

### insertWorksheet

    public Worksheet insertWorksheet()

  在当前工作表前插入一个新的工作表。

  Returns:
    Worksheet 插入的工作表

    例子：

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

  See Also:
    `Worksheet`

### insertWorksheet

    public Worksheet insertWorksheet(int index)

  在指定当前工作表前插入一个新的工作表。

  Parameters:
    `index` - 插入的位置
  Returns:
    Worksheet 插入的工作表

    例子：

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

  See Also:
    `Worksheet`

### insertWorksheet

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

  在指定工作表前插入一个新的工作表,并重新命名。 如果name为null，则默认为只插入工作表而不重新命名。

  Parameters:
    `index` - 插入的位置.
    `name` - 工作表的名称
  Returns:
    Worksheet 插入的工作表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.insertWorksheet(1,"龙的传人");

  See Also:
    `Worksheet`

### moveWorksheet

    public void moveWorksheet(java.lang.String worksheetName)

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

  例子：

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

### moveWorksheets

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

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

  例子：

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

### moveWorksheetsAfter

    public void moveWorksheetsAfter(java.lang.String[] worksheetNames,
                                    int index)

  将指定的工作表移动到一个指定的工作表之前去。

  Parameters:
    `worksheetNames` - 指定的工作表
    `index` - 集成文件中的一个工作表索引，被移动的工作表就放置在此工作表之前 如果index大于当前工作表的总数,则默认插在最后位置.

    例子：

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

### moveWorksheetsBefore

    public void moveWorksheetsBefore(java.lang.String[] worksheetNames,
                                     int index)

  将指定的工作表移动到一个指定的工作表之前去。

  Parameters:
    `worksheetNames` - 指定的工作表
    `index` - 集成文件中的一个工作表索引，被移动的工作表就放置在此工作表之前

    例子：

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

### moveWorksheetsBefore

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

  将指定的工作表移动到一个指定的工作表之前去。

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

    例子：

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

### moveWorksheetsBefore

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

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

  Parameters:
    `worksheetNames` - 指定的工作表
    `bookName` - 目标集成文件的名字
    `worksheetName` - 集成文件中的一个工作表名，被移动的工作表就放置在此工作表之前

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         Application.getWorkbooks().addWorkbook("龙的传人",0);
         worksheets.moveWorksheetsBefore(new String[]{"工作表2","工作表3"},"龙的传人","工作表1");

### newWindow

    public void newWindow()

  新建一个内容与当前窗口内容完全相同的窗口。

  例子：

       Worksheets worksheets = Application.getWorkbooks()
                                         .getActiveWorkbook()
                                         .getWorksheets();
       worksheets.newWindow();

### open

    public void open()

  打开电子表格文档。 此方法将此book中spreadsheet窗体显示出来,而不是将关闭的文档打开. Worksheets worksheets = Application.getWorkbooks() .getActiveWorkbook() .getWorksheets(); worksheets.open();

### renameWorksheet

    public void renameWorksheet(java.lang.String oldName,
                                java.lang.String newName)

  将当前活动的工作表重新命名。

  Parameters:
    `oldName` - 原来的名字
    `newName` - 新的名字

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.renameWorksheet("sheet1","Table");

### selectAllWorksheets

    public void selectAllWorksheets()

  选中当前集成文件中的所有工作表。

  例子：

       Worksheets worksheets = Application.getWorkbooks()
                                         .getActiveWorkbook()
                                         .getWorksheets();
       worksheets.selectAllWorksheets();

### selectWorksheets

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

  选中一个或多个工作表。

  Parameters:
    `worksheetNames` - 要选中的工作表的名字的列表

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.selectWorksheets(new String[] {"sheet2","sheet3"});

### setDefaultBackground

    public void setDefaultBackground(FillAttribute fa)

  该方法设置整个电子表格的默认背景。

  Parameters:
    `fa` - 背景的默认填充属性

    例子：

         ActiveRange.getBackground()
                   .setTexture(new java.awt.Color(-3342388));
         Application.getWorkbooks()
                   .getActiveWorkbook()
                   .getWorksheets()
                   .setDefaultBackground(ActiveRange.getBackground());

  See Also:
    `FillAttribute`

### setDefaultBorder

    public void setDefaultBorder(SsBorderAttribute ba)

  该方法设置整个电子表格的默认边框。

  Parameters:
    `ba` - 默认的边框属性

    例子：

         SsBorderAttribute borderAttribute = new SsBorderAttribute();
         borderAttribute.setBorderLineType(BorderAndShadingConstants.DIAGONAL_FORWARD, 0);
         borderAttribute.setBorderLineWidth(BorderAndShadingConstants.DIAGONAL_FORWARD, 0.5f);
         borderAttribute.setBorderLineColor(BorderAndShadingConstants.DIAGONAL_FORWARD, new java.awt.Color(-16777216));
         Application.getWorkbooks()
                    .getActiveWorkbook()
                    .getWorksheets()
                    .setDefaultBorder(borderAttribute);

  See Also:
    `SsBorderAttribute`

### setDefaultFont

    public void setDefaultFont(CellAttribute ca)

  该方法设置整个电子表格的默认字体属性。

  Parameters:
    `ca` - 包含默认字体信息的单元格属性

    例子：

         CellAttribute cellAttribute = new CellAttribute();
         cellAttribute.setEnglishFontName("Times New Roman");
         cellAttribute.setAsiaFontName("永中宋体");
         cellAttribute.setFontStyle(0);
         cellAttribute.setFontSize(12);
         cellAttribute.setFontColor(new java.awt.Color(-16777216));
         cellAttribute.setUnderline(0);
         cellAttribute.setUnderlineColor(new java.awt.Color(-16777216));
         cellAttribute.setStrikeThrough(true);
         cellAttribute.setSuperscript(true);
         cellAttribute.setFontShadow(true);
         cellAttribute.setAllCaps(true);
         Application.getWorkbooks()
                    .getActiveWorkbook()
                    .getWorksheets()
                    .setDefaultFont(cellAttribute);

  See Also:
    `CellAttribute`

### setDefaultFormat

    public void setDefaultFormat(CellAttribute attr)

  该方法设置整个电子表格的默认单元格属性。

  Parameters:
    `attr` - 作为默认的单元格属性

    例子：

         CellAttribute cellAttribute = new CellAttribute();
         cellAttribute.setCategory(8);
         cellAttribute.setFormat("0.00E+00");
         cellAttribute.setHorizontalIndex(0);
         cellAttribute.setVerticalIndex(2);
         cellAttribute.setIndentSpinValue(0);
         cellAttribute.setOrientation(false);
         cellAttribute.setDegree(0);
         cellAttribute.setWrap(false);
         cellAttribute.setShrinkFit(false);
         Application.getWorkbooks()
                    .getActiveWorkbook()
                    .getWorksheets()
                    .setDefaultFormat(cellAttribute);

  See Also:
    `CellAttribute`

### setTrackChanges

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

  设置高亮显示修订选项。

  Parameters:
    `isTrack` - true，跟踪修订信息；false，不跟踪
    `timeIndex` - 时间选项索引

         -1－ 不选
         0 － 修订未经审阅
         1 － 全部

    `authorIndex` - 作者选项索引

         -1 － 不选

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

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                 .getActiveWorkbook()
                                 .getWorksheets();
         worksheets.setTrackChanges(true,1,-1,"",false,true);
         Range range = worksheets.getActiveWorksheet().getRange("c1:e10");
         range.fillRandom();

### showCustomView

    public void showCustomView(java.lang.String name)

  显示一个用户的自定义视图。

  Parameters:
    `name` - 要显示的自定义视图名称

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.showCustomView("v1");

### toString

    public java.lang.String toString()

### unhideWorksheet

    public void unhideWorksheet(java.lang.String worksheetName)

  对指定的被隐藏的工作表，解除它的隐藏属性。

  Parameters:
    `worksheetName` - 待解除隐藏的工作表名

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         worksheets.unhideWorksheet("sheet1");

Overview | Package | Class | Tree | Index | Help

PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

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