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

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

## application.workbooks.workbook.presentations.presentation.slide
类 PgShapes

    java.lang.Object
      application.workbooks.workbook.Shapes
          application.workbooks.workbook.presentations.presentation.slide.PgShapes

    public class PgShapes

extends Shapes

该类定义了添加，获取，设置简报制作中图形对象的方法。

该类继承了Shapes类，可以通过Slide类中的getShapes()方法得到。

方法摘要
`Shape` | `addMediaObject(java.lang.String fileName, int type)` 添加一个多媒体文件。
`PgShape[]` | `getAllShapes()` 获得当前应用中的所有自选图形数组。
`PgShape[]` | `getPlaceHolder(int index)` 得到幻灯片上的占位符。
`PgShapeRange` | `getRange()` 获得被选中的自选图形，文本框或艺术字(ShapeRange)。
`PgShape` | `getShape(java.lang.String shapeName)` 根据名字获取图形对象。
`PgShape[]` | `getShapes(java.lang.String name)` 根据名称返回自选图形数组。

从类 application.workbooks.workbook.Shapes 继承的方法
`addConnector, addDataObject, addLine, addOLEObjectByFile, addOLEObjectByFile, addOLEObjectByType, addOLEObjectByType, addPicture, addShape, addTextBox, addWordArt, insertFraction, isLineDrawing, isSelectAll, selectAll, selectRange, size, unSelect`

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

方法详细信息

### addMediaObject

    public Shape addMediaObject(java.lang.String fileName,
                                int type)

  添加一个多媒体文件。

  参数：
    `fileName` - 多媒体文件路径
    `type` - 幻灯片放映时声音的播放方式：

           ShapeConstants.AUTO_MEDIA -- 表示幻灯片放映时多媒体自动播放（SWF格式的多媒体目前没有自动播放功能）
           ShapeConstants.CLICK_MEDIA -- 表示幻灯片放映时鼠标单击多媒体播放

  返回：
    多媒体对象

    例子：

         //当前幻灯片中插入路径为"C:\\1.mp3"的多媒体文件。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addMediaObject("C:\\1.mp3", ShapeConstants.CLICK_MEDIA);

  另请参见：
    `ShapeConstants`

### getAllShapes

    public PgShape[] getAllShapes()

  获得当前应用中的所有自选图形数组。

  插入的自选图形的先后决定了自选图形在数组中的位置。先插入的数组坐标靠前。 在简报制作中因为在幻灯片中已经有了占位符自选图形，所以新插入自选图形坐标不从０开始。

  指定者：
    类 `Shapes` 中的 `getAllShapes`
  返回：
    自选图形数组

    例子：

         //在当前应用新添加三个自选图形，然后在控制台输出getAllShapes方法返回的自选图形数组的长度。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addShape(1,200,200,400,400);
         shapes.addShape(2,500,500,600,600);
         shapes.addShape(3,300,300,450,450);
         System.out.println(shapes.getAllShapes().length);

  另请参见：
    `getShapes(String)`, `getShape(String)`, `getRange()`

### getPlaceHolder

    public PgShape[] getPlaceHolder(int index)

  得到幻灯片上的占位符。

  参数：
    `index` - 占位符的索引,0表示主占位符,1表示副文本占位符,2表示剪贴画,3表示表格,4表示媒体剪辑,5表示图表。
  返回：
    返回一个占位符对象。

    例子：

         //在主占位符中插入"EIO OFFICE"字符串
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes() ;
         PgShape[] shape = shapes.getPlaceHolder(0);
         shape[0].getShapeText().insertText("EIO OFFICE");

### getRange

    public PgShapeRange getRange()

  获得被选中的自选图形，文本框或艺术字(ShapeRange)。

  指定者：
    类 `Shapes` 中的 `getRange`
  返回：
    被选中的ShapeRange图形对象，当没有选中的自选图形的时候返回null。

    例子：

         //在当前应用插入一矩形和一平行四边形，全选自选图形，通过ShapeRange对象来设置所选中的两个图形的高度为500。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addShape(1,200,200,400,400);
         shapes.addShape(2,500,500,600,600);
         shapes.selectAll();
         PgShapeRange shaperange = shapes.getRange() ;
         shaperange.setHeight(500);

  另请参见：
    `getShapes(String)`, `getShape(String)`, `getAllShapes()`

### getShape

    public PgShape getShape(java.lang.String shapeName)

  根据名字获取图形对象。

  对于图形对象的名称，是由其类型加上ID。如"矩形 1"，"椭圆 2"每个图形插入到应用后ID就固定下来， 即使被删除，其后添加的图形ID也不能覆盖被删除的图形ID。

  指定者：
    类 `Shapes` 中的 `getShape`
  参数：
    `shapeName` - 图形对象的名字，如"矩形 1"
  返回：
    Shape图形对象

    例子：

         //在当前应用插入一矩形，通过名称获取这个矩形，并在控制台打印出这矩形的高度。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addShape(1,200,200,400,400);
         Shape shape = shapes.getShape("矩形 5");
         System.out.println(shape.getHeight());

  另请参见：
    `getShapes(String)`, `getRange()`, `getAllShapes()`

### getShapes

    public PgShape[] getShapes(java.lang.String name)

  根据名称返回自选图形数组。

  名称不包括ID数字。如简报制作中有"矩形 1"，"文本框 20"，"矩形 3"。通过getShapes("矩形") 方法能够返回包含"矩形 1"，"矩形 3"的Shape数组。

  指定者：
    类 `Shapes` 中的 `getShapes`
  参数：
    `name` - 自选图形名称，如：“矩形”，“同心圆”等
  返回：
    自选图形数组，当不存在时返回长度为0的数组。

    例子：

         //在简报制作添加三个自选图形，然后在控制台上输出简报制作矩形的个数。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addShape(1,200,200,400,400);
         shapes.addShape(2,500,500,600,600);
         shapes.addShape(1,300,300,450,450);
         System.out.println(shapes.getShapes("矩形").length);

  自从：
    1.32
  另请参见：
    `getShape(String)`

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

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

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