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

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

## application.workbooks.workbook.worksheets.worksheet
类 ActiveCell

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

    public class ActiveCell

extends java.lang.Object

该类定义了对活动单元格进行操作的一些方法，如为活动单元格设置数值或文本，添加注释，插入图片及影音文件等。

自从：
  V1.1

构造函数摘要
`ActiveCell()`

方法摘要
`static void` | `floatChart()` 浮起单元格内chart。
`static void` | `floatPicture()` 浮起单元格内图片 。
`static Characters` | `getCharacters(int startPosition, int length)` 获取活动单元格中部分字符集。
`static Comment` | `getComment()` 获取当前活动单元格内的注释对象。
`static Comment` | `insertComment()` 在活动单元格中插入注释。
`static void` | `insertMultiMedia(java.lang.String name)` 在当前的活动单元格中插入一个影音文件。
`static void` | `insertPicture(java.lang.String pictureName)` 在当前的活动单元格中插入一幅图片。
`static void` | `linkRange(java.lang.String rangeAddress)` 连接区域。
`static Cell` | `offset(int rows, int columns)` 返回偏移指定行数、列数后的单元格。
`static void` | `setValue(java.lang.String value)` 为活动单元格设置数值或文本。
`static void` | `showComment(boolean show)` 显示活动单元格中的注释。

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

构造函数详细信息

### ActiveCell

    public ActiveCell()

方法详细信息

### floatChart

    public static void floatChart()

  浮起单元格内chart。

  例子：

       //浮起单元格内的图表(此时单元格内已有嵌入图表)。
       Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
       ActiveCell.floatChart();

  抛出：
    `MacroRunException` - 当单元格区域已被保护

### floatPicture

    public static void floatPicture()

  浮起单元格内图片 。

  例子：

       //浮起单元格内图片(此时单元格内已有图片)。
       Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
       ActiveCell.floatPicture();

  抛出：
    `MacroRunException` - 当单元格区域已被保护

### getCharacters

    public static Characters getCharacters(int startPosition,
                                           int length)

  获取活动单元格中部分字符集。

  参数：
    `startPosition` - 字符的起始索引
    `length` - 字符的长度
  返回：
    指定的字符集

    例子：

         //取得当前活动工作表中活动单元格的部分字符集，并在控制台输出。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = worksheet.getCell("A1");
         cell.setValue("evermore");
         cell.select();
         Characters chars = ActiveCell.getCharacters(0, 4);
         System.out.println("Characters: " + chars);

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

### getComment

    public static Comment getComment()

  获取当前活动单元格内的注释对象。

  返回：
    当前活动单元格内的注释

    例子：

         //获取当前活动工作表内活动单元格的注释内容，并在控制台输出。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = worksheet.getCell("B4");
         Comment comment = cell.insertComment();
         comment.setText("evermore");
         cell.select();
         String text = ActiveCell.getComment().getText();
         System.out.println(text);

### insertComment

    public static Comment insertComment()

  在活动单元格中插入注释。

  返回：
    注释对象

    例子：

         //在当前活动工作表的活动单元格中插入注释"evermore"。
         Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Comment comment = ActiveCell.insertComment();
         comment.setText("evermore");

### insertMultiMedia

    public static void insertMultiMedia(java.lang.String name)

  在当前的活动单元格中插入一个影音文件。

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

    例子：

         Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         ActiveCell.insertMultimedia("D:\\movie\\clock.avi");

  抛出：
    `MacroRunException` - 当给定的影音文件名找不到
    `MacroRunException` - 当单元格区域已被保护

### insertPicture

    public static void insertPicture(java.lang.String pictureName)

  在当前的活动单元格中插入一幅图片。

  参数：
    `pictureName` - 待插入图片的文件名

    例子：

         //在当前活动单元格中插入一幅图片。
         Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         ActiveCell.insertPicture("G:\\picture\\wangxinling.jpg");

  抛出：
    `MacroRunException` - 当给定的图片的文件名找不到
    `MacroRunException` - 当单元格区域已被保护

### linkRange

    public static void linkRange(java.lang.String rangeAddress)

  连接区域。

  参数：
    `rangeAddress` - 目标区域

    例子：

         //设置单元格G7连接到单元格区域"B3:E5"。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                         .getWorksheets().getActiveWorksheet();
         Range range = worksheet.getRange("B3:E5");
         range.setValue("evermore");
         Cell cell = worksheet.getCell("G7");
         cell.select();
         ActiveCell.linkRange("B3:E5");

  抛出：
    `MacroRunException` - 当给定的区域地址错误或越界
    `MacroRunException` - 当单元格区域已被保护

### offset

    public static Cell offset(int rows,
                              int columns)

  返回偏移指定行数、列数后的单元格。

  参数：
    `rows` - 需要偏移的行数
    `columns` - 需要偏移的列数 注意：正数表示向右移和向下移，负数表示向左移和向上移。

    例子：

         //获得当前活动单元格偏移两行两列后的单元格对象。
         Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Cell cell = ActiveCell.offset(2, 2);

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

### setValue

    public static void setValue(java.lang.String value)

  为活动单元格设置数值或文本。

  参数：
    `value` - 用于设置单元格数据的文本或数值，字符串型

    例子：

         //给当前活动工作表的活动单元格设置字符串"ABC"。
         Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         ActiveCell.setValue("ABC");

  抛出：
    `MacroRunException` - 当单元格区域已被保护或不允许编辑

### showComment

    public static void showComment(boolean show)

  显示活动单元格中的注释。

  参数：
    `show` - 布尔型值，如为true，则显示活动单元格中的注释；否则不显示注释

    例子：

         //显示当前活动单元格内的注释。
         Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook().getWorksheets().getActiveWorksheet();
         Comment comment = worksheet.getCell("B4").insertComment();
         comment.setText("evermore");
         worksheet.getCell("B4").select();
         ActiveCell.showComment(true);

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

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

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