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

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

## application.workbooks.workbook.worksheets
类 Worksheet

    java.lang.Object
      application.workbooks.workbook.worksheets.Worksheet

    public class Worksheet

extends java.lang.Object

该类定义了对工作表对象进行操作的一些方法，如设置工作表名称，获取工作表区域，定位到工作表某一区域，设置超链接，插入注释等。

方法摘要
`void` | `activate()` 激活工作表。
`Chart` | `addFloatingChart(int chartType, int subType, java.lang.String rangeAddress, boolean isRow)` 添加浮动图表。
`void` | `addHPageBreak(int row)` 在指定行处增加水平分页符。
`void` | `addHVPageBreak(int row, int column)` 在指定位置处增加水平分页符和垂直分页符。
`void` | `addVPageBreak(int column)` 在指定列处增加垂直分页符。
`void` | `addWorksheetListener(WorksheetListener sl)` 向Worksheet注册监听器
`void` | `circleInvalid()` 圈出无效数据（不符合数据有效性的数据）。
`void` | `clearArrows()` 删除所有追踪箭头。
`void` | `clearCircles()` 清除验证圈。
`void` | `deleteBackground()` 删除当前工作表的背景图片。
`void` | `deleteEntireColumns(int startCol, int endCol)` 删除整列，表示右方单元格左移至相应位置。
`void` | `deleteEntireRows(int startRow, int endRow)` 删除整行，并使下方单元格上移至相应位置。
`Cell` | `getActiveCell()` 获取工作表中的活动单元格。
`Chart` | `getActiveChart()` 获得工作表下活动图表。
`Range` | `getActiveRange()` 获取工作表中的活动单元格区域。
`Cell` | `getCell(int row, int column)` 根据行号和列号获取指定单元格。
`Cell` | `getCell(java.lang.String cellAddress)` 根据单元格地址获取指定单元格。
`java.lang.String` | `getCellString(int row, int column)` 根据行号和列号获取指定单元格内的字符内容。
`java.lang.Object` | `getCellValue(int row, int column)` 根据行号和列号获取指定单元格内容。
`Chart[]` | `getCharts()` 取得该工作表上的所有图表。
`Columns` | `getColumns(int startColumn, int endColumn)` 根据起始列号和终止列号获取指定列对象。
`Columns` | `getColumns(java.lang.String columnAddress)` 根据列地址获取列对象。
`SsComments` | `getComments()` 获得注释管理器。
`application.workbooks.workbook.worksheets.ComponentManager` | `getComponentManager()` 获得工作表上控件管理器。
`SsHyperlinks` | `getHyperlinks()` 获得超链接管理器。
`int` | `getMaxColumn()` 取得最大列数。
`int` | `getMaxDataColumn()` 得到当前工作表内拥有数据区域的最大列号。
`int` | `getMaxDataRow()` 得到当前工作表内拥有数据区域的最大行号。
`int` | `getMaxRow()` 获取最大行数。
`java.lang.String` | `getName()` 获得当前工作表的名称。
`SsPageSetup` | `getPageSetup()` 获得工作表的页面设置。
`Print` | `getPrint()` 获得打印机。
`PrintPreview` | `getPrintPreview()` 得到打印预览。
`Range` | `getRange(int startRow, int startCol, int endRow, int endCol)` 获得单元格区域。
`Range` | `getRange(java.lang.String rangeAddress)` 获得单元格区域。
`Rows` | `getRows(int startRow, int endRow)` 根据起始行号和终止行号获取行对象。
`Rows` | `getRows(java.lang.String rowsAddress)` 根据行地址获取行对象。
`Scenarios` | `getScenarios()` 获得方案管理器。
`SsShapes` | `getShapes()` 获取工作表的自选图形管理器。
`double` | `getStandardColumnWidth()` 获得标准列宽(默认度量单位:磅)。
`double` | `getStandardRowHeight()` 获得标准行高(默认度量单位:磅)。
`Workbook` | `getWorkbook()` 返回工作表所属的集成文件。
`int` | `getZoom()` 返回当前工作表的显示比例。
`Range` | `gotoRange(java.lang.String refer)` 定位到指定的单元格区域。
`Range` | `gotoSpecial(int type, int detail)` 特殊定位。
`boolean` | `hasAutoFilter()` 得到当前Worksheet中是否有自动筛选区域。
`void` | `insertEntireColumns(int startCol, int endCol)` 在该列处插入整列。
`void` | `insertEntireRows(int startRow, int endRow)` 在该选定行处插入整行。
`void` | `insertMultiMedia(java.lang.String name)` 在当前的工作表单元格中插入一个影音文件。
`void` | `insertPicture(java.lang.String pictureName)` 在当前的工作表中插入一幅图片。
`boolean` | `isVisible()` 工作表是否隐藏。
`boolean` | `isWorksheetChart()` 返回工作表是否图表工作表。
`void` | `protect(int type, java.lang.String password)` 对指定工作表进行保护，并设置保护类型。
`void` | `refresh()` 刷新视图。
`void` | `removeDependentArrows(int row, int column)` 删除从属单元格追踪箭头。
`void` | `removeHPageBreak(int row)` 删除指定行处的水平分页符。
`void` | `removeHVPageBreak(int row, int column)` 删除指定位置处的水平分页符和垂直分页符。
`void` | `removePrecedentArrows(int row, int column)` 删除引用单元格追踪箭头。
`void` | `removeVPageBreak(int column)` 删除指定列处的垂直分页符。
`void` | `resetTabBarBackground()` 重置工作表标签的背景色。
`void` | `resetTabBarForeground()` 重置工作表标签的前景色。
`void` | `select(int startRow, int startColumn, int endRow, int endColumn)` 选中活动工作表中的单元格或单元格区域。
`void` | `select(java.lang.String address)` 选中活动工作表中的单元格或单元格区域。
`void` | `selectAll()` 选中活动工作表中的所有单元格。
`void` | `setBackground(java.lang.String pictureName)` 设置当前整个工作表的背景图片。
`void` | `setCellValue(int row, int column, boolean value)` 给行号和列号指定的单元格设置内容。
`void` | `setCellValue(int row, int column, double value)` 给行号和列号指定的单元格设置内容。
`void` | `setCellValue(int row, int column, double[][] values, boolean horizontal)` 给以指定的行号和列号为起点的单元格区域设置内容。
`void` | `setCellValue(int row, int column, double[] value, boolean horizontal)` 给以指定的行号和列号为起点的单元格区域设置内容。
`void` | `setCellValue(int row, int column, int[] value, boolean horizontal)` 给以指定的行号和列号为起点的单元格区域设置内容。
`void` | `setCellValue(int row, int column, long value)` 给行号和列号指定的单元格设置内容。
`void` | `setCellValue(int row, int column, long[][] values, boolean horizontal)` 给以指定的行号和列号为起点的单元格区域设置内容。
`void` | `setCellValue(int row, int column, long[] value, boolean horizontal)` 给以指定的行号和列号为起点的单元格区域设置内容。
`void` | `setCellValue(int row, int column, java.lang.String value)` 给行号和列号指定的单元格设置内容。
`void` | `setCellValue(int row, int column, java.lang.String[][] values, boolean horizontal)` 给以指定的行号和列号为起点的单元格区域设置内容。
`void` | `setCellValue(int row, int column, java.lang.String[] value, boolean horizontal)` 给以指定的行号和列号为起点的单元格区域设置内容。
`void` | `setName(java.lang.String name)` 设置工作表的名字。
`void` | `setStandardColumnWidth(double width)` 设置标准列宽(默认度量单位:磅)。
`void` | `setStandardRowHeight(double height)` 设置标准行高(默认度量单位:磅)。
`void` | `setTabBarBackground(java.awt.Color color)` 设置工作表标签栏工作表标签的背景色。
`void` | `setTabBarForeground(java.awt.Color color)` 设置工作表标签栏上工作表标签的前景色。
`void` | `setVisible(boolean visible)` 隐藏/显示活动工作表。
`void` | `setZoom(int zoom)` 设置当前工作表的显示比例。
`void` | `showAllData()` 显示所有被筛选后隐藏的行。
`void` | `showDependentArrows(int row, int column)` 追踪从属单元格(内容是数值)。
`void` | `showPrecedentArrows(int row, int column)` 追踪引用单元格(此单元格为公式)，绘制出一个从为活动单元格（公式）提供数据的单元格指向活动单元格的蓝色箭头。
`void` | `showTraceError(int row, int column)` 显示错误追踪箭头(单元格的公式结果是错误值)。
`void` | `translateToSimple()` 将当前工作表内的文字编码方式转换为简体编码方式。
`void` | `translateToTraditional()` 将当前工作表内的文字编码方式转换为繁体编码方式。
`boolean` | `unprotect(java.lang.String password)` 对工作表解除保护。

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

方法详细信息

### activate

    public void activate()

  激活工作表。

  例子:

       Worksheets sheets = Application.getWorkbooks().getActiveWorkbook().getWorksheets();
       Worksheet sheet = sheets.getWorksheet(1);
       sheet.activate();

### addFloatingChart

    public Chart addFloatingChart(int chartType,
                                  int subType,
                                  java.lang.String rangeAddress,
                                  boolean isRow)

  添加浮动图表。

  参数：
    `chartType` - 图表主类型
    `subType` - 图表次类型
    `rangeAddress` - 图表数据源
    `isRow` - TRUE 表示按行，FALSE 表示按列
  返回：
    浮动图表

    例子：

         Workbook book =  Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range=sheet.getRange("A5:E12");
         range.fillRandom();
         sheet.addFloatingChart(ChartConstants.EMOCHART_COLUMN, ChartConstants.EMOCOLUMN_STACKED, "A5:E12", false);

  另请参见：
    `ChartConstants`

### addHPageBreak

    public void addHPageBreak(int row)

  在指定行处增加水平分页符。

  参数：
    `row` - 行号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.addHPageBreak(5);

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

### addHVPageBreak

    public void addHVPageBreak(int row,
                               int column)

  在指定位置处增加水平分页符和垂直分页符。

  参数：
    `row` - 行号
    `column` - 列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.addHVPageBreak(3,7);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### addVPageBreak

    public void addVPageBreak(int column)

  在指定列处增加垂直分页符。

  参数：
    `column` - 列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.addVPageBreak(5);

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

### addWorksheetListener

    public void addWorksheetListener(WorksheetListener sl)

  向Worksheet注册监听器

  参数：
    `sl` - 监听器对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         WorksheetListener listener = new WorksheetListener()
         {
              void sheetChanged(WorksheetEvent e)
              {
                  System.out.println("This worksheet is changed. The type is " + e.getType());
              }
         };
         worksheet.addWorksheetListener(listener);

### circleInvalid

    public void circleInvalid()

  圈出无效数据（不符合数据有效性的数据）。

  例子:

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

### clearArrows

    public void clearArrows()

  删除所有追踪箭头。使用审核功能可添加追踪箭头。

  例子:

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

### clearCircles

    public void clearCircles()

  清除验证圈。使用审核功能可添加追踪箭头。

  例子:

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

### deleteBackground

    public void deleteBackground()

  删除当前工作表的背景图片。

  例子:

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

### deleteEntireColumns

    public void deleteEntireColumns(int startCol,
                                    int endCol)

  删除整列，表示右方单元格左移至相应位置。

  参数：
    `startCol` - 开始列号
    `endCol` - 结束列号

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.deleteEntireColumns(3,5);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界
    `application.exceptions.MacroRunException` - 当区域的起始行大于结束行
    `application.exceptions.MacroRunException` - 当工作表单元格已被保护

### deleteEntireRows

    public void deleteEntireRows(int startRow,
                                 int endRow)

  删除整行，并使下方单元格上移至相应位置。

  参数：
    `startRow` - 开始行号
    `endRow` - 结束行号

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.deleteEntireRows(3,5);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界
    `application.exceptions.MacroRunException` - 当区域的起始行大于结束行
    `application.exceptions.MacroRunException` - 当工作表单元格已被保护

### getActiveCell

    public Cell getActiveCell()

  获取工作表中的活动单元格。

  返回：
    活动单元格对象

    例子:

         本示例将获取工作表3中活动单元格。

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getWorksheet("工作表3");
         Cell cell = sheet.getActiveCell();

### getActiveChart

    public Chart getActiveChart()

  获得工作表下活动图表。

  返回：
    当前活动图表

    例子：

         Workbook book =  Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Range range=sheet.getRange("A5:E12");
         range.fillRandom();
         Charts charts = book.getCharts();
         charts.addFloatingChart(ChartConstants.EMOCHART_COLUMN,ChartConstants.EMOCOLUMN_STACKED,"工作表1");
         Chart chart = sheet.getActiveChart();
         System.out.println(chart.getMainType());

  另请参见：
    `ChartConstants`

### getActiveRange

    public Range getActiveRange()

  获取工作表中的活动单元格区域。

  返回：
    活动单元格区域对象

    例子:

         本示例将获取工作表3中活动单元格区域。

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getWorksheet("工作表3");
         Range range = sheet.getActiveRange();

### getCell

    public Cell getCell(int row,
                        int column)

  根据行号和列号获取指定单元格。

  参数：
    `row` - 行号
    `column` - 列号
  返回：
    由行号和列号指定的单元格对象

    例子:

         本示例将获取当前活动工作表中第3行，第6列的单元格。

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Cell cell = worksheet.getCell(3,6);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### getCell

    public Cell getCell(java.lang.String cellAddress)

  根据单元格地址获取指定单元格。

  参数：
    `cellAddress` - 单元格地址，如"A1"
  返回：
    由单元格地址指定的单元格对象

    例子:

         本示例将获取当前活动工作表中地址为"C4"的单元格。

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Cell cell = worksheet.getCell("C4");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界
    `application.exceptions.MacroRunException` - 当不是单元格地址

### getCellString

    public java.lang.String getCellString(int row,
                                          int column)

  根据行号和列号获取指定单元格内的字符内容。

  参数：
    `row` - 行号
    `column` - 列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getCell(3,6).setValue("aaaa");
         String s =  worksheet.getCellString(3,6);
         System.out.println("The cell string is " + s);

  返回：
    单元格内的字符串
  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### getCellValue

    public java.lang.Object getCellValue(int row,
                                         int column)

  根据行号和列号获取指定单元格内容。

  参数：
    `row` - 行号
    `column` - 列号
  返回：
    单元格内容

    例子:

         本示例将获取当前活动工作表中第3行，第6列单元格中的内容。

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setCellValue(3,6,"Apple");
         Object obj = worksheet.getCellValue(3,6);
         System.out.println("The cell value is " + obj);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### getCharts

    public Chart[] getCharts()

  取得该工作表上的所有图表。

  返回：
    所有图表

    例子：

         Workbook book =  Application.getWorkbooks().getActiveWorkbook();
         Worksheet sheet = book.getWorksheets().getActiveWorksheet();
         Chart[] charts = sheet.getCharts();

### getColumns

    public Columns getColumns(int startColumn,
                              int endColumn)

  根据起始列号和终止列号获取指定列对象。如要选取A列到C列的所用列，则startColumn为1，endColumn为3

  参数：
    `startColumn` - 起始列号
    `endColumn` - 终止列号
  返回：
    指定列对象

    例子:

         本示例将获取当前活动工作表的第2至第4列。

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns(2,4);

  抛出：
    `application.exceptions.MacroRunException` - 当区域的起始列大于结束列
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### getColumns

    public Columns getColumns(java.lang.String columnAddress)

  根据列地址获取列对象。

  参数：
    `columnAddress` - 列地址，如"B:C"
  返回：
    指定列对象

    例子:

         本示例将获取当前活动工作表的第B至第D行列、第E至H列。

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Columns columns = worksheet.getColumns("B:D");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### getComments

    public SsComments getComments()

  获得注释管理器。

  返回：
    注释管理器对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         SsComments comments = worksheet.getComments();
         Comment comment = comments.insertComment(2,3);
         comment.setText("comment's content");

### getComponentManager

    public application.workbooks.workbook.worksheets.ComponentManager getComponentManager()

  获得工作表上控件管理器。

  返回：
    控件管理器

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         ComponentManager components = worksheet.getComponentManager();
         components.addButtonComponent(3,3);

### getHyperlinks

    public SsHyperlinks getHyperlinks()

  获得超链接管理器。

  返回：
    超链接管理器对象

    例子:

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         SsHyperlinks hyperlinks = sheet.getHyperlinks();

### getMaxColumn

    public int getMaxColumn()

  取得最大列数。

  返回：
    最大列数

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         int maxc = worksheet.getMaxColumn();
         System.out.println("Max column is " + maxc);

### getMaxDataColumn

    public int getMaxDataColumn()

  得到当前工作表内拥有数据区域的最大列号。

  返回：
    列数

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getCell(3,6).setValue("sdsdf");
         System.out.println(worksheet.getMaxDataColumn());

### getMaxDataRow

    public int getMaxDataRow()

  得到当前工作表内拥有数据区域的最大行号。

  返回：
    行数

    例子:

          Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getCell(3,6).setValue("sdsdf");
         System.out.println(worksheet.getMaxDataRow());

### getMaxRow

    public int getMaxRow()

  获取最大行数。

  返回：
    最大行数

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         int maxr = worksheet.getMaxRow();
         System.out.println("Max row is " + maxr);

### getName

    public java.lang.String getName()

  获得当前工作表的名称。

  返回：
    工作表名称

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         String name = worksheet.getName();
         System.out.println("Name is " + name);

### getPageSetup

    public SsPageSetup getPageSetup()

  获得工作表的页面设置。

  返回：
    页面设置对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         SsPageSetup pageSetup = worksheet.getPageSetup();

### getPrint

    public Print getPrint()

  获得打印机。

  返回：
    打印机对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                           .getWorksheets().getActiveWorksheet();
         Print print = worksheet.getPrint();

### getPrintPreview

    public PrintPreview getPrintPreview()

  得到打印预览。

  返回：
    打印预览

    例子：

         Worksheets worksheets = Application.getWorkbooks()
                                           .getActiveWorkbook()
                                           .getWorksheets();
         PrintPreview printPreview = worksheets.getActiveWorksheet().getPrintPreview();
         printPreview.preview();

### getRange

    public Range getRange(int startRow,
                          int startCol,
                          int endRow,
                          int endCol)

  获得单元格区域。

  参数：
    `startRow` - 起始行
    `startCol` - 起始列
    `endRow` - 终止行
    `endCol` - 终止列
  返回：
    单元格区域对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange(1,1,4,4);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界
    `application.exceptions.MacroRunException` - 当区域的起始行或列必须小于等于结束行或列

### getRange

    public Range getRange(java.lang.String rangeAddress)

  获得单元格区域。

  参数：
    `rangeAddress` - 单元格区域地址，如"A1:D4"
  返回：
    单元格区域对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("A1:D4");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### getRows

    public Rows getRows(int startRow,
                        int endRow)

  根据起始行号和终止行号获取行对象。

  参数：
    `startRow` - 起始行号
    `endRow` - 终止行号
  返回：
    行对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Rows rows = worksheet.getRows(3,7);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界
    `application.exceptions.MacroRunException` - 当区域的起始行大于结束行

### getRows

    public Rows getRows(java.lang.String rowsAddress)

  根据行地址获取行对象。

  参数：
    `rowsAddress` - 行地址，如“2:3”
  返回：
    行对象

    例子:

         本示例将获取当前活动工作表的第3至第7行:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Rows rows = worksheet.getRows("3:7");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### getScenarios

    public Scenarios getScenarios()

  获得方案管理器。

  返回：
    方案管理器对象

    例子:

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Scenarios scenarios = sheet.getScenarios();

### getShapes

    public SsShapes getShapes()

  获取工作表的自选图形管理器。

  返回：
    图形管理器对象

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         SsShapes shapes = worksheet.getShapes();

### getStandardColumnWidth

    public double getStandardColumnWidth()

  获得标准列宽(默认度量单位:磅)。

  返回：
    标准列宽，为double型,单位:磅

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         double width = worksheet.getStandardColumnWidth();
         System.out.println("Width is " + width);

### getStandardRowHeight

    public double getStandardRowHeight()

  获得标准行高(默认度量单位:磅)。

  返回：
    行高，为double型,单位:磅

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         double height = worksheet.getStandardRowHeight();
         System.out.println("Height is "+height);

### getWorkbook

    public Workbook getWorkbook()

  返回工作表所属的集成文件。

  返回：
    集成文件对象

    例子:

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Workbook book = sheet.getWorkbook();

### getZoom

    public int getZoom()

  返回当前工作表的显示比例。

  返回：
    缩放比例，为int型,100表示为100％,缩放比例在10％ ～ 400％之间

    例子:

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

### gotoRange

    public Range gotoRange(java.lang.String refer)

  定位到指定的单元格区域。

  参数：
    `refer` - 表示所引用区域的地址或名称，例如: "A1", "B2:C9"等
  返回：
    单元格区域

    例子:

         本示例将获取当前活动工作表，并将定位至“A555”:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.gotoRange("A555");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### gotoSpecial

    public Range gotoSpecial(int type,
                             int detail)

  特殊定位。

  参数：
    `type` - 特殊定位的类型，为整型数值，值和相应的含义如下:

          GOTO_COMMENTS                － 注释
          GOTO_CONSTANTS               － 常量
          GOTO_FORMULAS                － 公式
          GOTO_BLANK_CELLS             － 空单元格
          GOTO_CURRENT_REGION          － 当前区域
          GOTO_CURRENT_ARRAY           － 当前数组
          GOTO_OBJECTS                 － 对象
          GOTO_DIFFERENCE_ROWS         － 差异行
          GOTO_DIFFERENCE_COLUMNS      － 差异列
          GOTO_PRECEDENTS_DIRECTLY     － 直接引用单元格
          GOTO_PRECEDENTS_ALL          － 所有引用单元格
          GOTO_DEPENDENTS_DIRECTLY     － 直接从属单元格
          GOTO_DEPENDENTS_ALL          － 所有从属单元格
          GOTO_LAST_CELL               － 最近单元格
          GOTO_VISIBLE_CELL            － 可见单元格
          GOTO_ALL_CONDITIONALFORMATS  － 所有条件化格式
          GOTO_SAME_CONDITIONALFORMATS － 相同条件化格式
          GOTO_ALL_VALIDATION          － 所有有效性
          GOTO_SAME_VALIDATION         － 相同有效性

    `detail` - 查找常数或公式时具体找哪种类型，detail的取值范围为0到15，值和相应的含义如下:

          GotoSpecialConstants
          GOTO_NONE                                － 无
          GOTO_NUMBER                              － 数值
          GOTO_TEXT                                － 文本
          GOTO_NUMBER_AND_TEXT                     － 数值和文本
          GOTO_LOGIC                               － 逻辑值
          GOTO_LOGIC_AND_NUMBER                    － 逻辑值和数值
          GOTO_LOGIC_AND_TEXT                      － 逻辑值和文本
          GOTO_LOGIC_AND_NUMBER_AND_TEXT           －逻辑值，数值和文本
          GOTO_ERROR                               － 错误值
          GOTO_ERROR_AND_NUMBER                    － 错误值和数值
          GOTO_ERROR_AND_TEXT                      － 错误值和逻辑值
          GOTO_ERROR_AND_TEXT_AND_NUMBER           － 错误值，文本和数值
          GOTO_ERROR_AND_LOGIC                     －错误值和逻辑值
          GOTO_ERROR_AND_LOGIC_AND_NUMBER          － 错误值，逻辑值和数值
          GOTO_ERROR_AND_LOGIC_AND_TEXT            － 错误值，逻辑值和文本
          GOTO_ERROR_AND_LOGIC_AND_TEXT_AND_NUMBER － 错误值，逻辑值，文本，和数值

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.gotoSpecial(GotoSpecialConstants.GOTO_CONSTANTS,GotoSpecialConstants.GOTO_NONE);

  另请参见：
    `GotoSpecialConstants`

### hasAutoFilter

    public boolean hasAutoFilter()

  得到当前Worksheet中是否有自动筛选区域。

  返回：
    TRUE表示有，FALSE表示无

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         System.out.println(worksheet.hasAutoFilter());

### insertEntireColumns

    public void insertEntireColumns(int startCol,
                                    int endCol)

  在该列处插入整列。

  参数：
    `startCol` - 开始列号
    `endCol` - 结束列号

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.insertEntireColumns(3,5);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界
    `application.exceptions.MacroRunException` - 当区域的起始行大于结束行

### insertEntireRows

    public void insertEntireRows(int startRow,
                                 int endRow)

  在该选定行处插入整行。

  参数：
    `startRow` - 开始行号
    `endRow` - 结束行号

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.insertEntireRows(3,5);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界
    `application.exceptions.MacroRunException` - 当区域的起始行大于结束行

### insertMultiMedia

    public void insertMultiMedia(java.lang.String name)

  在当前的工作表单元格中插入一个影音文件。

  参数：
    `name` - 带绝对路径的影音文件名

    例子:

          Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.insertMultiMedia("e:/favorite/music/123.mp3");

### insertPicture

    public void insertPicture(java.lang.String pictureName)

  在当前的工作表中插入一幅图片。

  参数：
    `pictureName` - 带完全路径的图片的文件名

    例子:

          Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.insertPicture("e:/favorite/picture/123.jpg");

### isVisible

    public boolean isVisible()

  工作表是否隐藏。

  返回：
    boolean型，TRUE表示工作表隐藏，FALSE表示显示

    例子:

         Worksheets worksheets = Application.getWorkbooks()
                                  .getActiveWorkbook().getWorksheets();
         Worksheet worksheet = worksheets.getWorksheet("工作表1");
         boolean visible = worksheet.isVisible();
         System.out.println(visible);

### isWorksheetChart

    public boolean isWorksheetChart()

  返回工作表是否图表工作表。

  返回：
    TRUE表示是图表工作表，FALSE表示不是

    例子:

         本示例返回工作表是否图表工作表。

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         boolean chartFlag = worksheet.isWorksheetChart();
         System.out.println(chartFlag);

### protect

    public void protect(int type,
                        java.lang.String password)

  对指定工作表进行保护，并设置保护类型。

  参数：
    `type` - 保护类型，

         若type为ProtectConstants.LOCKED，则保护方式为锁定；
         若type为ProtectConstants.HIDDEN，则保护方式为隐藏公式

    `password` - 密码

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.protect(ProtectConstants.LOCKED,"aa");

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

### refresh

    public void refresh()

  刷新视图。

  例子:

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

### removeDependentArrows

    public void removeDependentArrows(int row,
                                      int column)

  删除从属单元格追踪箭头。使用审核功能可添加追踪箭头。

  参数：
    `row` - 单元格行号
    `column` - 单元格列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.removeDependentArrows(2,3);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### removeHPageBreak

    public void removeHPageBreak(int row)

  删除指定行处的水平分页符。

  参数：
    `row` - 行号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.removeHPageBreak(3);

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

### removeHVPageBreak

    public void removeHVPageBreak(int row,
                                  int column)

  删除指定位置处的水平分页符和垂直分页符。

  参数：
    `row` - 指定的行号
    `column` - 指定的列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.removeHVPageBreak(3,5);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### removePrecedentArrows

    public void removePrecedentArrows(int row,
                                      int column)

  删除引用单元格追踪箭头。使用审核功能可添加追踪箭头。

  参数：
    `row` - 单元格行号
    `column` - 单元格列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.removePrecedentArrows(2,3);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### removeVPageBreak

    public void removeVPageBreak(int column)

  删除指定列处的垂直分页符。

  参数：
    `column` - 列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.removeVPageBreak(5);

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

### resetTabBarBackground

    public void resetTabBarBackground()

  重置工作表标签的背景色。

  例子:

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

### resetTabBarForeground

    public void resetTabBarForeground()

  重置工作表标签的前景色。

  例子:

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

### select

    public void select(int startRow,
                       int startColumn,
                       int endRow,
                       int endColumn)

  选中活动工作表中的单元格或单元格区域。

  参数：
    `int` - startRow 选取的起始行
    `int` - endRow 选取的终止行
    `int` - startColumn 选取的起始列
    `int` - endColumn 选取的终止列

    例子:

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                  .getWorksheets().getActiveWorksheet();
         sheet.select(1,2,3,4);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### select

    public void select(java.lang.String address)

  选中活动工作表中的单元格或单元格区域。

  参数：
    `address` - 需选取的单元格或单元格区域，如"A1"或"A1:A5"

    例子:

         Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                  .getWorksheets().getActiveWorksheet();
         sheet.select("A1:D10");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### selectAll

    public void selectAll()

  选中活动工作表中的所有单元格。

  例子:

       Worksheet sheet = Application.getWorkbooks().getActiveWorkbook()
                .getWorksheets().getActiveWorksheet();
       sheet.selectAll();

### setBackground

    public void setBackground(java.lang.String pictureName)

  设置当前整个工作表的背景图片。

  参数：
    `pictureName` - 带有完整路径的背景图片文件名

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setBackground("C:/My_Picture/Test1.jpg");

  抛出：
    `application.exceptions.MacroRunException` - 当文件名路径错误

### setCellValue

    public void setCellValue(int row,
                             int column,
                             boolean value)

  给行号和列号指定的单元格设置内容。

  参数：
    `row` - 行号
    `column` - 列号
    `value` - 布尔型值

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setCellValue(3,6,true);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             double value)

  给行号和列号指定的单元格设置内容。

  参数：
    `row` - 行号
    `column` - 列号
    `value` - 双精度型值

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setCellValue(3,6,3.14);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             double[][] values,
                             boolean horizontal)

  给以指定的行号和列号为起点的单元格区域设置内容。 此方法对数据不作解析，直接保存。 对于受保护单元格中的内容不作替换。

  参数：
    `row` - 起始行号
    `column` - 起始列号
    `values` - 双精度型数据类型值
    `horizontal` - 数据的排列顺序，true为横排，false为竖排

         注意: 如果数组的长度超过最大行数和最大列数时，工作表将无法显示超出部分的数值。

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         double[][] values = new double[][]{
           {1.1,2.2,1.4,1.5,1.6,1.7,1.8,1.9,1.1,1.2,1.3,1.4},
           {2.1,2.01,2.31,2.41,2.51,2.61,2.71,2.81,2.91,3.01,3.11,3.21}};
         worksheet.setCellValue(10,10,values,true);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             double[] value,
                             boolean horizontal)

  给以指定的行号和列号为起点的单元格区域设置内容。 此方法对数据不作解析，直接保存。 对于受保护单元格中的内容不作替换。

  参数：
    `row` - 起始行号
    `column` - 起始列号
    `values` - 双精度型数据类型值
    `horizontal` - 数据的排列顺序，true为横排，false为竖排

         注意: 如果数组的长度超过最大行数和最大列数时，工作表将无法显示超出部分的数值。

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         double[] values = new double[]{2.1,2.01,2.31,2.41,2.51,2.61,2.71,2.81,2.91,3.01,3.11,3.21};
         worksheet.setCellValue(10,10,values,true);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             int[] value,
                             boolean horizontal)

  给以指定的行号和列号为起点的单元格区域设置内容。 此方法对数据不作解析，直接保存。 对于受保护单元格中的内容不作替换。

  参数：
    `row` - 起始行号
    `column` - 起始列号
    `values` - 整型数据类型值
    `horizontal` - 数据的排列顺序，true为横排，false为竖排

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         int[] values = new int[]{1,2,1,1,1,1,1,1,1,1,1,1};
         worksheet.setCellValue(10,1,values,false);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             long value)

  给行号和列号指定的单元格设置内容。

  参数：
    `row` - 行号
    `column` - 列号
    `value` - 长整型值

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setCellValue(3,6, 123);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             long[][] values,
                             boolean horizontal)

  给以指定的行号和列号为起点的单元格区域设置内容。 此方法对数据不作解析，直接保存。 对于受保护单元格中的内容不作替换。

  参数：
    `row` - 起始行号
    `column` - 起始列号
    `values` - 整型数据类型值
    `horizontal` - 数据的排列顺序，true为横排，false为竖排

         注意: 如果数组的长度超过最大行数和最大列数时，工作表将无法显示超出部分的数值。

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         long[][] values = new long[][]{
           {1,2,1,1,1,1,1,1,1,1,1,1},
           {1,1,1,1,1,1,1,1,1,1,1,1},
           {1,1,1,1,1,1,1,1,1,1,1,1}};
         worksheet.setCellValue(10,1,values,false);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             long[] value,
                             boolean horizontal)

  给以指定的行号和列号为起点的单元格区域设置内容。 此方法对数据不作解析，直接保存。 对于受保护单元格中的内容不作替换。

  参数：
    `row` - 起始行号
    `column` - 起始列号
    `values` - 整型数据类型值
    `horizontal` - 数据的排列顺序，true为横排，false为竖排

         注意: 如果数组的长度超过最大行数和最大列数时，工作表将无法显示超出部分的数值。

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         long[] values = new long[]{1,2,1,1,1,1,1,1,1,1,1,1};
         worksheet.setCellValue(10,1,values,false);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             java.lang.String value)

  给行号和列号指定的单元格设置内容。

  参数：
    `row` - 行号
    `column` - 列号
    `value` - 未经解析的基本字符串

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setCellValue(3,6, "ABC");

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             java.lang.String[][] values,
                             boolean horizontal)

  给以指定的行号和列号为起点的单元格区域设置内容。 此方法对数据不作解析，直接保存。 对于受保护单元格中的内容不作替换。

  参数：
    `row` - 起始行号
    `column` - 起始列号
    `values` - 字符型数据类型值
    `horizontal` - 数据的排列顺序，true为横排，false为竖排

         注意: 如果数组的长度超过最大行数和最大列数时，工作表将无法显示超出部分的数值。

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         String[][] values = new String[][]{
           {"a","b","c","d","e","f","g"},
           {"h","i","j","k","l","m","n"}};
         worksheet.setCellValue(5,10,values,false);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setCellValue

    public void setCellValue(int row,
                             int column,
                             java.lang.String[] value,
                             boolean horizontal)

  给以指定的行号和列号为起点的单元格区域设置内容。 此方法对数据不作解析，直接保存。 对于受保护单元格中的内容不作替换。

  参数：
    `row` - 起始行号
    `column` - 起始列号
    `values` - 字符型数据类型值
    `horizontal` - 数据的排列顺序，true为横排，false为竖排

         注意: 如果数组的长度超过最大行数和最大列数时，工作表将无法显示超出部分的数值。

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         String[] values = new String[]{"a","b","c","d","e","f","g"};
         worksheet.setCellValue(5,10,values,false);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### setName

    public void setName(java.lang.String name)

  设置工作表的名字。

  参数：
    `name` - 工作表名字

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setName("新名");

### setStandardColumnWidth

    public void setStandardColumnWidth(double width)

  设置标准列宽(默认度量单位:磅)。

  参数：
    `width` - 标准列宽，为double型,单位:磅,其取值范围在0至1530.0 磅

    例子: 设置标准列宽为20.0毫米

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         double ptValue = Utilities.otherToPoint(20.0,UnitConstants.MILLIMETER);
         worksheet.setStandardColumnWidth(ptValue);

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

### setStandardRowHeight

    public void setStandardRowHeight(double height)

  设置标准行高(默认度量单位:磅)。

  参数：
    `height` - 行高，为double型,单位:磅,其取值范围在0至409.0 磅

    例子: 设置标准行高为13.0毫米

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         double ptValue = Utilities.otherToPoint(13.0,UnitConstants.MILLIMETER);
         worksheet.setStandardRowHeight(ptValue);

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

### setTabBarBackground

    public void setTabBarBackground(java.awt.Color color)

  设置工作表标签栏工作表标签的背景色。

  参数：
    `color` - 背景色

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setTabBarBackground(Color.green);

### setTabBarForeground

    public void setTabBarForeground(java.awt.Color color)

  设置工作表标签栏上工作表标签的前景色。

  参数：
    `color` - 前景色

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setTabBarForeground(Color.red);

### setVisible

    public void setVisible(boolean visible)

  隐藏/显示活动工作表。

  参数：
    `visible` - 可见性

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setVisible(false);

### setZoom

    public void setZoom(int zoom)

  设置当前工作表的显示比例。

  参数：
    `zoom` - 缩放比例，为int型,100表示为100％,缩放比例在10％ ～ 400％之间

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.setZoom(150);

### showAllData

    public void showAllData()

  显示所有被筛选后隐藏的行。

  例子：

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

### showDependentArrows

    public void showDependentArrows(int row,
                                    int column)

  追踪从属单元格(内容是数值)。

  参数：
    `row` - 单元格行号
    `column` - 单元格列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.showDependentArrows(2,3);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### showPrecedentArrows

    public void showPrecedentArrows(int row,
                                    int column)

  追踪引用单元格(此单元格为公式)，绘制出一个从为活动单元格（公式）提供数据的单元格指向活动单元格的蓝色箭头。

  参数：
    `row` - 单元格的行号
    `column` - 单元格的列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.showPrecedentArrows(2,3);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### showTraceError

    public void showTraceError(int row,
                               int column)

  显示错误追踪箭头(单元格的公式结果是错误值)。使用审核功能可添加追踪箭头。

  参数：
    `row` - 单元格行号
    `column` - 单元格列号

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.showTraceError(2,3);

  抛出：
    `application.exceptions.MacroRunException` - 当给定的单元格区域地址错误或越界

### translateToSimple

    public void translateToSimple()

  将当前工作表内的文字编码方式转换为简体编码方式。

  例子:

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

### translateToTraditional

    public void translateToTraditional()

  将当前工作表内的文字编码方式转换为繁体编码方式。

  例子:

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

### unprotect

    public boolean unprotect(java.lang.String password)

  对工作表解除保护。

  参数：
    `password` - 密码

    例子:

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         boolean success = worksheet.unprotect("aa");

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

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