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

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

## application.workbooks.workbook
类 Shapes

    java.lang.Object
      application.workbooks.workbook.Shapes

直接已知子类：
  ChartShapes, PgShapes, SsShapes, WpShapes

    public abstract class Shapes

extends java.lang.Object

该类提供了添加，获得图形对象（自选图形，文本框，艺术字，电子公章）的方法。

该类为一抽象类，被WpShapes,SsShapes,PgShapes类所继承。

方法摘要
`Shape` | `addConnector(int type, double startX, double startY, double endX, double endY)` 添加连接线。
`Shape` | `addDataObject(application.doors.DataObject obj, double startX, double startY, double endX, double endY)` 添加DataObject对象类型的自选图形。
`Shape` | `addLine(int type, double startX, double startY, double endX, double endY)` 添加线条。
`Shape` | `addOLEObjectByFile(java.lang.String fileName, boolean displayAsIcon)` 根据指定的文件名称添加OLE对象。
`Shape` | `addOLEObjectByFile(java.lang.String fileName, boolean displayAsIcon, float startX, float startY, float endX, float endY)` 根据指定的文件名称添加OLE对象。
`Shape` | `addOLEObjectByType(java.lang.String classType, boolean displayAsIcon)` 根据OLE 对象的应用程序名称添加OLE对象。
`Shape` | `addOLEObjectByType(java.lang.String classType, boolean displayAsIcon, float startX, float startY, float endX, float endY)` 根据OLE 对象的应用程序名称添加OLE对象。
`Shape` | `addPicture(java.lang.String fileName)` 添加一个剪贴画或图片。
`Shape` | `addShape(int type, double startX, double startY, double endX, double endY)` 添加一个自选图形。
`Shape` | `addTextBox(int director, double startX, double startY, double endX, double endY)` 添加一个文本框。
`Shape` | `addWordArt(int wordArtStyle, java.lang.String text, java.lang.String fontName, int fontType, int fontSize, double startX, double startY, double endX, double endY)` 添加艺术字。
`abstract Shape[]` | `getAllShapes()` 获得当前应用中的所有自选图形数组。
`abstract application.workbooks.workbook.shapes.ShapeRange` | `getRange()` 获得被选中的自选图形，文本框或艺术字(ShapeRange)。
`abstract Shape` | `getShape(java.lang.String shapeName)` 根据名字获取图形对象。
`abstract Shape[]` | `getShapes(java.lang.String name)` 根据名称返回自选图形数组。
`Shape` | `insertFraction()` 插入数学分式
`boolean` | `isLineDrawing()` 判断当前状态是否在画曲线。
`boolean` | `isSelectAll()` 判断是否选中所有图形对象。
`void` | `selectAll()` 选中所有图形对象。
`void` | `selectRange(java.lang.String[] objectNames)` 选中自选图形，文本框或艺术字等图形对象。
`int` | `size()` 获得当前应用自选图形的数量。
`void` | `unSelect()` 没有图形对象被选中。

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

方法详细信息

### addConnector

    public Shape addConnector(int type,
                              double startX,
                              double startY,
                              double endX,
                              double endY)

  添加连接线。

  参数：
    `type` - 连接线类型

           type = 0，表示“直连接线”
           type = 1，表示“直箭头连接线”
           type = 2，表示“直双箭头连接线”
           type = 3, 表示“肘形连接线”
           type = 4, 表示“肘形箭头连接线”
           type = 5, 表示“肘形双箭头连接线”
           type = 6, 表示“曲线连接线”
           type = 7, 表示“曲线箭头连接线”
           type = 8, 表示“曲线双箭头连接线”

    `startX` - 起始点x坐标
    `startY` - 起始点y坐标
    `endX` - 终止点x坐标
    `endY` - 终止点y坐标
  返回：
    返回自选图形对象，当连接线类型不在上述9种时返回null。

    例子：

         //在当前应用中添加一直双箭头连接线。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addConnector(2, 200, 100, 290, 280);

  抛出：
    `MacroRunException` - 当无法插入连接线时

### addDataObject

    public Shape addDataObject(application.doors.DataObject obj,
                               double startX,
                               double startY,
                               double endX,
                               double endY)

  添加DataObject对象类型的自选图形。

  参数：
    `obj` - DataObject对象。
    `startX` - 左上角的x坐标
    `startY` - 左上角的y坐标
    `endX` - 右下角的x坐标
    `endY` - 右下角的y坐标
  返回：
    返回自选图形对象

    例子:

         //在当前应用总添加DataObject对象类型的自选图形。
         DataObject obj = Sheet.getActiveAuxSheet().createDataObject();
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addDataObject(obj,10,10,300,300);

### addLine

    public Shape addLine(int type,
                         double startX,
                         double startY,
                         double endX,
                         double endY)

  添加线条。

  参数：
    `type` - 线条类型 0 直线 1 箭头 2 双箭头
    `startX` - 起始点X坐标
    `startY` - 起始点Y坐标
    `endX` - 终止点x坐标
    `endY` - 终止点Y坐标
  返回：
    返回自选图形对象，当线条类型不在上述三种时返回null。

    例子：

         //在当前应用中添加一箭头。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addLine(1, 200, 100, 290, 280);

  抛出：
    `MacroRunException` - 当无法插入线条时

### addOLEObjectByFile

    public Shape addOLEObjectByFile(java.lang.String fileName,
                                    boolean displayAsIcon)

  根据指定的文件名称添加OLE对象。 如果在文字处理中使用此API，则ole对象以嵌入方式插入。

       请注意：
       1、此方法只限于在Windows操作系统中使用,其它操作系统中调用则返回null。
       2、不支持eio后缀的文件作为ole对象插入，如果指定文件为eio文件，则返回null。

  参数：
    `fileName` - 创建对象所用的文件名称
    `displayAsIcon` - 是否显示为图标
  返回：
    返回OLE对象所属自选图形对象,如果指定的文件不存在，则返回null。

### addOLEObjectByFile

    public Shape addOLEObjectByFile(java.lang.String fileName,
                                    boolean displayAsIcon,
                                    float startX,
                                    float startY,
                                    float endX,
                                    float endY)

  根据指定的文件名称添加OLE对象。如果在文字处理中使用此API，则ole对象以浮动方式插入。

       请注意：
       1、此方法只限于在Windows操作系统中使用,其它操作系统中调用则返回null。
       2、不支持eio后缀的文件作为ole对象插入，如果指定文件为eio文件，则返回null。

  参数：
    `fileName` - 创建对象所用的文件名称
    `displayAsIcon` - 是否显示为图标
    `startX` - 起始点x坐标，如果小于0则默认为0
    `startY` - 起始点y坐标，如果小于0则默认为0
    `endX` - 终止点x坐标，如果小于0则默认为起始点坐标 ＋ 30
    `endY` - 终止点y坐标，如果小于0则默认为起始点坐标 ＋ 30
  返回：
    返回OLE对象所属自选图形对象,如果指定的文件不存在，则返回null。

### addOLEObjectByType

    public Shape addOLEObjectByType(java.lang.String classType,
                                    boolean displayAsIcon)

  根据OLE 对象的应用程序名称添加OLE对象。OLE 对象的应用程序名称为ole对象在注册表中的ProgID.如"Word.Document.8"、"Excel.Sheet.8"等。 如果在文字处理中使用此API，则ole对象以嵌入方式插入。在OLE对象插入过程中，永中office将处于无法操作状态， 只有将OLE对象关闭后，永中office才可以继续操作。

       请注意此方法只限于在Windows操作系统中使用,其它操作系统中调用则返回null。

  参数：
    `classType` - 用于激活指定 OLE 对象的应用程序名称
    `displayAsIcon` - 是否显示为图标
  返回：
    返回OLE对象所属自选图形对象，如果根据classtype无法找到对应的ole对象，则返回null。

    例子:

         //在当前应用中插入word文档
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         Shape shape = shapes.addOLEObjectByType("Word.Document.8", true);
         System.out.println("shape is "+shape.getName());

### addOLEObjectByType

    public Shape addOLEObjectByType(java.lang.String classType,
                                    boolean displayAsIcon,
                                    float startX,
                                    float startY,
                                    float endX,
                                    float endY)

  根据OLE 对象的应用程序名称添加OLE对象。OLE 对象的应用程序名称为ole对象在注册表中的ProgID.如"Word.Document.8"、"Excel.Sheet.8"等。 如果在文字处理中使用此API，则ole对象以浮动方式插入。在OLE对象插入过程中，永中office将处于无法操作状态， 只有将OLE对象关闭后，永中office才可以继续操作。

       请注意此方法只限于在Windows操作系统中使用,其它操作系统中调用则返回null。

  参数：
    `classType` - 用于激活指定 OLE 对象的应用程序名称
    `displayAsIcon` - 是否显示为图标
    `startX` - 起始点x坐标，如果小于0则默认为0
    `startY` - 起始点y坐标，如果小于0则默认为0
    `endX` - 终止点x坐标，如果小于0则默认为起始点坐标 ＋ 30
    `endY` - 终止点y坐标，如果小于0则默认为起始点坐标 ＋ 30
  返回：
    返回OLE对象所属自选图形对象，如果根据classtype无法找到对应的ole对象，则返回null。

    例子:

         //在当前应用中插入word文档
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         Shape shape = shapes.addOLEObjectByType("Word.Document.8", true, 50,50,80,80);
         System.out.println("shape is "+shape.getName());

### addPicture

    public Shape addPicture(java.lang.String fileName)

  添加一个剪贴画或图片。

  参数：
    `filename` - 图片文件路径
  返回：
    返回自选图形对象

    例子:

         //在当前应用中添加路径为"C:/test.bmp"的图片。
          Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
          shapes.addPicture("C:/test.bmp");

  抛出：
    `MacroRunException` - 当文件位置不存在，或者文件类型不是图形，或者不能插入时。

### addShape

    public Shape addShape(int type,
                          double startX,
                          double startY,
                          double endX,
                          double endY)

  添加一个自选图形。

  参数：
    `type` - 自选图形的类型，其取值和相应的自选图形如下：

                 ShapeConstants.SHAPE_RECTANGLE                           矩形
                 ShapeConstants.SHAPE_PARALLELOGRAM                       平行四边形
                 ShapeConstants.SHAPE_TRAPEZOID                           梯形
                 ShapeConstants.SHAPE_DIAMOND                             菱形
                 ShapeConstants.SHAPE_ROUNDED_RECTANGLE                   圆角矩形
                 ShapeConstants.SHAPE_OCTAGON                             八边形
                 ShapeConstants.SHAPE_ISOSCELES_TRIANGLE                  等腰三角形
                 ShapeConstants.SHAPE_RIGHT_TRIANGLE                      右三角
                 ShapeConstants.SHAPE_OVAL                                椭圆
                 ShapeConstants.SHAPE_HEXAGON                             六边形
                 ShapeConstants.SHAPE_CROSS                               十字形
                 ShapeConstants.SHAPE_REGULAR_PENTAGON                    正五边形
                 ShapeConstants.SHAPE_CAN                                 圆柱形
                 ShapeConstants.SHAPE_CUBE                                立方体
                 ShapeConstants.SHAPE_BEVEL                               棱台
                 ShapeConstants.SHAPE_FOLDED_CORNER                       折角形
                 ShapeConstants.SHAPE_SMILEY_FACE                         笑脸
                 ShapeConstants.SHAPE_DONUT                               同心圆
                 ShapeConstants.SHAPE_NO_SYMBOL                           禁止符
                 ShapeConstants.SHAPE_BLOCK_ARC                           空心弧
                 ShapeConstants.SHAPE_HEART                               心形
                 ShapeConstants.SHAPE_LIGHTNING_BOLT                      闪电形
                 ShapeConstants.SHAPE_SUN                                 太阳形
                 ShapeConstants.SHAPE_MOON                                新月形
                 ShapeConstants.SHAPE_ARC                                 弧形
                 ShapeConstants.SHAPE_DOUBLE_BRACKET                      双括号
                 ShapeConstants.SHAPE_DOUBLE_BRACE                        双大括号
                 ShapeConstants.SHAPE_PLAQUE                              缺角矩形
                 ShapeConstants.SHAPE_LEFT_BRACKET                        左小括号
                 ShapeConstants.SHAPE_RIGHT_BRACKET                       右小括号
                 ShapeConstants.SHAPE_LEFT_BRACE                          左大括号
                 ShapeConstants.SHAPE_RIGHT_BRACE                         右大括号
                 ShapeConstants.SHAPE_RIGHT_ARROW                         右箭头
                 ShapeConstants.SHAPE_LEFT_ARROW                          左箭头
                 ShapeConstants.SHAPE_UP_ARROW                            上箭头
                 ShapeConstants.SHAPE_DOWN_ARROW                          下箭头
                 ShapeConstants.SHAPE_LEFT_RIGHT_ARROW                    左右箭头
                 ShapeConstants.SHAPE_UP_DOWN_ARROW                       上下箭头
                 ShapeConstants.SHAPE_QUAD_ARROW                          十字箭头
                 ShapeConstants.SHAPE_LEFT_RIGHT_UP_ARROW                 丁字箭头
                 ShapeConstants.SHAPE_BENT_ARROW                          圆角右箭头
                 ShapeConstants.SHAPE_U_TURN_ARROW                        手杖形箭头
                 ShapeConstants.SHAPE_LEFT_UP_ARROW                       直角双向箭头
                 ShapeConstants.SHAPE_BNET_UP_ARROW                       直角上箭头
                 ShapeConstants.SHAPE_CURVED_RIGHT_ARROW                  右弧形箭头
                 ShapeConstants.SHAPE_CURVED_LEFT_ARROW                   左弧形箭头
                 ShapeConstants.SHAPE_CURVED_UP_ARROW                     上弧形箭头
                 ShapeConstants.SHAPE_CURVED_DOWN_ARROW                   下弧形箭头
                 ShapeConstants.SHAPE_STRIPED_RIGHT_ARROW                 虚尾箭头
                 ShapeConstants.SHAPE_NOTCHED_RIGHT_ARROW                 燕尾形箭头
                 ShapeConstants.SHAPE_PENTAGON                            五边形
                 ShapeConstants.SHAPE_CHEVRON                             燕尾形
                 ShapeConstants.SHAPE_RIGHT_ARROW_CALLOUT                 右箭头标注
                 ShapeConstants.SHAPE_LEFT_ARROW_CALLOUT                  左箭头标注
                 ShapeConstants.SHAPE_UP_ARROW_CALLOUT                    上箭头标注
                 ShapeConstants.SHAPE_DOWN_ARROW_CALLOUT                  下箭头标注
                 ShapeConstants.SHAPE_LEFT_RIGHT_ARROW_CALLOUT            左右箭头标注
                 ShapeConstants.SHAPE_UP_DOWN_ARROW_CALLOUT               上下箭头标注
                 ShapeConstants.SHAPE_QUAD_ARROW_CALLOUT                  十字箭头标注
                 ShapeConstants.SHAPE_CIRCULAR_ARROW                      环形箭头标注
                 ShapeConstants.SHAPE_FLOWCHART_PROCESS                   流程图过程
                 ShapeConstants.SHAPE_FLOWCHART_ALTERNATE_PROCESS         流程图可选过程
                 ShapeConstants.SHAPE_FLOWCHART_DECISION                  流程图决策
                 ShapeConstants.SHAPE_FLOWCHART_DATA                      流程图数据
                 ShapeConstants.SHAPE_FLOWCHART_PREDEFINED_PROCESS        流程图预定义过程
                 ShapeConstants.SHAPE_FLOWCHART_INTERNAL_STORAGE          流程图内部贮存
                 ShapeConstants.SHAPE_FLOWCHART_DOCUMENT                  流程图文档
                 ShapeConstants.SHAPE_FLOWCHART_MULTIDOCUMENT             流程图多文档
                 ShapeConstants.SHAPE_FLOWCHART_TERMINATOR                流程图终止
                 ShapeConstants.SHAPE_FLOWCHART_PREPARATION               流程图准备
                 ShapeConstants.SHAPE_FLOWCHART_MANUAL_INPUT              流程图人工输入
                 ShapeConstants.SHAPE_FLOWCHART_MANUAL_OPERATION          流程图人工操作
                 ShapeConstants.SHAPE_FLOWCHART_CONNECTOR                 流程图联系
                 ShapeConstants.SHAPE_FLOWCHART_OFFPAGE_CONNECTOR         流程图离页连接符
                 ShapeConstants.SHAPE_FLOWCHART_CARD                      流程图卡片
                 ShapeConstants.SHAPE_FLOWCHART_PUNCHED_TAPE              流程图资料带
                 ShapeConstants.SHAPE_FLOWCHART_SUMMING_JUNCTION          流程图汇总连接
                 ShapeConstants.SHAPE_FLOWCHART_OR                        流程图或者
                 ShapeConstants.SHAPE_FLOWCHART_COLLATE                   流程图对照
                 ShapeConstants.SHAPE_FLOWCHART_SORT                      流程图排序
                 ShapeConstants.SHAPE_FLOWCHART_EXTRACT                   流程图摘录
                 ShapeConstants.SHAPE_FLOWCHART_MERGE                     流程图合并
                 ShapeConstants.SHAPE_FLOWCHART_STORED_DATA               流程图库存数据
                 ShapeConstants.SHAPE_FLOWCHART_DELAY                     流程图延期
                 ShapeConstants.SHAPE_FLOWCHART_SEQUENTIAL_ACCESS_STORAGE 流程图顺序访问存储器
                 ShapeConstants.SHAPE_FLOWCHART_MAGNETIC_DISK             流程图磁盘
                 ShapeConstants.SHAPE_FLOWCHART_DIRECT_ACCESS_STORAGE     流程图直接访问存储器
                 ShapeConstants.SHAPE_FLOWCHART_DISPLAY                   流程图显示
                 ShapeConstants.SHAPE_EXPLOSION1                          爆炸形1
                 ShapeConstants.SHAPE_EXPLOSION2                          爆炸形2
                 ShapeConstants.SHAPE_4_POINT_STAR                        十字星
                 ShapeConstants.SHAPE_5_POINT_STAR                        五角星
                 ShapeConstants.SHAPE_8_POINT_STAR                        八角星
                 ShapeConstants.SHAPE_16_POINT_STAR                       十六角星
                 ShapeConstants.SHAPE_24_POINT_STAR                       二十四角星
                 ShapeConstants.SHAPE_32_POINT_STAR                       三十二角星
                 ShapeConstants.SHAPE_UP_RIBBON                           上凸带形
                 ShapeConstants.SHAPE_DOWN_RIBBON                         前凸带形
                 ShapeConstants.SHAPE_CURVED_UP_RIBBON                    上凸弯带形
                 ShapeConstants.SHAPE_CURVED_DOWN_RIBBON                  前凸弯带形
                 ShapeConstants.SHAPE_VERTICAL_SCROLL                     坚卷形
                 ShapeConstants.SHAPE_HORIZONTAL_SCROLL                   横卷形
                 ShapeConstants.SHAPE_WAVE                                波形
                 ShapeConstants.SHAPE_DOUBLE_WAVE                         双波形
                 ShapeConstants.SHAPE_RECTANGULAR_CALLOUT                 矩形标注
                 ShapeConstants.SHAPE_ROUNDED_RECTANGULAR_CALLOUT         圆角矩形标注
                 ShapeConstants.SHAPE_OVAL_CALLOUT                        椭圆形标注
                 ShapeConstants.SHAPE_CLOUD_CALLOUT                       云形标注
                 ShapeConstants.SHAPE_LINE_CALLOUT1                       线形标注1
                 ShapeConstants.SHAPE_LINE_CALLOUT2                       线形标注2
                 ShapeConstants.SHAPE_LINE_CALLOUT3                       线形标注3
                 ShapeConstants.SHAPE_LINE_CALLOUT4                       线形标注4
                 ShapeConstants.SHAPE_LINE_CALLOUT1_ACCENT_BAR            线形标注1（带强调线）
                 ShapeConstants.SHAPE_LINE_CALLOUT2_ACCENT_BAR            线形标注2（带强调线）
                 ShapeConstants.SHAPE_LINE_CALLOUT3_ACCENT_BAR            线形标注3（带强调线）
                 ShapeConstants.SHAPE_LINE_CALLOUT4_ACCENT_BAR            线形标注4（带强调线）
                 ShapeConstants.SHAPE_LINE_CALLOUT1_NO_BORDER             线形标注1（无边框）
                 ShapeConstants.SHAPE_LINE_CALLOUT2_NO_BORDER             线形标注2（无边框）
                 ShapeConstants.SHAPE_LINE_CALLOUT3_NO_BORDER             线形标注3（无边框）
                 ShapeConstants.SHAPE_LINE_CALLOUT4_NO_BORDER             线形标注4（无边框）
                 ShapeConstants.SHAPE_LINE_CALLOUT1_BORDER_AND_ACCENT_BAR 线形标注1（带边框和强调线）
                 ShapeConstants.SHAPE_LINE_CALLOUT2_BORDER_AND_ACCENT_BAR 线形标注2（带边框和强调线）
                 ShapeConstants.SHAPE_LINE_CALLOUT3_BORDER_AND_ACCENT_BAR 线形标注3（带边框和强调线）
                 ShapeConstants.SHAPE_LINE_CALLOUT4_BORDER_AND_ACCENT_BAR 线形标注4（带边框和强调线）
                 ShapeConstants.SHAPE_ACTION_BUTTON_CUSTOM                动作按钮（自定义）
                 ShapeConstants.SHAPE_ACTION_BUTTON_HOME                  动作按钮（第一张）
                 ShapeConstants.SHAPE_ACTION_BUTTON_HELP                  动作按钮（帮助）
                 ShapeConstants.SHAPE_ACTION_BUTTON_INFORMATION           动作按钮（信息）
                 ShapeConstants.SHAPE_ACTION_BUTTON_BACKOR_PREVIOUS       动作按钮（后退或前一项）
                 ShapeConstants.SHAPE_ACTION_BUTTON_FORWARDOR_NEXT        动作按钮（前进或下一项）
                 ShapeConstants.SHAPE_ACTION_BUTTON_BEGINNING             动作按钮（开始）
                 ShapeConstants.SHAPE_ACTION_BUTTON_END                   动作按钮（结束）
                 ShapeConstants.SHAPE_ACTION_BUTTON_RETURN                动作按钮（上一张）
                 ShapeConstants.SHAPE_ACTION_BUTTON_DOCUMENT              动作按钮（文档）
                 ShapeConstants.SHAPE_ACTION_BUTTON_SOUND                 动作按钮（影片）
                 ShapeConstants.SHAPE_ACTION_BUTTON_MOVIE                 动作按钮（电影）

    `startX` - 左上角的x坐标
    `startY` - 左上角的y坐标
    `endX` - 右下角的x坐标
    `endY` - 右下角的y坐标
  返回：
    自选图形对象

    例子：

         //在当前应用中添加一云形标注。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addShape(ShapeConstants.SHAPE_CLOUD_CALLOUT, 120, 130, 220, 250);

  抛出：
    `MacroRunException` - 当无法插入自选图形时
  另请参见：
    `ShapeConstants`

### addTextBox

    public Shape addTextBox(int director,
                            double startX,
                            double startY,
                            double endX,
                            double endY)

  添加一个文本框。

  参数：
    `director` - 文本框内文字的方向， 0--正常, 1--正常竖排, 2--270度竖排, 3--90度旋转, 4--270度旋转
    `startX` - 左上角的x坐标
    `startY` - 左上角的y坐标
    `endX` - 右下角的x坐标
    `endY` - 右下角的y坐标

    例子：

  返回：
    返回自选图形对象

         //在当前应用总添加一270度竖排的文本框。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addTextBox(2, 120, 180, 380, 380);

  抛出：
    `MacroRunException` - 当不能插入文本框时。

### addWordArt

    public Shape addWordArt(int wordArtStyle,
                            java.lang.String text,
                            java.lang.String fontName,
                            int fontType,
                            int fontSize,
                            double startX,
                            double startY,
                            double endX,
                            double endY)

  添加艺术字。

  参数：
    `wordArtStyle` - 艺术字的类型

                 WordArtConstants.TEXT_EFFECT_1        第一种艺术字
                 WordArtConstants.TEXT_EFFECT_2        第二种艺术字
                 WordArtConstants.TEXT_EFFECT_3        第三种艺术字
                 WordArtConstants.TEXT_EFFECT_4        第四种艺术字
                 ......
                 WordArtConstants.TEXT_EFFECT_30       第三十种艺术

    `text` - 艺术字要显示的文本，如"evermore"
    `fontName` - 字体的名称
    `fontType` - 字体的类型
    `fontSize` - 字体的大小
    `startX` - 艺术字左上角的x坐标
    `startY` - 艺术字左上角的y坐标
    `endX` - 艺术字右下角的x坐标
    `endY`` - 艺术字右下角的y坐标
  返回：
    返回自选图形对象，当字体类型不在所支持的这30种时返回null。

    例子：

         //在当前应用中添加一文本为"evermore"的艺术字。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addWordArt(2, "evermore", "宋体", 1, 12, 250, 180, 400, 320);

  抛出：
    `MacroRunException` - 无法插入时，或者显示文本或字体名称为空。
  另请参见：
    `WordArtConstants`

### getAllShapes

    public abstract Shape[] getAllShapes()

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

  插入的自选图形的先后决定了自选图形在数组中的位置。先插入的数组坐标靠前。 如先插入矩形后插入椭圆再插入平行四边形，则矩形在数组中坐标为0，椭圆为1，平行四边形为2。 在简报制作中因为在幻灯片中已经有了占位符自选图形，所以新插入自选图形坐标不从０开始。

  返回：
    自选图形数组

    例子：

         //在当前应用新添加三个自选图形，然后在控制台输出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()`

### getRange

    public abstract application.workbooks.workbook.shapes.ShapeRange getRange()

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

  返回：
    被选中的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();
         ShapeRange shaperange = shapes.getRange() ;
         shaperange.setHeight(500);

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

### getShape

    public abstract Shape getShape(java.lang.String shapeName)

  根据名字获取图形对象。

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

  参数：
    `shapeName` - 图形对象的名字，如"矩形 1"
  返回：
    Shape图形对象

    例子：

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

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

### getShapes

    public abstract Shape[] getShapes(java.lang.String name)

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

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

  参数：
    `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)`

### insertFraction

    public Shape insertFraction()

  插入数学分式

  返回：
    返回自选图形对象

    例子：

         //在当前应用中插入数学分式。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.insertFraction();

### isLineDrawing

    public boolean isLineDrawing()

  判断当前状态是否在画曲线。

  例子:

       //在当前应用输出是否在画曲线。
       Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
       boolean drawing = shapes.isLineDrawing();
       System.out.println(drawing);

### isSelectAll

    public boolean isSelectAll()

  判断是否选中所有图形对象。

  返回：
    boolean型 如为true 表示当前对象全部选中，如为false 表示当前对象没有全部选中

    例子：

         在控制台输出是否已经选中所有图形对象。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         System.out.println(shapes.isSelectAll());

  另请参见：
    `selectAll()`, `unSelect()`, `selectRange(String[])`

### selectAll

    public void selectAll()

  选中所有图形对象。

  例子：

       //选中当前所有图形对象。
       Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
       shapes.selectAll();

  另请参见：
    `isSelectAll()`, `unSelect()`, `selectRange(String[])`

### selectRange

    public void selectRange(java.lang.String[] objectNames)

  选中自选图形，文本框或艺术字等图形对象。

  参数：
    `objectNames` - 图形对象的名字数组。

    例子：

         //在当前应用中添加一艺术字一箭头，然后通过selectRange(String[])的方法来选中这两个图形对象。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addWordArt(2, "evermore", "宋体";, 1, 12, 250, 180, 400, 320);
         shapes.addLine(1, 200, 100, 290, 280);
         String[] obj = {"艺术字 1","直线 2"} ;
         shapes.selectRange(obj) ;

  另请参见：
    `selectAll()`, `unSelect()`, `isSelectAll()`

### size

    public int size()

  获得当前应用自选图形的数量。

  返回：
    当前应用自选图形的数量

    例子：

         //在当前应用中添加一艺术字一箭头，然后通过selectRange(String[])的方法来选中这两个图形对象。
         Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
         shapes.addShape(1,200,200,400,400);
         shapes.addWordArt(2, "evermore", "宋体";, 1, 12, 250, 180, 400, 320);
         shapes.addLine(1, 200, 100, 290, 280);
         System.out.println(shapes.size());

### unSelect

    public void unSelect()

  没有图形对象被选中。

  例子：

       //在当前应用中添加一艺术字一箭头，取消选中所有图形对象。
       Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
       shapes.addWordArt(2, "evermore", "宋体";, 1, 12, 250, 180, 400, 320);
       shapes.addLine(1, 200, 100, 290, 280);
       shapes.unSelect();

  另请参见：
    `selectAll()`, `isSelectAll()`, `selectRange(String[])`

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

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

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