wpshapes.html

永中OFFICE二次开发帮助文档

         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                 动作按钮（电影）
 </pre><DD><CODE>startX</CODE> - 左上角的x坐标<DD><CODE>startY</CODE> - 左上角的y坐标<DD><CODE>endX</CODE> - 右下角的x坐标<DD><CODE>endY</CODE> - 右下角的y坐标
<DT><B>返回：</B><DD>自选图形对象
 <p>
 <b>例子：</b>
 <pre>
 //在指定文本范围处添加一云形标注。
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 WpShapes shapes = doc.getShapes();
 TextRange anchor = doc.getSelectionRange();
 shapes.addShape(anchor, ShapeConstants.SHAPE_CLOUD_CALLOUT, 120, 130, 220, 250);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当参数为空
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当无法插入自选图形时<DT><B>另请参见：</B><DD><A HREF="../../../../../application/constants/ShapeConstants.html" title="application.constants 中的接口"><CODE>ShapeConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="addTextBox(application.workbooks.workbook.documents.document.TextRange, int, double, double, double, double)"><!-- --></A><H3>
addTextBox</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/shapes/Shape.html" title="application.workbooks.workbook.shapes 中的类">Shape</A> <B>addTextBox</B>(<A HREF="../../../../../application/workbooks/workbook/documents/document/TextRange.html" title="application.workbooks.workbook.documents.document 中的类">TextRange</A>&nbsp;anchor,
                        int&nbsp;director,
                        double&nbsp;startX,
                        double&nbsp;startY,
                        double&nbsp;endX,
                        double&nbsp;endY)</PRE>
<DL>
<DD>添加一个文本框到文档指定位置。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>anchor</CODE> - 指定添加文本框的锚点位置，是一个TextRange对象。文本框的锚点位置指向这个文本范围的开头所在段落的起始位置。<DD><CODE>director</CODE> - 文本框内文字的方向， 0--正常, 1--正常竖排, 2--270度竖排, 3--90度旋转, 4--270度旋转<DD><CODE>startX</CODE> - 左上角的x坐标<DD><CODE>startY</CODE> - 左上角的y坐标<DD><CODE>endX</CODE> - 右下角的x坐标<DD><CODE>endY</CODE> - 右下角的y坐标
 <p>
 <b>例子：</b>
<DT><B>返回：</B><DD>返回自选图形对象
 <pre>
 //在当前应用总添加一270度竖排的文本框。
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 WpShapes shapes = doc.getShapes();
 TextRange anchor = doc.getSelectionRange();
 shapes.addTextBox(anchor, 2, 120, 180, 380, 380);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当参数为空
<DD><CODE><A HREF="../../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当不能插入文本框时。</DL>
</DD>
</DL>
<HR>

<A NAME="getAllDocFields()"><!-- --></A><H3>
getAllDocFields</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/shapes/DocField.html" title="application.workbooks.workbook.shapes 中的类">DocField</A>[] <B>getAllDocFields</B>()</PRE>
<DL>
<DD>返回文字处理中全部公文域对象。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html" title="application.workbooks.workbook 中的类">Shapes</A></CODE> 中的 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html#getAllDocFields()">getAllDocFields</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>公文域对象数组
 <p>
 <b>例子:</b>
 <pre>
 //在当前文字处理中插入三个公文域，然后得到全部公文域数组并在控制台上输出此数组的长度。
 Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
 shapes.addDocField("公文域测试1", 120, 180, 380, 380);
 shapes.addDocField("公文域测试2", 320, 380, 580, 580);
 shapes.addDocField("公文域测试3", 420, 480, 680, 680);
 DocField[] fields = shapes.getAllDocFields();
 System.out.println(fields.length);
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/documents/document/WpShapes.html#getDocField(java.lang.String)"><CODE>getDocField(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/documents/document/WpShapes.html#getDocFieldRange()"><CODE>getDocFieldRange()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getAllShapes()"><!-- --></A><H3>
getAllShapes</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/documents/document/wpshapes/WpShape.html" title="application.workbooks.workbook.documents.document.wpshapes 中的类">WpShape</A>[] <B>getAllShapes</B>()</PRE>
<DL>
<DD>获得文字处理中的所有自选图形数组。
<p>
插入的自选图形的先后决定了自选图形在数组中的位置。先插入的数组坐标靠前。
如先插入矩形后插入椭圆再插入平行四边形，则矩形在数组中坐标为0，椭圆为1，平行四边形为2。
<p>
<P>
<DD><DL>
<DT><B>指定者：</B><DD>类 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html" title="application.workbooks.workbook 中的类">Shapes</A></CODE> 中的 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html#getAllShapes()">getAllShapes</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>自选图形数组
<p>
<b>例子：</b>
<pre>
 //在文字处理新添加三个自选图形，然后在控制台输出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);
</pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/Shapes.html#getShapes(java.lang.String)"><CODE>Shapes.getShapes(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/Shapes.html#getShape(java.lang.String)"><CODE>Shapes.getShape(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/Shapes.html#getRange()"><CODE>Shapes.getRange()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getDocField(java.lang.String)"><!-- --></A><H3>
getDocField</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/shapes/DocField.html" title="application.workbooks.workbook.shapes 中的类">DocField</A> <B>getDocField</B>(java.lang.String&nbsp;docFieldName)</PRE>
<DL>
<DD>根据名字获取公文域对象。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html" title="application.workbooks.workbook 中的类">Shapes</A></CODE> 中的 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html#getDocField(java.lang.String)">getDocField</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>docFieldName</CODE> - 公文域对象的名字
<DT><B>返回：</B><DD>公文域对象
<p>
<b>例子：</b>
<pre>
 //在当前文字处理中插入一文本为"公文域测试"的公文域，然后通过名字得到此公文域并设置文本为"发送机关"。
 Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
 shapes.addDocField("公文域测试", 120, 180, 380, 380);
 DocField docField = shapes.getDocField("公文域1");
 docField.setText("发文机关");
</pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/documents/document/WpShapes.html#getAllDocFields()"><CODE>getAllDocFields()</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/documents/document/WpShapes.html#getDocFieldRange()"><CODE>getDocFieldRange()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getDocFieldRange()"><!-- --></A><H3>
getDocFieldRange</H3>
<PRE>
public application.workbooks.workbook.shapes.DocFieldRange <B>getDocFieldRange</B>()</PRE>
<DL>
<DD>获得被选中的公文域对象。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html" title="application.workbooks.workbook 中的类">Shapes</A></CODE> 中的 <CODE><A HREF="../../../../../application/workbooks/workbook/Shapes.html#getDocFieldRange()">getDocFieldRange</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>DocFieldRange对象
<p>
<b>例子：</b>