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.worksheets.worksheet
Class Range

    java.lang.Object
      application.workbooks.workbook.worksheets.worksheet.Range

public class Range
extends java.lang.Object

该类定义了对单元格或单元格区域进行操作的一些方法，如为单元格区域设值，复制和粘贴单元格区域，在单元格区域内查找或替换数据，填充数据，筛选数据等。

Method Summary
`void` | `activate(int row, int column)` 设置活动单元格。
`void` | `activate(java.lang.String cellAddress)` 设置活动单元格。
`void` | `addGroup(boolean isRow)` 组合区域。
`void` | `advancedFilter(java.lang.String sourceDataRange, java.lang.String criteriaRange, java.lang.String pasteRange, boolean isCopy, boolean remove)` 高级筛选。
`void` | `autoFill(java.lang.String rangeAddress)` 自动填充数据。
`void` | `autoFill(java.lang.String rangeAddress, int type)` 用拖曳方式自动填充。
`void` | `autoSum()` 对区域进行自动求和。
`void` | `clear()` 清除所选区域中单元格的全部特性，如格式、内容、注释等。
`void` | `clearComments()` 清除所选区域中单元格的注释。
`void` | `clearContents()` 清除所选区域中单元格的内容。
`void` | `clearFormats()` 清除所选区域中单元格的格式。
`void` | `consolidate(java.lang.String[] rangeAddress, int function, boolean isRow, boolean isColumn, boolean createLink)` 合并计算单元格数据。
`void` | `copy()` 复制所选的单元格区域。
`void` | `copyFormatTo(java.lang.String rangeAddress)` 仅把单元格区域的格式复制到指定区域。
`void` | `copyTo(java.lang.String rangeAddress)` 把单元格区域复制到指定区域。
`void` | `copyValueTo(java.lang.String rangeAddress)` 仅把单元格区域的数值复制到指定区域。
`int[]` | `customAutoFilter(int index, int operator, java.lang.String criteria1, int criteriaType1, java.lang.String criteria2, int criteriaType2)` 设置自定义自动筛选方式。
`void` | `cut()` 剪切所选的单元格区域。
`void` | `cutTo(java.lang.String rangeAddress)` 把单元格区域剪切至指定区域。
`void` | `deleteEntireColumn()` 删除整列，表示右方单元格左移至相应位置。
`void` | `deleteEntireRow()` 删除整行，并使下方单元格上移至相应位置。
`void` | `deleteShiftToLeft()` 删除单元格或单元格区域并使右方单元格或单元格区域左移至相应位置。
`void` | `deleteShiftToUp()` 删除单元格或单元格区域并使下方单元格或单元格区域上移至相应位置。
`boolean` | `equals(Range range)` 比较是否同一个单元格区域。
`void` | `fillDown()` 向下填充数据。
`void` | `fillLeft()` 向左填充数据。
`void` | `fillRandom()` 以随机数填充所选区域的单元格。
`void` | `fillRandom(double from, double to, int decimal)` 以随机数填充所选区域的单元格。
`void` | `fillRight()` 向右填充数据。
`void` | `fillSeries()` 用序列数或日期填充所选单元格区域。
`void` | `fillSeries(boolean columnRow, int type, int unit, double step, double stop, boolean trend)` 用序列或日期填充选中单元格区域。
`void` | `fillSeries(java.lang.String rangeAddress, boolean columnRow, int type, int unit, double step, double stop, boolean trend)` 用序列或日期填充选中单元格区域。
`void` | `fillUp()` 向上填充数据。
`boolean` | `findNext(java.lang.String findText)` 以默认方式查找。
`boolean` | `findNext(java.lang.String findText, int searchOrder, int lookIn, boolean matchCase, boolean isEntireCell, boolean isDBC)` 不带格式的查找。
`boolean` | `findNext(java.lang.String findText, int searchOrder, int lookIn, boolean matchCase, boolean isEntireCell, boolean isDBC, FontAttribute fontAttribute, SsBorderAttribute borderAttribute, java.awt.Color color)` 带格式的查找。
`Cell` | `getActiveCell()` 返回当前单元格区域中激活的单元格。
`java.lang.String` | `getAddress()` 获取当前单元格区域的地址。
`FillAttribute` | `getBackground()` 获取单元格或单元格区域的填充属性。
`SsBorderAttribute` | `getBorderAttribute()` 获得当前激活单元格的边框格式。
`int` | `getCellCount()` 返回当前选取区域中有多少个单元格.
`Characters` | `getCharacters(int startPosition, int endPosition)` 获取当前活动单元格字符串。
`Columns` | `getColumns()` 返回当前选中区域的行对象
`int` | `getEndColumn()` 获取结束列列号。
`int` | `getEndRow()` 获取单元格区域终止行行号。
`Rows` | `getRows()` 返回当前选中区域的行对象
`int` | `getStartColumn()` 获取单元格区域起始列列号。
`int` | `getStartRow()` 获取单元格区域起始行行号。
`void` | `hideDetail()` 隐藏明细数据。
`void` | `insertEntireColumn()` 插入整列。
`void` | `insertEntireRow()` 插入整行。
`void` | `insertShiftToDown()` 插入单元格时，活动单元格或单元格区域下移。
`void` | `insertShiftToRight()` 插入单元格时，活动单元格或单元格区域右移。
`void` | `justify()` 通过对单元格内的文本内容重排去填充单元格区域。
`void` | `linkTo(java.lang.String rangeAddress)` 把当前单元格区域链接到目标区域。
`void` | `merge(boolean alignmentCenter)` 合并单元格。
`void` | `mergeAcross()` 按选取单元格区域的行合并单元格(只合并行不合并列)。
`void` | `paste()` 把复制在粘贴板中的数据粘贴到指定位置。
`void` | `paste(int number)` 把复制在粘贴板中指定的数据粘贴到指定位置。
`void` | `pasteAll()` 把复制在粘贴板中的所有数据粘贴到指定位置。
`void` | `pasteLink()` 粘贴链接在粘贴板的数据。
`void` | `pasteSpecial()` 选择性粘贴。
`void` | `pasteSpecial(int pasteFlag, int operationFlag, boolean skipFlag, boolean transposeFlag)` 选择性粘贴。
`void` | `protectCells()` 对当前单元格或单元格区域进行保护。
`void` | `protectCells(int type)` 对当前单元格或单元格区域进行保护，并设置保护类型。
`void` | `reduceGroup(boolean isRow)` 取消组合。
`void` | `removeSubtotal()` 删除分类汇总。
`void` | `replaceAllWith(java.lang.String findWhat, java.lang.String replaceWith)` 缺省全部替换。
`void` | `replaceAllWith(java.lang.String findWhat, java.lang.String replaceWith, int searchOrder, boolean matchCase, boolean isEntireCell, boolean isDBC)` 不带格式全部替换。
`void` | `replaceAllWith(java.lang.String findWhat, java.lang.String replaceWith, int searchOrder, boolean matchCase, boolean isEntireCell, boolean isDBC, FontAttribute findFontAttribute, SsBorderAttribute findBorderAttribute, java.awt.Color findColor, FontAttribute replaceFontAttribute, SsBorderAttribute replaceBorderAttribute, java.awt.Color replaceColor)`
带格式全部替换。
`void` | `replaceWith(java.lang.String findWhat, java.lang.String replaceWith)` 以缺省方式替换。
`void` | `replaceWith(java.lang.String findWhat, java.lang.String replaceWith, int searchOrder, boolean matchCase, boolean isEntireCell, boolean isDBC)` 不带格式的替换。
`void` | `replaceWith(java.lang.String findWhat, java.lang.String replaceWith, int searchOrder, boolean matchCase, boolean isEntireCell, boolean isDBC, FontAttribute findFontAttribute, SsBorderAttribute findBorderAttribute, java.awt.Color findColor, FontAttribute replaceFontAttribute, SsBorderAttribute replaceBorderAttribute, java.awt.Color replaceColor)`
带格式的替换。
`void` | `setAutoFilter()` 给当前的单元格区域设置自动筛选或清除自动筛选。
`void` | `setAutoFormat(int index)` 设置缺省的自动套用格式。
`void` | `setAutoFormat(int index, boolean number, boolean border, boolean font, boolean alignment, boolean pattern, boolean widthHight)` 设置自动套用格式。
`void` | `setBorderAttribute(SsBorderAttribute borderAttribute)` 设置边框属性。
`void` | `setCellAttribute(CellAttribute cellAttribute)` 设置单元格或单元格区域的格式。
`void` | `setConditionalFormatting(int type, int operator, java.lang.String formula1, java.lang.String formula2, FontAttribute fontAttribute, SsBorderAttribute borderAttribute, java.awt.Color color)` 设置条件格式（一个条件）。
`void` | `setConditionalFormatting(int type1, int operator1, java.lang.String formula11, java.lang.String formula12, FontAttribute fontAttribute1, SsBorderAttribute borderAttribute1, java.awt.Color color1, int type2, int operator2, java.lang.String formula21, java.lang.String formula22, FontAttribute fontAttribute2, SsBorderAttribute borderAttribute2, java.awt.Color color2)`
设置条件格式（两个条件）。
`void` | `setConditionalFormatting(int type1, int operator1, java.lang.String formula11, java.lang.String formula12, FontAttribute fontAttribute1, SsBorderAttribute borderAttribute1, java.awt.Color color1, int type2, int operator2, java.lang.String formula21, java.lang.String formula22, FontAttribute fontAttribute2, SsBorderAttribute borderAttribute2, java.awt.Color color2, int type3, int operator3, java.lang.String formula31, java.lang.String formula32, FontAttribute fontAttribute3, SsBorderAttribute borderAttribute3, java.awt.Color color3)`
设置条件格式（三个条件）。
`void` | `setFormulaArray(java.lang.String value)` 设置数组公式。
`void` | `setValidation(int type, int alertStyle, int operator, java.lang.String maximum, java.lang.String minimum, boolean ignoreBlank, boolean inCellDropDown, java.lang.String inputTitle, java.lang.String errorTitle, java.lang.String inputMessage, java.lang.String errorMessage, boolean showInput, boolean showError)`
校验数据的有效性。
`void` | `setValue(boolean value)` 用布尔型数据设置所选单元格区域的内容。
`void` | `setValue(double value)` 用双精度型数据设置所选单元格区域的内容。
`void` | `setValue(long value)` 用长整型数据设置所选单元格区域的内容。
`void` | `setValue(java.lang.Object object)` 用指定类型的数据设置所选单元格区域的内容。
`void` | `setValue(java.lang.String value)` 用字符串类型的数据设置所选单元格区域的内容。
`void` | `shiftDownAndCopy(java.lang.String rangeAddress)` 目标单元格向下移动且复制源。
`void` | `shiftDownAndMove(java.lang.String rangeAddress)` 目标单元格向下移动且移动源。
`void` | `shiftRightAndCopy(java.lang.String rangeAddress)` 目标单元格向右移动且复制源。
`void` | `shiftRightAndMove(java.lang.String rangeAddress)` 目标单元格向右移动且移动源。
`void` | `showAll()` 显示所有被筛选后隐藏的行。
`void` | `showDetail()` 显示明细数据。
`void` | `sort(SortProperties sortProperties)` 对所选单元格区域中的数据进行排序。
`void` | `subtotal(int fieldIndex, int styleIndex, int[] item, boolean change, boolean pageBreak, boolean result)` 设置分类汇总。
`java.lang.String` | `toString()`
`void` | `unmerge()` 清除选取单元格区域里存在的合并单元格。
`void` | `unprotectCells()` 对当前单元格或单元格区域解除保护。

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

Method Detail

### activate

    public void activate(int row,
                         int column)

  设置活动单元格。

  Parameters:
    `row` - 单元格行号
    `column` - 单元格列号

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").activate(2,3);

### activate

    public void activate(java.lang.String cellAddress)

  设置活动单元格。

  Parameters:
    `cellAddress` - 单元格引用，如"A1"

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").activate("A1");

### addGroup

    public void addGroup(boolean isRow)

  组合区域。

  Parameters:
    `isRow` - true，组合行；false，组合列

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("a1:e10");
         range.fillRandom();
         range.addGroup(true);

### advancedFilter

    public void advancedFilter(java.lang.String sourceDataRange,
                               java.lang.String criteriaRange,
                               java.lang.String pasteRange,
                               boolean isCopy,
                               boolean remove)

  高级筛选。

  Parameters:
    `sourceDataRange` - 源数据区域
    `criteriaRange` - 条件区域
    `pasteRange` - 粘贴区域
    `isCopy` - 布尔型，如为true，则把筛选结果拷贝到其他区域；否则不把筛选结果拷贝到其他区域
    `remove` - 布尔型，如为true，要把重复的内容除去；否则，不把重复的内容除去

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").advancedFilter("A1:G9","A2:C2","C2:D4",true,false);

### autoFill

    public void autoFill(java.lang.String rangeAddress)

  自动填充数据。（与通过拖动填充柄来填充系列的效果一样）

  Parameters:
    `rangeAddress` - 填充的目标单元格区域

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("C5");
         range.setValue(1);
         range.autoFill("C5:C17");

### autoFill

    public void autoFill(java.lang.String rangeAddress,
                         int type)

  用拖曳方式自动填充。（与用右键拖动填充柄来填充系列的效果一样）

  Parameters:
    `rangeAddress` - 填充的目标单元格区域
    `type` - 设置填充类型：

         若type为DRAG_DEFAULT ，则为序列填充；
         若type为DRAG_COPY    ，则复制填充；
         若type为DRAG_SERIES  ，则为序列填充；
         若type为DRAG_FORMAT  ，则以格式填充；
         若type为DRAG_VALUE   ，则以数值填充；
         若type为DRAG_DAY     ，则以天数填充；
         若type为DRAG_WEEKDAY ，则以工作日填充；
         若type为DRAG_MONTH   ，则以月份填充；
         若type为DRAG_YEAR    ，则以年份填充；
         若type为DRAG_LINEAR  ，则以等差序列填充；
         若type为DRAG_GROWTH  ，则以等比序列填充

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("C5");
         range.setValue(1);
         range.autoFill("C5:C9",FillConstants.DRAG_COPY);

  See Also:
    `FillConstants`

### autoSum

    public void autoSum()

  对区域进行自动求和。 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook() .getWorksheets().getActiveWorksheet(); Range range = worksheet.getRange("a1:e7"); range.fillRandom(); range.autoSum();

### clear

    public void clear()

  清除所选区域中单元格的全部特性，如格式、内容、注释等。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("B1:D3").clear();

  See Also:
    `clearFormats()`, `clearComments()`, `clearContents()`

### clearComments

    public void clearComments()

  清除所选区域中单元格的注释。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("B1:D3").clearComments();

  See Also:
    `clear()`, `clearContents()`, `clearFormats()`

### clearContents

    public void clearContents()

  清除所选区域中单元格的内容。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("B1:D3").clearContents();

  See Also:
    `clear()`, `clearComments()`, `clearFormats()`

### clearFormats

    public void clearFormats()

  清除所选区域中单元格的格式。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("B1:D3").clearFormats();

  See Also:
    `clear()`, `clearComments()`, `clearContents()`

### consolidate

    public void consolidate(java.lang.String[] rangeAddress,
                            int function,
                            boolean isRow,
                            boolean isColumn,
                            boolean createLink)

  合并计算单元格数据。

  Parameters:
    `rangeAddress` - 需要合并计算的源区域，为一数组
    `function` - 合并计算时的汇总函数，为整型数值。 SUM － 求和； COUNT － 计数； AVERAGE － 平均值； MAX － 最大值； MIN － 最小值； PRODUCT － 乘积； COUNT_NUMS － 计数值； STD_DEV － 标准偏差； STD_DEVP － 总体标准偏差； VAR － 方差； VARP － 总体方差
    `isRow` - 布尔型，如为true，按行标志合并计算；否则，不按行标志合并计算
    `isColumn` - 布尔型，如为true，按列标志合并计算；否则，不按列标志合并计算
    `createLink` - 布尔型，如为true，创建连至数据源的链接，即数据源改变时，自动更新合并计算区域中的数据

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.select("B2");
         ActiveCell.setValue("1");
         worksheet.select("C2");
         ActiveCell.setValue("2");
         worksheet.select("A3");
         ActiveCell.setValue("3");
         worksheet.select("A4");
         ActiveCell.setValue("4");
         worksheet.select("B6");
         ActiveCell.setValue("1");
         worksheet.select("C6");
         ActiveCell.setValue("2");
         worksheet.select("A7");
         ActiveCell.setValue("3");
         worksheet.select("A8");
         ActiveCell.setValue("4");
         worksheet.select("B3:C4");
         ActiveRange.fillRandom(0.0,1.0,2);
         worksheet.clearCircles();
         worksheet.select("B7:C8");
         ActiveRange.fillRandom(0.0,1.0,2);
         worksheet.clearCircles();
         worksheet.select("F16");
         ActiveRange.consolidate(new String[] {"[C:/EIO_Binders/集成文件34.eio]工作表4!$A$2:$C$4","[C:/EIO_Binders/集成文件34.eio]工作表4!$A$6:$C$8"}
         ,ConsolidateConstants.SUM,true,true,false);

  See Also:
    `ConsolidateConstants`

### copy

    public void copy()

  复制所选的单元格区域。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("B9:K25");
       range.fillRandom();
       range.copy();

  See Also:
    `paste()`, `copyFormatTo(java.lang.String)`, `copyValueTo(java.lang.String)`, `#copyShapeText`, `copyTo(java.lang.String)`

### copyFormatTo

    public void copyFormatTo(java.lang.String rangeAddress)

  仅把单元格区域的格式复制到指定区域。

  Parameters:
    `rangeAddress` - 目标单元格区域左上角单元格地址

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B1:D3");
         range.fillRandom();
         range.copyFormatTo("G9");

  See Also:
    `copyValueTo(java.lang.String)`, `#copyShapeText`, `copyTo(java.lang.String)`

### copyTo

    public void copyTo(java.lang.String rangeAddress)

  把单元格区域复制到指定区域。

  Parameters:
    `rangeAddress` - 目标单元格区域左上角单元格地址

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B1:D3");
         range.fillRandom();
         range.copyTo("G9");

  See Also:
    `copyFormatTo(java.lang.String)`, `#copyShapeText`, `copyValueTo(java.lang.String)`

### copyValueTo

    public void copyValueTo(java.lang.String rangeAddress)

  仅把单元格区域的数值复制到指定区域。

  Parameters:
    `rangeAddress` - 目标单元格区域左上角单元格地址

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B1:D3");
         range.fillRandom();
         range.copyValueTo("G9");

  See Also:
    `copyFormatTo(java.lang.String)`, `#copyShapeText`, `copyTo(java.lang.String)`

### customAutoFilter

    public int[] customAutoFilter(int index,
                                  int operator,
                                  java.lang.String criteria1,
                                  int criteriaType1,
                                  java.lang.String criteria2,
                                  int criteriaType2)

  设置自定义自动筛选方式。

  Parameters:
    `index` - 自动筛选区域中的第几个
    `operator` - 自动筛选的筛选条件和筛选项： 0 - 和； 1 - 或者； 2 - 最小10项； 3 - 最小百分之十； 4 - 最大10项； 5 - 最大百分之十； 6 - 全部； 7 - 空单元格； 8 - 非空单元格； 9 - 相等
    `criteria1` - 第一个比较的值
    `criteriaType1` - 与第一个值比较的操作符类型： 0 － 等于； 1 － 不等于； 2 － 大于； 3 － 大于等于； 4 － 小于； 5 － 小于等于； 6 － 起始于； 7 － 非起始于； 8 － 结束于； 9 － 非结束于； 10 － 包含； 11 － 不包含
    `criteria2` - 第二个比较的值
    `criteriaType2` - 与第二个值比较的类型，与criteriaType1相同
  Returns:
    返回筛选出来的数据行

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").customAutoFilter(1,0,"1",1,"3",2);

### cut

    public void cut()

  剪切所选的单元格区域。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("B9:K25");
       range.fillRandom();
       worksheet.getRange("B9:K25").cut();

  See Also:
    `#cutShapeText`, `cutTo(java.lang.String)`

### cutTo

    public void cutTo(java.lang.String rangeAddress)

  把单元格区域剪切至指定区域。

  Parameters:
    `rangeAddress` - 目标单元格区域左上角单元格地址

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B1:D3");
         range.fillRandom();
         range.cutTo("G9");

  See Also:
    `cut()`, `#cutShapeText`

### deleteEntireColumn

    public void deleteEntireColumn()

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

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("C4").deleteEntireColumn();

  See Also:
    `deleteEntireRow()`

### deleteEntireRow

    public void deleteEntireRow()

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

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("C4").deleteEntireRow();

  See Also:
    `deleteEntireColumn()`

### deleteShiftToLeft

    public void deleteShiftToLeft()

  删除单元格或单元格区域并使右方单元格或单元格区域左移至相应位置。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("C4").deleteShiftToLeft();

  See Also:
    `deleteShiftToUp()`

### deleteShiftToUp

    public void deleteShiftToUp()

  删除单元格或单元格区域并使下方单元格或单元格区域上移至相应位置。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("C4").deleteShiftToUp();

  See Also:
    `deleteShiftToLeft()`

### equals

    public boolean equals(Range range)

  比较是否同一个单元格区域。

  Parameters:
    `range` - 比较的目标单元格区域

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1").equals(worksheet.getRange("C2"));

  Returns:
    返回一个布尔型值，如果为同一个单元格区域，返回true；否则为false

### fillDown

    public void fillDown()

  向下填充数据。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("B9:K25");
       range.fillRandom();
       worksheet.getRange("C25:C30").fillDown();

  See Also:
    `fillUp()`, `fillLeft()`, `fillRight()`, `fillRandom()`, `fillSeries()`

### fillLeft

    public void fillLeft()

  向左填充数据。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("A3:G5");
       range.fillRandom();
       worksheet.getRange("A3:G3").fillLeft();

  See Also:
    `fillUp()`, `fillDown()`, `fillRight()`, `fillRandom()`, `fillSeries()`

### fillRandom

    public void fillRandom()

  以随机数填充所选区域的单元格。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G4").fillRandom();

  See Also:
    `fillDown()`, `fillLeft()`, `fillRight()`, `fillUp()`, `fillSeries()`

### fillRandom

    public void fillRandom(double from,
                           double to,
                           int decimal)

  以随机数填充所选区域的单元格。

  Parameters:
    `from` - 欲填充的随机数的最小值，为double型
    `to` - 欲填充的随机数的最大值，为double型
    `decimal` - 随机数的小数位，为整型数值，其取值范围为0到15

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("C4").fillRandom(1,10,0);

  See Also:
    `fillDown()`, `fillLeft()`, `fillRight()`, `fillUp()`, `fillSeries()`

### fillRight

    public void fillRight()

  向右填充数据。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("A3:G5");
       range.fillRandom();
       worksheet.getRange("A3:G3").fillRight();

  See Also:
    `fillDown()`, `fillLeft()`, `fillUp()`, `fillRandom()`, `fillSeries()`

### fillSeries

    public void fillSeries()

  用序列数或日期填充所选单元格区域。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("A1:G5");
       range.fillRandom();
       worksheet.getRange("A1:G4").fillSeries();

  See Also:
    `fillUp()`, `fillDown()`, `fillLeft()`, `fillRight()`, `fillRandom()`

### fillSeries

    public void fillSeries(boolean columnRow,
                           int type,
                           int unit,
                           double step,
                           double stop,
                           boolean trend)

  用序列或日期填充选中单元格区域。 所有常量的定义在 applicatoin.constants.FillConstants 中。

  Parameters:
    `columnRow` - 设置填充方向，为布尔型，如为true，表示填充序列到列；否则，填充序列到行。相应的常量如下：

         SERIES_COLUMNS -- 填充序列到列；
         SERIES_ROWS -- 填充序列到行

    `type` - 设置填充类型，相应的常量如下：

         SERIES_LINEAR -- 填充等差序列；
         SERIES_GROWTH -- 填充等比序列；
         SERIES_DATE -- 填充日期；
         SERIES_AUTOFILL -- 自动填充

    `unit` - 设置填充类型为日期时的日期单位，相应的常量如下：

         SERIES_DAY -- 日期单位为天数；
         SERIES_WEEKDAY -- 日期单位为工作日；
         SERIES_MONTH -- 日期单位为月；
         SERIES_YEAR -- 日期单位为年

    `step` - 设置填充的步长值，为整型数值
    `stop` - 设置填充的终止值，为整型数值
    `trend` - 设置填充的趋势，为布尔型值，如为true，表示以趋势填充；否则，不以趋势填充。相应的常量如下：

         SERIES_TREND -- 以趋势填充；
         SERIES_NOT_TREND -- 不以趋势填充

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3");
         range.setValue(1);
         worksheet.getRange("B3:G14").fillSeries(  FillConstants.SERIES_ROWS,
                                                   FillConstants.SERIES_DATE,
                                                   FillConstants.SERIES_DAY,
                                                   2,
                                                   65535,
                                                   FillConstants.SERIES_NOT_TREND);

  See Also:
    `applicatoin.constants.FillConstants`, `fillUp()`, `fillDown()`, `fillLeft()`, `fillRight()`, `fillRandom()`

### fillSeries

    public void fillSeries(java.lang.String rangeAddress,
                           boolean columnRow,
                           int type,
                           int unit,
                           double step,
                           double stop,
                           boolean trend)

  用序列或日期填充选中单元格区域。 所有常量的定义在 applicatoin.constants.FillConstants 中。

  Parameters:
    `columnRow` - 设置填充方向，为布尔型，如为true，表示填充序列到列；否则，填充序列到行。相应的常量如下：

         SERIES_COLUMNS -- 填充序列到列；
         SERIES_ROWS -- 填充序列到行

    `type` - 设置填充类型，相应的常量如下：

         SERIES_LINEAR -- 填充等差序列；
         SERIES_GROWTH -- 填充等比序列；
         SERIES_DATE -- 填充日期；
         SERIES_AUTOFILL -- 自动填充

    `unit` - 设置填充类型为日期时的日期单位，相应的常量如下：

         SERIES_DAY -- 日期单位为天数；
         SERIES_WEEKDAY -- 日期单位为工作日；
         SERIES_MONTH -- 日期单位为月；
         SERIES_YEAR -- 日期单位为年

    `step` - 设置填充的步长值，为整型数值
    `stop` - 设置填充的终止值，为整型数值
    `trend` - 设置填充的趋势，为布尔型值，如为true，表示以趋势填充；否则，不以趋势填充。相应的常量如下：

         SERIES_TREND -- 以趋势填充；
         SERIES_NOT_TREND -- 不以趋势填充

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:B14");
         range.setValue(1);
         worksheet.getRange("B3:G14").fillSeries("B3:B14",
                                                   FillConstants.SERIES_ROWS,
                                                   FillConstants.SERIES_DATE,
                                                   FillConstants.SERIES_DAY,
                                                   1,
                                                   65535,
                                                   FillConstants.SERIES_NOT_TREND);

  See Also:
    `applicatoin.constants.FillConstants`, `fillUp()`, `fillDown()`, `fillLeft()`, `fillRight()`, `fillRandom()`

### fillUp

    public void fillUp()

  向上填充数据。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("B9:K25");
       range.fillRandom();
       worksheet.getRange("C20:C25").fillUp();

  See Also:
    `fillDown()`, `fillLeft()`, `fillRight()`, `fillRandom()`, `fillSeries()`

### findNext

    public boolean findNext(java.lang.String findText)

  以默认方式查找。

  Parameters:
    `findText` - 要查找的字符串
  Returns:
    是否找到对应的字符串

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("g1:G4").setValue("123");
         worksheet.getRange("A1:G4").findNext("123");

### findNext

    public boolean findNext(java.lang.String findText,
                            int searchOrder,
                            int lookIn,
                            boolean matchCase,
                            boolean isEntireCell,
                            boolean isDBC)

  不带格式的查找。 常量定义在 application.constants.FindConstants 中。

  Parameters:
    `findText` - 要查找的字符串
    `searchOrder` - 查找顺序，相应常量如下：

         BY_ROWS -- 按行查找；
         BY_COLUMNS -- 按列查找

    `lookIn` - 查找内容，相应常量如下：

         BY_FORMULAS -- 查找公式；
         BY_VALUES -- 查找值；
         BY_COMMENTS -- 查找注释

    `matchCase` - 布尔型，如为true，则查找时区分大小写；否则，不区分大小写
    `isEntireCell` - 布尔型，如为true，则查找时匹配整个单元格；否则，查找时不匹配整个单元格
    `isDBC` - 布尔型值 如为true，则查找时区分全角半角；否则，查找时不区分全角半角
  Returns:
    是否找到对应的字符串

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("g1:G4").setValue("123");
         worksheet.getRange("A1:G10").findNext("123",
                                               FindConstants.BY_ROWS,
                                               FindConstants.BY_VALUES,
                                               false,
                                               false,
                                               false);

  See Also:
    `FindConstants`

### findNext

    public boolean findNext(java.lang.String findText,
                            int searchOrder,
                            int lookIn,
                            boolean matchCase,
                            boolean isEntireCell,
                            boolean isDBC,
                            FontAttribute fontAttribute,
                            SsBorderAttribute borderAttribute,
                            java.awt.Color color)

  带格式的查找。 常量定义在 application.constants.FindConstants 中。

  Parameters:
    `findText` - 要查找的字符串
    `searchOrder` - 查找顺序，相应常量如下：

         BY_ROWS -- 按行查找；
         BY_COLUMNS -- 按列查找

    `lookIn` - 查找内容，相应常量如下：

         BY_FORMULAS -- 查找公式；
         BY_VALUES -- 查找值；
         BY_COMMENTS -- 查找注释

    `matchCase` - 布尔型，如为true，则查找时区分大小写；否则，不区分大小写
    `isEntireCell` - 布尔型，如为true，则查找时匹配整个单元格；否则，查找时不匹配整个单元格
    `isDBC` - 布尔型值 如为true，则查找时区分全角半角；否则，查找时不区分全角半角
    `fontAttribute` - 字体属性
    `borderAttribute` - 边框属性
    `color` - 单元格背景色颜色
  Returns:
    是否找到对应的字符串

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("g1:G4").setValue("abc");
         worksheet.getRange("A1:G4").findNext("abc",
                                             FindConstants.BY_ROWS,
                                             FindConstants.BY_VALUES,
                                             true,
                                             true,
                                             false,
                                             new FontAttribute(),
                                             new SsBorderAttribute(),
                                             java.awt.Color.CYAN);

  See Also:
    `FindConstants`

### getActiveCell

    public Cell getActiveCell()

  返回当前单元格区域中激活的单元格。

  例子

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").getActiveCell();

  See Also:
    `Cell`

### getAddress

    public java.lang.String getAddress()

  获取当前单元格区域的地址。

  Returns:
    当前单元格区域的地址。

    例子

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").getAddress();

### getBackground

    public FillAttribute getBackground()

  获取单元格或单元格区域的填充属性。

  Returns:
    填充属性

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("A1:G10");
         FillAttribute fa = range.getBackground();
         fa.getTextureInfo().setTextureIndex(9);

  See Also:
    `FillAttribute`

### getBorderAttribute

    public SsBorderAttribute getBorderAttribute()

  获得当前激活单元格的边框格式。

  See Also:
    `SsBorderAttribute`

### getCellCount

    public int getCellCount()

  返回当前选取区域中有多少个单元格.

  Returns:
    单元格个数

    例子

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         int count = worksheet.getActiveRange().getCellCount();
         Macro.println("count is " +count);

### getCharacters

    public Characters getCharacters(int startPosition,
                                    int endPosition)

  获取当前活动单元格字符串。

  Parameters:
    `startPosition` - 起点
    `endPosition` - 终点
  Returns:
    返回活动单元格中指定的字符串

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("a1:ec1");
         range.setValue("abcdef");
         Characters chars = range.getCharacters(1,4);
         System.out.println(chars.toString());
         chars.setFontSize(14);
         chars.setFontBold(true);
         chars.setUnderLine(true);
         chars.setColor(java.awt.Color.RED);

  See Also:
    `Characters`

### getColumns

    public Columns getColumns()

  返回当前选中区域的行对象

  Returns:
    指定行对象

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         Columns columns = range.getColumns();
         System.out.println(columns);

### getEndColumn

    public int getEndColumn()

  获取结束列列号。

  Returns:
    列号

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         int endColumn = worksheet.getRange("A1:G10").getEndColumn();
         System.out.println("endColumn is "+endColumn);

  See Also:
    `getStartColumn()`

### getEndRow

    public int getEndRow()

  获取单元格区域终止行行号。

  Returns:
    单元格区域终止行行号，为整型数值

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         int endRow = worksheet.getRange("A1:G10").getEndRow();
         System.out.println("endRow is "+endRow);

  See Also:
    `getStartRow()`

### getRows

    public Rows getRows()

  返回当前选中区域的行对象

  Returns:
    指定行对象

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getActiveRange();
         Rows rows = range.getRows();
         System.out.println(rows);

### getStartColumn

    public int getStartColumn()

  获取单元格区域起始列列号。

  Returns:
    单元格区域起始列列号，为整型数值

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         int startColumn = worksheet.getRange("A1:G10").getStartColumn();
         System.out.println("startColumn is "+startColumn);

  See Also:
    `getEndColumn()`

### getStartRow

    public int getStartRow()

  获取单元格区域起始行行号。

  Returns:
    单元格区域起始行行号，为整型数值

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         int startRow = worksheet.getRange("A1:G10").getStartRow();
         System.out.println("startRow is "+startRow);

  See Also:
    `getEndRow()`

### hideDetail

    public void hideDetail()

  隐藏明细数据。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("a1:e10");
       range.fillRandom();
       range.addGroup(true);
       worksheet.getRange("a1:e10").hideDetail();

  See Also:
    `showDetail()`

### insertEntireColumn

    public void insertEntireColumn()

  插入整列。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").insertEntireColumn();

  See Also:
    `insertEntireRow()`

### insertEntireRow

    public void insertEntireRow()

  插入整行。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").insertEntireRow();

  See Also:
    `insertEntireColumn()`

### insertShiftToDown

    public void insertShiftToDown()

  插入单元格时，活动单元格或单元格区域下移。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").insertShiftToDown();

  See Also:
    `insertShiftToRight()`

### insertShiftToRight

    public void insertShiftToRight()

  插入单元格时，活动单元格或单元格区域右移。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").insertShiftToRight();

  See Also:
    `insertShiftToDown()`

### justify

    public void justify()

  通过对单元格内的文本内容重排去填充单元格区域。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("A1:G4");
       range.setValue("aa");
       range.justify();

### linkTo

    public void linkTo(java.lang.String rangeAddress)

  把当前单元格区域链接到目标区域。

  Parameters:
    `rangeAddress` - 目标单元格区域左上角单元格地址

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B1:D3");
         range.fillRandom();
         range.linkTo("C5");

### merge

    public void merge(boolean alignmentCenter)

  合并单元格。

  Parameters:
    `alignmentCenter` - 布尔型，如为true，则合并后内容居中显示；否则，根据合并前最左上角单元格的数据类型按常规方式对齐文本

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").merge(true);

  See Also:
    `mergeAcross()`, `unmerge()`

### mergeAcross

    public void mergeAcross()

  按选取单元格区域的行合并单元格(只合并行不合并列)。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").mergeAcross();

  See Also:
    `merge(boolean)`, `unmerge()`

### paste

    public void paste()

  把复制在粘贴板中的数据粘贴到指定位置。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("B9:K25");
       range.fillRandom();
       range.copy();
       worksheet.getRange("C4").paste();

  See Also:
    `copy()`, `pasteSpecial()`, `pasteLink()`, `pasteAll()`, `#pasteShapeText`

### paste

    public void paste(int number)

  把复制在粘贴板中指定的数据粘贴到指定位置。

  Parameters:
    `number` - 剪贴板上内容的序号，由零开始

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B9:K25");
         range.fillRandom();
         range.copy();
         worksheet.getRange("C4").paste(1);

  See Also:
    `copy()`, `pasteSpecial()`, `pasteLink()`, `pasteAll()`, `#pasteShapeText`

### pasteAll

    public void pasteAll()

  把复制在粘贴板中的所有数据粘贴到指定位置。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("B9:c12");
       range.fillRandom();
       range.copy();
       range = worksheet.getRange("d9:e12");
       range.fillRandom();
       range.copy();
       worksheet.getRange("C4").pasteAll();

  See Also:
    `copy()`, `paste()`, `pasteSpecial()`, `pasteLink()`, `#pasteShapeText`

### pasteLink

    public void pasteLink()

  粘贴链接在粘贴板的数据。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("B9:K25");
       range.fillRandom();
       range.copy();
       worksheet.getRange("C4").pasteLink();

  See Also:
    `copy()`, `paste()`, `pasteAll()`, `pasteSpecial()`, `#pasteShapeText`

### pasteSpecial

    public void pasteSpecial()

  选择性粘贴。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("D9:F12");
       range.fillRandom();
       range.copy();
       worksheet.getRange("A1").pasteSpecial();

  See Also:
    `copy()`, `paste()`, `pasteAll()`, `pasteLink()`, `#pasteShapeText`

### pasteSpecial

    public void pasteSpecial(int pasteFlag,
                             int operationFlag,
                             boolean skipFlag,
                             boolean transposeFlag)

  选择性粘贴。

  Parameters:
    `pasteFlag` - 粘贴的类型，在application.constants.PasteSpecialConstants有相应的常数：

            SS_PASTE_ALL -- 粘贴全部；
            SS_PASTE_FORMULA -- 粘贴公式；
            SS_PASTE_VALUE -- 粘贴数值；
            SS_PASTE_FORMAT -- 粘贴格式；
            SS_PASTE_COMMENTS -- 粘贴注释；
            SS_PASTE_VALIDATION -- 粘贴有效性；
            SS_PASTE_XBORDER -- 粘贴所有但是不包括边框；
            SS_PASTE_COLWIDTH -- 粘贴列宽

    `operationFlag` - 操作的类型，在application.constants.PasteSpecialConstants有相应的常数：

            SS_OP_NONE -- 无操作；
            SS_OP_ADD -- 相加操作；
            SS_OP_SUBSTRACT -- 相减操作；
            SS_OP_MULTIPLY -- 相乘操作；
            SS_OP_DIVIDE -- 相除操作

    `skipFlag` - 布尔型值，如为true，表示忽略源区域中的空白单元格；否则，不忽略源区域中的空白单元格。在application.constants.PasteSpecialConstants有相应的常数：

            SS_SKIPBLANK -- 忽略源区域中的空白单元格；
            SS_NOT_SKIPBLANK -- 不忽略源区域中的空白单元格

    `transposeFlag` - 布尔型值，如为true，表示行列转置；否则，不行列转置。在application.constants.PasteSpecialConstants有相应的常数：

            SS_TRANSPOSE -- 行列转置；
            SS_NOT_TRANSPOSE -- 不行列转置

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("D9:F12");
         range.fillRandom();
         range.copy();
         worksheet.getRange("A1").pasteSpecial(PasteSpecialConstants.SS_PASTE_VALUE,
                                               PasteSpecialConstants.SS_OP_ADD,
                                               PasteSpecialConstants.SS_NOT_SKIPBLANK,
                                               PasteSpecialConstants.SS_NOT_TRANSPOSE);

  See Also:
    `copy()`, `paste()`, `pasteAll()`, `pasteLink()`, `#pasteShapeText`

### protectCells

    public void protectCells()

  对当前单元格或单元格区域进行保护。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").protectCells();

  See Also:
    `unprotectCells()`

### protectCells

    public void protectCells(int type)

  对当前单元格或单元格区域进行保护，并设置保护类型。

  Parameters:
    `type` - 保护类型，若type为0，则保护方式为锁定；若type为1，则保护方式为隐藏公式

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").protectCells(1);

  See Also:
    `unprotectCells()`

### reduceGroup

    public void reduceGroup(boolean isRow)

  取消组合。

  Parameters:
    `isRow` - true，取消行组合；false，取消列组合

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("a1:e10");
         range.fillRandom();
         range.addGroup(true);
         range.reduceGroup(false);

### removeSubtotal

    public void removeSubtotal()

  删除分类汇总。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G4").removeSubtotal();

### replaceAllWith

    public void replaceAllWith(java.lang.String findWhat,
                               java.lang.String replaceWith)

  缺省全部替换。

  Parameters:
    `findWhat` - 查找内容
    `replaceWith` - 替换内容

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("a1:G4").setValue("123");
         worksheet.getRange("A1:G10").replaceAllWith("123","321");

### replaceAllWith

    public void replaceAllWith(java.lang.String findWhat,
                               java.lang.String replaceWith,
                               int searchOrder,
                               boolean matchCase,
                               boolean isEntireCell,
                               boolean isDBC)

  不带格式全部替换。

  Parameters:
    `findWhat` - 待查找的字符串
    `replaceWith` - 待替换的字符串
    `searchOrder` - 查找顺序
    `matchCase` - 若matchCase为true，则区分大小写；否则不区分大小写
    `isEntireCell` - 若isEntireCell为true，则匹配整个单元格；否则不匹配
    `isDBC` - 布尔型值 如为true，则查找时区分全角半角；否则，查找时不区分全角半角

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("a1:G4").setValue("123");
         worksheet.getRange("A1:G10").replaceAllWith("123","321",FindConstants.BY_ROWS,false,false,false);

  See Also:
    `FindConstants`

### replaceAllWith

    public void replaceAllWith(java.lang.String findWhat,
                               java.lang.String replaceWith,
                               int searchOrder,
                               boolean matchCase,
                               boolean isEntireCell,
                               boolean isDBC,
                               FontAttribute findFontAttribute,
                               SsBorderAttribute findBorderAttribute,
                               java.awt.Color findColor,
                               FontAttribute replaceFontAttribute,
                               SsBorderAttribute replaceBorderAttribute,
                               java.awt.Color replaceColor)

  带格式全部替换。

  Parameters:
    `findWhat` - 要查找的字符串
    `replaceWith` - 要替换的字符串
    `searchOrder` - 查找顺序，相应常量如下：

         BY_ROWS -- 按行查找；
         BY_COLUMNS -- 按列查找

    `matchCase` - 布尔型，如为true，则查找时区分大小写；否则，查找时不区分大小写
    `isEntireCell` - 布尔型，如为true，则查找时匹配整个单元格；否则，查找时不匹配整个单元格
    `isDBC` - 布尔型值 如为true，则查找时区分全角半角；否则，查找时不区分全角半角
    `findFontAttribute` - 查找字体属性
    `findBorderAttribute` - 查找边框属性
    `findColor` - 查找单元格背景色颜色
    `replaceFontAttribute` - 替换字体属性
    `replaceBorderAttribute` - 替换边框属性
    `replaceColor` - 替换单元格背景色颜色

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("g1:G4").setValue("123");
         worksheet.getRange("A1:G10").replaceAllWith("123","321",
                                                     FindConstants.BY_ROWS,
                                                     false,false,false,
                                                     new FontAttribute(),
                                                     new SsBorderAttribute(),
                                                     Color.blue,
                                                     new FontAttribute(),
                                                     new SsBorderAttribute();
                                                     Color.red);

  See Also:
    `FindConstants`

### replaceWith

    public void replaceWith(java.lang.String findWhat,
                            java.lang.String replaceWith)

  以缺省方式替换。 如果在单击“查找下一个”按钮之前单击“查找和替换”对话框中的“替换”按钮， 则很可能会收到"找不到匹配项"错误消息.

  Parameters:
    `findWhat` - 查找内容
    `replaceWith` - 替换内容

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("a1:G10").setValue("123");
         Range range = worksheet.getRange("A1:G10");
         range.findNext("123");
         range.replaceWith("123","321");

### replaceWith

    public void replaceWith(java.lang.String findWhat,
                            java.lang.String replaceWith,
                            int searchOrder,
                            boolean matchCase,
                            boolean isEntireCell,
                            boolean isDBC)

  不带格式的替换。 如果在单击“查找下一个”按钮之前单击“查找和替换”对话框中的“替换”按钮， 则很可能会收到"找不到匹配项"错误消息. 常量定义在 application.constants.FindConstants 中。

  Parameters:
    `findWhat` - 待查找的字符串
    `replaceWith` - 待替换的字符串
    `searchOrder` - 查找顺序，相应常量如下：

         BY_ROWS -- 按行查找；
         BY_COLUMNS -- 按列查找

    `matchCase` - 若matchCase为true，则区分大小写；否则不区分大小写
    `isEntireCell` - isEntireCell为true，则匹配整个单元格；否则不匹配

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("a1:G10").setValue("123");
         worksheet.getRange("A1:G10").findNext("123");
         worksheet.getRange("A1:G10").replaceWith("123","321",FindConstants.BY_ROWS,false,false);

  See Also:
    `FindConstants`

### replaceWith

    public void replaceWith(java.lang.String findWhat,
                            java.lang.String replaceWith,
                            int searchOrder,
                            boolean matchCase,
                            boolean isEntireCell,
                            boolean isDBC,
                            FontAttribute findFontAttribute,
                            SsBorderAttribute findBorderAttribute,
                            java.awt.Color findColor,
                            FontAttribute replaceFontAttribute,
                            SsBorderAttribute replaceBorderAttribute,
                            java.awt.Color replaceColor)

  带格式的替换。 如果在单击“查找下一个”按钮之前单击“查找和替换”对话框中的“替换”按钮， 则很可能会收到"找不到匹配项"错误消息.

  Parameters:
    `findWhat` - 待查找的字符串
    `replaceWith` - 待替换的字符串
    `searchOrder` - 查找顺序：

         BY_ROWS -- 按行查找；
         BY_COLUMNS -- 按列查找

    `matchCase` - 若matchCase为true，则区分大小写；否则不区分大小写
    `isEntireCell` - 若isEntireCell为true，则匹配整个单元格；否则不匹配 详细注释请参看带格式的查找（findNext()）
    `findFontAttribute` - 查找字体
    `findBorderAttribute` - 查找边框
    `findColor` - 查找颜色
    `replaceFontAttribute` - 替换字体
    `replaceBorderAttribute` - 替换边框
    `replaceColor` - 替换颜色

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("a1:G10").setValue("123");
         worksheet.getRange("A1:G10").findNext("123");
         worksheet.getRange("A1:G10").replaceWith("123","321",
                                                  FindConstants.BY_ROWS,
                                                  true,
                                                  false,false,
                                                  new FontAttribute(),
                                                  new SsBorderAttribute(),
                                                  Color.gray,
                                                  new FontAttribute(),
                                                  new SsBorderAttribute(),
                                                  Color.red);

  See Also:
    `FindConstants`

### setAutoFilter

    public void setAutoFilter()

  给当前的单元格区域设置自动筛选或清除自动筛选。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").setAutoFilter();

### setAutoFormat

    public void setAutoFormat(int index)

  设置缺省的自动套用格式。

  Parameters:
    `index` - 预设格式的索引值（从0开始）

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").setAutoFormat(1);

### setAutoFormat

    public void setAutoFormat(int index,
                              boolean number,
                              boolean border,
                              boolean font,
                              boolean alignment,
                              boolean pattern,
                              boolean widthHight)

  设置自动套用格式。

  Parameters:
    `index` - 预设格式的索引值（从0开始）
    `number` - 布尔型，如为true，自动套用时应用数值格式：否则，不应用数值格式
    `font` - 布尔型，如为true，自动套用时应用字体格式：否则，不应用字体格式
    `alignment` - 布尔型，如为true，自动套用时应用对齐格式：否则，不应用对齐格式
    `border` - 布尔型，如为true，自动套用时应用边框格式：否则，不应用边框格式
    `pattern` - 布尔型，如为true，自动套用时应用图案格式：否则，不套用图案格式
    `widthHight` - 布尔型，如为true，自动套用时应用宽度/高度格式：否则，不应用宽度/高度格式

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").setAutoFormat(0,true,false,false,true,true,false);

### setBorderAttribute

    public void setBorderAttribute(SsBorderAttribute borderAttribute)

  设置边框属性。

  Parameters:
    `borderAttribute` - 边框属性 边框线宽度类型为 0.25f、0.5f、0.75f、1.0f、1.5f、2.25f、3.0f、4.5f、6.0f 如果用户设置的边框线宽度不是以上类型，设置将无效。 注意：边框线宽度类型随边框类型的不同而变化。 例如： 边框类型 LINESTYLE_SINGLE 的最大宽度类型为：6.0f 而边框类型 LINESTYLE_TRIPLE 的最大宽度类型为：3.0f

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Range r = worksheet.getRange("b3:e4");
         SsBorderAttribute attribute = new SsBorderAttribute();
         attribute.setBorderLineType(BorderAndShadingConstants.TOP, BorderAndShadingConstants.LINESTYLE_SINGLE);
         attribute.setBorderLineWidth(BorderAndShadingConstants.TOP, BorderAndShadingConstants.LINEWIDTH_025PT);
         attribute.setBorderLineColor(BorderAndShadingConstants.TOP,java.awt.Color.RED);
         attribute.setBorderLineType(BorderAndShadingConstants.LEFT, BorderAndShadingConstants.LINESTYLE_THICKTHINLARGEGAP);
         attribute.setBorderLineWidth(BorderAndShadingConstants.LEFT, BorderAndShadingConstants.LINEWIDTH_100PT);
         attribute.setBorderLineColor(BorderAndShadingConstants.LEFT,java.awt.Color.ORANGE);
         attribute.setBorderLineType(BorderAndShadingConstants.RIGHT, BorderAndShadingConstants.LINESTYLE_DOUBLE);
         attribute.setBorderLineWidth(BorderAndShadingConstants.RIGHT, BorderAndShadingConstants.LINEWIDTH_225PT);
         attribute.setBorderLineColor(BorderAndShadingConstants.RIGHT,java.awt.Color.PINK);
         attribute.setBorderLineType(BorderAndShadingConstants.BOTTOM, BorderAndShadingConstants.LINESTYLE_TRIPLE);
         attribute.setBorderLineWidth(BorderAndShadingConstants.BOTTOM, BorderAndShadingConstants.LINEWIDTH_300PT);
         attribute.setBorderLineColor(BorderAndShadingConstants.BOTTOM,java.awt.Color.gray);
         r.setBorderAttribute(attribute);

  See Also:
    `SsBorderAttribute`, `BorderAndShadingConstants`

### setCellAttribute

    public void setCellAttribute(CellAttribute cellAttribute)

  设置单元格或单元格区域的格式。

  Parameters:
    `cellAttribute` - 单元格属性对象 例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("A1:A4");
         CellAttribute ca = range.getActive().getCellAttribute();
         ca.setFontColor(java.awt.Color.red);
         range.setCellAttribute(ca);

  See Also:
    `CellAttribute`

### setConditionalFormatting

    public void setConditionalFormatting(int type,
                                         int operator,
                                         java.lang.String formula1,
                                         java.lang.String formula2,
                                         FontAttribute fontAttribute,
                                         SsBorderAttribute borderAttribute,
                                         java.awt.Color color)

  设置条件格式（一个条件）。

  Parameters:
    `type` - 条件1：

                      type1为0，则表示单元格数值；
                      type1为1，则表示公式

    `operator` - 第一比较符：

                      0 － 介于；
                      1 － 不介于；
                      2 － 等于；
                      3 － 不等于；
                      4 － 大于；
                      5 － 小于；
                      6 － 大于等于；
                      7 － 小于等于

    `formula1` - 首个公式1
    `formula2` - 首个公式2
    `fontAttribute` - 单元格字体属性
    `borderAttribute` - 单元格边框属性
    `color` - 单元格背景色颜色

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").setConditionalFormatting(0,0,"=sum(A1:A3)","=average(B2:B5)",
                                                               new FontAttribute(),
                                                               new SsBorderAttribute(),
                                                               java.awt.Color.red);

### setConditionalFormatting

    public void setConditionalFormatting(int type1,
                                         int operator1,
                                         java.lang.String formula11,
                                         java.lang.String formula12,
                                         FontAttribute fontAttribute1,
                                         SsBorderAttribute borderAttribute1,
                                         java.awt.Color color1,
                                         int type2,
                                         int operator2,
                                         java.lang.String formula21,
                                         java.lang.String formula22,
                                         FontAttribute fontAttribute2,
                                         SsBorderAttribute borderAttribute2,
                                         java.awt.Color color2)

  设置条件格式（两个条件）。

  Parameters:
    `type1` - 条件1：

                      type1为0，则表示单元格数值；
                      type1为1，则表示公式

    `operator1` - 第一比较符：

                      0 － 介于；
                      1 － 不介于；
                      2 － 等于；
                      3 － 不等于；
                      4 － 大于；
                      5 － 小于；
                      6 － 大于等于；
                      7 － 小于等于

    `formula11` - 条件1公式1
    `formula12` - 条件1公式2
    `fontAttribute1` - 条件1单元格字体属性
    `borderAttribute1` - 条件1单元格边框属性
    `color1` - 条件1单元格背景色颜色
    `type2` - 条件2：

                      type1为0，则表示单元格数值；
                      type1为1，则表示公式

    `operator2` - 第二比较符：

                      0 － 介于；
                      1 － 不介于；
                      2 － 等于；
                      3 － 不等于；
                      4 － 大于；
                      5 － 小于；
                      6 － 大于等于；
                      7 － 小于等于

    `formula21` - 条件2公式1
    `formula22` - 条件2公式2
    `fontAttribute2` - 条件2单元格字体属性
    `borderAttribute2` - 条件2单元格边框属性
    `color2` - 条件2单元格背景色颜色

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").setConditionalFormatting(0,2,"=sum(A1:A3)","=average(B2:B5)",
                                                               new FontAttribute(),
                                                               new SsBorderAttribute(),
                                                               java.awt.Color.blue,
                                                               0,0,"=sum(D1:D3)","=average(C2:C5)",
                                                               new FontAttribute(),
                                                               new SsBorderAttribute(),
                                                               java.awt.Color.red);

  See Also:
    `setConditionalFormatting(int type, int operator, String formula1, String formula2, FontAttribute fontAttribute, SsBorderAttribute borderAttribute, Color color)`

### setConditionalFormatting

    public void setConditionalFormatting(int type1,
                                         int operator1,
                                         java.lang.String formula11,
                                         java.lang.String formula12,
                                         FontAttribute fontAttribute1,
                                         SsBorderAttribute borderAttribute1,
                                         java.awt.Color color1,
                                         int type2,
                                         int operator2,
                                         java.lang.String formula21,
                                         java.lang.String formula22,
                                         FontAttribute fontAttribute2,
                                         SsBorderAttribute borderAttribute2,
                                         java.awt.Color color2,
                                         int type3,
                                         int operator3,
                                         java.lang.String formula31,
                                         java.lang.String formula32,
                                         FontAttribute fontAttribute3,
                                         SsBorderAttribute borderAttribute3,
                                         java.awt.Color color3)

  设置条件格式（三个条件）。

  Parameters:
    `type1` - 条件1：

                      type1为0，则表示单元格数值；
                      type1为1，则表示公式

    `operator1` - 第一比较符：

                      0 － 介于；
                      1 － 不介于；
                      2 － 等于；
                      3 － 不等于；
                      4 － 大于；
                      5 － 小于；
                      6 － 大于等于；
                      7 － 小于等于

    `formula11` - 条件1公式1
    `formula12` - 条件1公式2
    `fontAttribute1` - 条件1单元格字体属性
    `borderAttribute1` - 条件1单元格边框属性
    `color1` - 条件1单元格背景色颜色
    `type2` - 条件2：

                      type1为0，则表示单元格数值；
                      type1为1，则表示公式

    `operator2` - 第二比较符：

                      0 － 介于；
                      1 － 不介于；
                      2 － 等于；
                      3 － 不等于；
                      4 － 大于；
                      5 － 小于；
                      6 － 大于等于；
                      7 － 小于等于

    `formula21` - 条件2公式1
    `formula22` - 条件2公式2
    `fontAttribute2` - 条件2单元格字体属性
    `borderAttribute2` - 条件2单元格边框属性
    `color2` - 条件2单元格背景色颜色
    `type3` - 条件3：

                      type1为0，则表示单元格数值；
                      type1为1，则表示公式

    `operator3` - 第三比较符：

                      0 － 介于；
                      1 － 不介于；
                      2 － 等于；
                      3 － 不等于；
                      4 － 大于；
                      5 － 小于；
                      6 － 大于等于；
                      7 － 小于等于

    `formula31` - 条3公式1
    `formula32` - 条件3公式2
    `fontAttribute3` - 条件3单元格字体属性
    `borderAttribute3` - 条件3单元格边框属性
    `color3` - 条件3单元格背景色颜色

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").setConditionalFormatting(0,2,"=sum(A1:A3)","=average(B2:B5)",
                                                               new FontAttribute(),
                                                               new SsBorderAttribute(),
                                                               java.awt.Color.red,
                                                               0,0,"=sum(B1:B3)","=average(C2:C5)",
                                                               new FontAttribute(),
                                                               new SsBorderAttribute(),
                                                               java.awt.Color.blue,
                                                               0,0,"=sum(C1:C3)","=average(D2:D5)",
                                                               new FontAttribute(),
                                                               new SsBorderAttribute(),
                                                               java.awt.Color.green);

  See Also:
    `setConditionalFormatting(int type, int operator, String formula1, String formula2, FontAttribute fontAttribute, SsBorderAttribute borderAttribute, Color color)`

### setFormulaArray

    public void setFormulaArray(java.lang.String value)

  设置数组公式。

  Parameters:
    `value` - 填充的数组公式

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("A1:B2");
         range.fillRandom();
         worksheet.getRange("c1:G4").setFormulaArray("=sum(A1:B2)");

### setValidation

    public void setValidation(int type,
                              int alertStyle,
                              int operator,
                              java.lang.String maximum,
                              java.lang.String minimum,
                              boolean ignoreBlank,
                              boolean inCellDropDown,
                              java.lang.String inputTitle,
                              java.lang.String errorTitle,
                              java.lang.String inputMessage,
                              java.lang.String errorMessage,
                              boolean showInput,
                              boolean showError)

  校验数据的有效性。

  Parameters:
    `type` - 设置校验的类型，type可取下列值： 0 － 任何类型； 1 － 整数； 2 － 小数； 3 － 列表； 4 － 日期； 5 － 时间； 6 － 文本长度； 7 － 用户自定义
    `alertStyle` - 设置出错警告的样式，alertStyle可取下列值： 0：则样式为终止； 1：则样式为警告； 2：则样式为信息
    `operator` - 比较操作符的类型：operator取下列值： 0 － 介于； 1 － 不介于； 2 － 等于； 3 － 不等于； 4 － 大于； 5 － 小于； 6 － 大于等于； 7 － 小于等于
    `maximum` - 比较的第一(或唯一)个值或公式
    `minimum` - 比较的第二个值或公式
    `ignoreBlank` - 布尔型，如为true，则忽略空单元格；否则不忽略空单元格
    `inCellDropDown` - 是否提供下拉箭头
    `inputTitle` - 输入提示信息的标题
    `inputMessage` - 输入提示信息的内容
    `errorTitle` - 警告对话框的标题
    `errorMessage` - 警告对话框的内容
    `showInput` - 布尔型，如为true，设置显示提示信息；否则不显示提示信息
    `showError` - 布尔型，如为true，当输入内容不符合校验时，弹出警告对话框；否则，不弹出警告对话框

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G10").setValidation(3,1，0，"3","9",true,true,"??",".....",
                                                    "!!","$%&$*$",true,true);

### setValue

    public void setValue(boolean value)

  用布尔型数据设置所选单元格区域的内容。

  Parameters:
    `value` - 待填充的布尔型数据

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").setValue(true);

### setValue

    public void setValue(double value)

  用双精度型数据设置所选单元格区域的内容。

  Parameters:
    `value` - 待填充的双精度型数据

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").setValue(3.141592653);

### setValue

    public void setValue(long value)

  用长整型数据设置所选单元格区域的内容。

  Parameters:
    `value` - 待填充的长整型数据

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").setValue(123456789);

### setValue

    public void setValue(java.lang.Object object)

  用指定类型的数据设置所选单元格区域的内容。

  Parameters:
    `object` - 待填充的对象类型的数据

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").setValue(new File("c:/test.txt"));

### setValue

    public void setValue(java.lang.String value)

  用字符串类型的数据设置所选单元格区域的内容。

  Parameters:
    `value` - 待填充的字符串类型的数据

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").setValue("abc");

### shiftDownAndCopy

    public void shiftDownAndCopy(java.lang.String rangeAddress)

  目标单元格向下移动且复制源。

  Parameters:
    `rangeAddress` - 源单元格区域引用

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("e9:g10");
         range.fillRandom();
         worksheet.getRange("a1").shiftDownAndCopy("G9");

### shiftDownAndMove

    public void shiftDownAndMove(java.lang.String rangeAddress)

  目标单元格向下移动且移动源。

  Parameters:
    `rangeAddress` - 源单元格区域引用

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("e9:g10");
         range.fillRandom();
         worksheet.getRange("A1:G4").shiftDownAndMove("G9");

### shiftRightAndCopy

    public void shiftRightAndCopy(java.lang.String rangeAddress)

  目标单元格向右移动且复制源。

  Parameters:
    `rangeAddress` - 源单元格区域引用

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("e9:g10");
         range.fillRandom();
         worksheet.getRange("A1:G4").shiftRightAndCopy("e9:g10");

### shiftRightAndMove

    public void shiftRightAndMove(java.lang.String rangeAddress)

  目标单元格向右移动且移动源。

  Parameters:
    `rangeAddress` - 源单元格区域引用

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("e9:g10");
         range.fillRandom();
         worksheet.getRange("A1:G4").shiftRightAndMove("G9");

### showAll

    public void showAll()

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

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").showAll();

### showDetail

    public void showDetail()

  显示明细数据。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                       .getWorksheets().getActiveWorksheet();
       Range range = worksheet.getRange("a1:e10");
       range.fillRandom();
       range.addGroup(true);
       worksheet.getRange("a1:e10").showDetail();

  See Also:
    `hideDetail()`

### sort

    public void sort(SortProperties sortProperties)

  对所选单元格区域中的数据进行排序。

  Parameters:
    `sortProperties` - 排序属性

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                          .getWorksheets().getActiveWorksheet();
         SortProperties sort = new SortProperties();
         sort.setOrder1(true);
         worksheet.getRange("A1:G10").sort(sort);

  See Also:
    `SortProperties`

### subtotal

    public void subtotal(int fieldIndex,
                         int styleIndex,
                         int[] item,
                         boolean change,
                         boolean pageBreak,
                         boolean result)

  设置分类汇总。

  Parameters:
    `fieldIndex` - 字段索引，由0开始
    `styleIndex` - 汇总方式，取值范围0~10

         SUM        － 求和；
         COUNT      － 计数；
         AVERAGE    － 平均值；
         MAX        － 最大值；
         MIN        － 最小值；
         PRODUCT    － 乘积；
         COUNT_NUMS － 计数值；
         STD_DEV    － 标准偏差；
         STD_DEVP   － 总体标准偏差；
         VAR        － 方差；
         VARP       － 总体方差

    `item` - 汇总项，所有参与汇总字段的索引
    `change` - true，替换当前分类汇总；false，不替换
    `pageBreak` - true，每组数据分页；false，不分页
    `result` - true，汇总结果显示在数据下方；false，直接显示

    例子：

         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         worksheet.getRange("A1:G4").subtotal(0,ConsolidateConstants.SUM,new int[] {1,3},true,false,true);

  See Also:
    `ConsolidateConstants`

### toString

    public java.lang.String toString()

### unmerge

    public void unmerge()

  清除选取单元格区域里存在的合并单元格。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").unmerge();

  See Also:
    `merge(boolean)`, `mergeAcross()`

### unprotectCells

    public void unprotectCells()

  对当前单元格或单元格区域解除保护。

  例子：

       Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                        .getWorksheets().getActiveWorksheet();
       worksheet.getRange("A1:G10").unprotectCells();

  See Also:
    `protectCells()`

Overview | Package | Class | Tree | Index | Help

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

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