worksheets.html

永中OFFICE二次开发帮助文档

<P>
<DD><DL>

<DT><B>返回：</B><DD>工作表实例的数组
 <p>
 <b>例子：</b>
 <pre>     
  //获得集成文件中所有工作表
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 Worksheet[] wss = worksheets.getAllWorksheets();
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getCount()"><!-- --></A><H3>
getCount</H3>
<PRE>
public int <B>getCount</B>()</PRE>
<DL>
<DD>获得工作表的数目。
<P>
<DD><DL>

<DT><B>返回：</B><DD>工作表的数目
 <p>
 <b>例子：</b>
 <pre>
  //获得当前集成文件中工作表的数目
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 int size = worksheets.getCount();
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getNames()"><!-- --></A><H3>
getNames</H3>
<PRE>
public <A HREF="../../../application/workbooks/workbook/worksheets/Names.html" title="application.workbooks.workbook.worksheets 中的类">Names</A> <B>getNames</B>()</PRE>
<DL>
<DD>获得名称管理器。
<P>
<DD><DL>

<DT><B>返回：</B><DD>名称管理器
 <p>
 <b>例子：</b>
 <pre>
  //获得名称管理器
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 Names names = worksheets.getNames();
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getParent()"><!-- --></A><H3>
getParent</H3>
<PRE>
public <A HREF="../../../application/workbooks/Workbook.html" title="application.workbooks 中的类">Workbook</A> <B>getParent</B>()</PRE>
<DL>
<DD>获得集成文件对象。
<P>
<DD><DL>

<DT><B>返回：</B><DD>集成文件对象
 <p>
 <b>例子：</b>
 <pre>
  //获得集成文件对象
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 Workbook workbook = worksheets.getParent();
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getSelectedCount()"><!-- --></A><H3>
getSelectedCount</H3>
<PRE>
public int <B>getSelectedCount</B>()</PRE>
<DL>
<DD>获得选中工作表个数。
<P>
<DD><DL>

<DT><B>返回：</B><DD>所有选中工作表个数
 <p>
 <b>例子：</b>
 <pre>
  //在当前工作簿选中"工作表1","工作表2","工作表3",打印选中工作表的个数。
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 worksheets.selectWorksheets(new String[]{"工作表1","工作表2","工作表3"});
 System.out.print(worksheets.getSelectedCount());
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getSelectedWorksheets()"><!-- --></A><H3>
getSelectedWorksheets</H3>
<PRE>
public <A HREF="../../../application/workbooks/workbook/worksheets/Worksheet.html" title="application.workbooks.workbook.worksheets 中的类">Worksheet</A>[] <B>getSelectedWorksheets</B>()</PRE>
<DL>
<DD>获得所有选中的工作表。
<P>
<DD><DL>

<DT><B>返回：</B><DD>所有选中的工作表
 <p>
 <b>例子：</b>
 <pre>
  //在当前工作簿选中"工作表1","工作表2","工作表3",打印选中工作表的名称。
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 worksheets.selectWorksheets(new String[]{"工作表1","工作表2","工作表3"});
 Worksheet[] selectedWorksheets = worksheets.getSelectedWorksheets();
 for (int i = 0;i < selectedWorksheets.length;i++)
 {
     System.out.println(selectedWorksheets[i].getName());
 }
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getWorksheet(int)"><!-- --></A><H3>
getWorksheet</H3>
<PRE>
public <A HREF="../../../application/workbooks/workbook/worksheets/Worksheet.html" title="application.workbooks.workbook.worksheets 中的类">Worksheet</A> <B>getWorksheet</B>(int&nbsp;index)</PRE>
<DL>
<DD>通过工作表的索引号取得相应的工作表(索引号从1开始)。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 索引号
<DT><B>返回：</B><DD>工作表
 <p>
 <b>例子：</b>
 <pre>
  //取得当前集成文件中索引号为2的工作表
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 Worksheet worksheet = worksheets.getWorksheet(2);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getWorksheet(java.lang.String)"><!-- --></A><H3>
getWorksheet</H3>
<PRE>
public <A HREF="../../../application/workbooks/workbook/worksheets/Worksheet.html" title="application.workbooks.workbook.worksheets 中的类">Worksheet</A> <B>getWorksheet</B>(java.lang.String&nbsp;name)</PRE>
<DL>
<DD>通过工作表名称取得相应的工作表。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>name</CODE> - 工作表名
<DT><B>返回：</B><DD>工作表
 <p>
 <b>例子：</b>
 <pre>
  //取得当前集成文件中的工作表3
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 Worksheet worksheet = worksheets.getWorksheet("工作表3");
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="insertWorksheet(int)"><!-- --></A><H3>
insertWorksheet</H3>
<PRE>
public <A HREF="../../../application/workbooks/workbook/worksheets/Worksheet.html" title="application.workbooks.workbook.worksheets 中的类">Worksheet</A> <B>insertWorksheet</B>(int&nbsp;index)</PRE>
<DL>
<DD>在指定的工作表前插入新工作表(索引号从1开始)。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 工作表索引
<DT><B>返回：</B><DD>工作表
 <p>
 <b>例子：</b>
 <pre>
  //在当前集成文件的第二个工作表前插入新工作表
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 Worksheet worksheet = worksheets.insertWorksheet(2);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定的工作表索引错误或越界</DL>
</DD>
</DL>
<HR>

<A NAME="insertWorksheet(int, java.lang.String)"><!-- --></A><H3>
insertWorksheet</H3>
<PRE>
public <A HREF="../../../application/workbooks/workbook/worksheets/Worksheet.html" title="application.workbooks.workbook.worksheets 中的类">Worksheet</A> <B>insertWorksheet</B>(int&nbsp;index,
                                 java.lang.String&nbsp;name)</PRE>
<DL>
<DD>在指定的工作表前插入新工作表(索引号从1开始)。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 工作表索引<DD><CODE>name</CODE> - 工作表名称(,注意：名称长度范围在 1 至 31 之间)
<DT><B>返回：</B><DD>工作表
 <p>
 <b>例子：</b>
 <pre>
  //在当前集成文件的第二个工作表前插入名为"qq"的新工作表
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 Worksheet worksheet = worksheets.insertWorksheet(2,"qq");
 </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="isScreenUpdating()"><!-- --></A><H3>
isScreenUpdating</H3>
<PRE>
public boolean <B>isScreenUpdating</B>()</PRE>
<DL>
<DD>返回是否要屏幕刷新。
<P>
<DD><DL>

<DT><B>返回：</B><DD>TRUE 表示开启屏幕刷新，FALSE 表示关闭屏幕刷新
 <p>
 <b>例子：</b>
 <pre>
  //关闭工作表屏幕刷新
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 worksheets.setScreenUpdating(false);
 boolean flag = worksheets.isScreenUpdating();
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="moveWorksheets(java.lang.String[], java.lang.String)"><!-- --></A><H3>
moveWorksheets</H3>
<PRE>
public void <B>moveWorksheets</B>(java.lang.String[]&nbsp;worksheetNames,
                           java.lang.String&nbsp;worksheetName)</PRE>
<DL>
<DD>将指定的工作表移动到本集成文件的其他工作表之前。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>worksheetNames</CODE> - 指定的工作表<DD><CODE>worksheetName</CODE> - 集成文件中的一个工作表名，被移动的工作表就放置在此工作表之前
 <p>
 (注：若worksheetName为NULL,表示工作表移动到末尾)
 <p>
 <b>例子：</b>
 <pre>
  //在当前集成文件中将名为"工作表2"的工作表移动到名为"工作表1"的工作表之前
 Worksheets worksheets = Application.getWorkbooks()
                          .getActiveWorkbook().getWorksheets();
 worksheets.moveWorksheets(new String[]{"工作表2"},"工作表1");
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定的工作表不存在</DL>
</DD>
</DL>
<HR>

<A NAME="moveWorksheets(java.lang.String[], java.lang.String, java.lang.String)"><!-- --></A><H3>
moveWorksheets</H3>
<PRE>
public void <B>moveWorksheets</B>(java.lang.String[]&nbsp;worksheetNames,
                           java.lang.String&nbsp;bookName,
                           java.lang.String&nbsp;worksheetName)</PRE>
<DL>
<DD>将集成文件中指定的工作表移动到一个指定的目标集成文件中。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>worksheetNames</CODE> - 指定的工作表<DD><CODE>bookName</CODE> - 目标集成文件的名称<DD><CODE>worksheetName</CODE> - 目标集成文件中的一个工作表名，被移动的工作表就放置在此工作表之前
 (注：若bookName为NULL时表示在本集成文件中移动,若worksheetName为NULL,表示工作表移动到末尾,
 而且目标集成文件必须已打开)
 <p>
 <b>例子：</b>