ssshapes.html

永中OFFICE二次开发帮助文档

 <p>
 <b>例子：</b>
 <pre>
 //先在电子表格中添加两个自选图形，再通过getActiveShape()方法获取当前自选图形，然后设置此自选图形高度为500。
 Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes() ;
 shapes.addShape(1,200,200,400,400);
 shapes.addShape(2,500,500,600,600);
 SsShape shape = shapes.getActiveShape();
 shape.setHeight(500);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getAllShapes()"><!-- --></A><H3>
getAllShapes</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/ssshapes/SsShape.html" title="application.workbooks.workbook.worksheets.worksheet.ssshapes 中的类">SsShape</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/worksheets/worksheet/SsShapes.html#getShapes(java.lang.String)"><CODE>getShapes(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getShape(java.lang.String)"><CODE>getShape(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getRange()"><CODE>getRange()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getRange()"><!-- --></A><H3>
getRange</H3>
<PRE>
public application.workbooks.workbook.worksheets.worksheet.ssshapes.SsShapeRange <B>getRange</B>()</PRE>
<DL>
<DD>获得被选中的自选图形，文本框或艺术字(ShapeRange)。
 <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#getRange()">getRange</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>返回：</B><DD>被选中的ShapeRange图形对象，当没有选中的自选图形的时候返回null。
 <p>
 <b>例子：</b>
 <pre>
 //在电子表格插入一矩形和一平行四边形，全选自选图形，通过ShapeRange对象来设置所选中的两个图形的高度为500。
 Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
 shapes.addShape(1,200,200,400,400);
 shapes.addShape(2,500,500,600,600);
 shapes.selectAll();
 SsShapeRange shaperange = shapes.getRange() ;
 shaperange.setHeight(500);
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getShapes(java.lang.String)"><CODE>getShapes(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getShape(java.lang.String)"><CODE>getShape(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getAllShapes()"><CODE>getAllShapes()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getShape(java.lang.String)"><!-- --></A><H3>
getShape</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/ssshapes/SsShape.html" title="application.workbooks.workbook.worksheets.worksheet.ssshapes 中的类">SsShape</A> <B>getShape</B>(java.lang.String&nbsp;shapeName)</PRE>
<DL>
<DD>根据名字获取图形对象。
 <p>
 对于图形对象的名称，是由其类型加上ID。如"矩形 1"，"椭圆 2"每个图形插入到应用后ID就固定下来，
 即使被删除，其后添加的图形ID也不能覆盖被删除的图形ID。
 <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#getShape(java.lang.String)">getShape</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>shapeName</CODE> - 图形对象的名字，如"矩形 1"
<DT><B>返回：</B><DD>Shape图形对象
 <p>
 <b>例子：</b>
 <pre>
 //在电子表格插入一矩形，通过名称获取这个矩形，并在控制台打印出这矩形的高度。
 Shapes shapes = Application.getWorkbooks().getActiveWorkbook().getActiveShapes();
 shapes.addShape(1,200,200,400,400);
 Shape shape = shapes.getShape("矩形 1");
 System.out.println(shape.getHeight());
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getShapes(java.lang.String)"><CODE>getShapes(String)</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getRange()"><CODE>getRange()</CODE></A>, 
<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getAllShapes()"><CODE>getAllShapes()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getShapes(java.lang.String)"><!-- --></A><H3>
getShapes</H3>
<PRE>
public <A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/ssshapes/SsShape.html" title="application.workbooks.workbook.worksheets.worksheet.ssshapes 中的类">SsShape</A>[] <B>getShapes</B>(java.lang.String&nbsp;name)</PRE>
<DL>
<DD>根据名称返回自选图形数组。
 <p>
 名称不包括ID数字。如电子表格中有"矩形 1"，"文本框 20"，"矩形 3"。通过getShapes("矩形")
 方法能够返回包含"矩形 1"，"矩形 3"的Shape数组。
 <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#getShapes(java.lang.String)">getShapes</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 自选图形名称 如 "矩形" "同心圆"等
<DT><B>返回：</B><DD>自选图形数组，当不存在时返回长度为0的数组。
 <p>
 <b>例子：</b>
 <pre>
 //在电子表格添加三个自选图形，然后在控制台上输出电子表格矩形的个数。
 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);
 </pre><DT><B>从以下版本开始：</B></DT>
  <DD>1.32</DD>
<DT><B>另请参见：</B><DD><A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsShapes.html#getShape(java.lang.String)"><CODE>getShape(String)</CODE></A></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  <TR ALIGN="center" VALIGN="top">
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>类</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/SsPictureFormat.html" title="application.workbooks.workbook.worksheets.worksheet 中的类"><B>上一个类</B></A>&nbsp;
&nbsp;<A HREF="../../../../../application/workbooks/workbook/worksheets/worksheet/TextSplittingProperties.html" title="application.workbooks.workbook.worksheets.worksheet 中的类"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../../index.html?application/workbooks/workbook/worksheets/worksheet/SsShapes.html" target="_top"><B>框架</B></A>  &nbsp;
&nbsp;<A HREF="SsShapes.html" target="_top"><B>无框架</B></A>  &nbsp;
&nbsp;<SCRIPT type="text/javascript">
  <!--
  if(window==top) {
    document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>所有类</B></A>');
  }
  //-->
</SCRIPT>
<NOSCRIPT>
  <A HREF="../../../../../allclasses-noframe.html"><B>所有类</B></A>
</NOSCRIPT>


</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
  摘要：&nbsp;嵌套&nbsp;|&nbsp;字段&nbsp;|&nbsp;构造方法&nbsp;|&nbsp;<A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息：&nbsp;字段&nbsp;|&nbsp;构造方法&nbsp;|&nbsp;<A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
版权所有 2001-2006 无锡永中科技有限公司
</BODY>
</HTML>