rows.html

永中OFFICE二次开发帮助文档

</TABLE>
&nbsp;
<P>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>

<A NAME="addRow(application.workbooks.workbook.tables.Row, int)"><!-- --></A><H3>
addRow</H3>
<PRE>
public <A HREF="../../../../application/workbooks/workbook/tables/Row.html" title="application.workbooks.workbook.tables 中的类">Row</A> <B>addRow</B>(<A HREF="../../../../application/workbooks/workbook/tables/Row.html" title="application.workbooks.workbook.tables 中的类">Row</A>&nbsp;beforeRow,
                  int&nbsp;direction)</PRE>
<DL>
<DD>在指定行的上方或下方插入一行。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>beforeRow</CODE> - 指定的行对象<DD><CODE>direction</CODE> - 插入行的方向，只能取以下整型值之一：
 <pre>
 TableConstants.INSERT_ROW_ABOVE   在指定区域的上方插入行
 TableConstants.INSERT_ROW_BELLOW  在指定区域的下方插入行 
 </pre>
<DT><B>返回：</B><DD>新插入的表格行对象
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows();
 Row beforeRow = rows.getRow(3);
 Row row = rows.addRow(beforeRow, TableConstants.INSERT_ROW_ABOVE);
 row.select();
 </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="averageRowHeight()"><!-- --></A><H3>
averageRowHeight</H3>
<PRE>
public void <B>averageRowHeight</B>()</PRE>
<DL>
<DD>平均分配表格行集合内所有行的行高。
 说明：平均分配后，集合内每个表格行的行高相等并等于其平均值。
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
 rows.averageRowHeight();
 </pre>
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="delete()"><!-- --></A><H3>
delete</H3>
<PRE>
public void <B>delete</B>()</PRE>
<DL>
<DD>删除当前指定表格行的集合。
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows(2,3);
 rows.delete();
 </pre>
<P>
<DD><DL>
<DT><B>另请参见：</B><DD><A HREF="../../../../application/workbooks/workbook/tables/Rows.html#removeRow(int)"><CODE>removeRow(int);</CODE></A>, 
<A HREF="../../../../application/workbooks/workbook/tables/Row.html#delete()"><CODE>Row.delete()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getBorderAttribute()"><!-- --></A><H3>
getBorderAttribute</H3>
<PRE>
public <A HREF="../../../../application/workbooks/workbook/style/border/BorderAttribute.html" title="application.workbooks.workbook.style.border 中的类">BorderAttribute</A> <B>getBorderAttribute</B>()</PRE>
<DL>
<DD>得到表格行集合外边框的边框属性。
<P>
<DD><DL>

<DT><B>返回：</B><DD>外边框属性
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
 BorderAttribute borderAttribute = rows.getBorderAttribute();
 System.out.println("返回表格行集合外边框的类型为:"+ borderAttribute.getBorderType());
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../application/workbooks/workbook/tables/Rows.html#setBorderAttribute(application.workbooks.workbook.style.border.BorderAttribute)"><CODE>setBorderAttribute(BorderAttribute)</CODE></A></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>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows();
 System.out.println("表格共有" + rows.getCount() + "行");
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="getRow(int)"><!-- --></A><H3>
getRow</H3>
<PRE>
public <A HREF="../../../../application/workbooks/workbook/tables/Row.html" title="application.workbooks.workbook.tables 中的类">Row</A> <B>getRow</B>(int&nbsp;index)</PRE>
<DL>
<DD>得到指定的表格行。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 指定表格行的索引
 说明：这个索引值是指当前连续行集合中的位置，而不是在整个表格中的行号。
<DT><B>返回：</B><DD>指定的表格行对象
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows();
 Row row = rows.getRow(2);
 row.select();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当指定的行中包含有纵向合并单元格</DL>
</DD>
</DL>
<HR>

<A NAME="getShadingAttribute()"><!-- --></A><H3>
getShadingAttribute</H3>
<PRE>
public <A HREF="../../../../application/workbooks/workbook/style/border/ShadingAttribute.html" title="application.workbooks.workbook.style.border 中的类">ShadingAttribute</A> <B>getShadingAttribute</B>()</PRE>
<DL>
<DD>得到表格行集合的底纹属性。
<P>
<DD><DL>

<DT><B>返回：</B><DD>行集合的底纹属性
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
 ShadingAttribute shadingAttribute = rows.getShadingAttribute();
 System.out.println("返回行集合的底纹图案索引:"+ shadingAttribute.getTextureIndex());
 </pre><DT><B>另请参见：</B><DD><A HREF="../../../../application/workbooks/workbook/tables/Rows.html#setShadingAttribute(application.workbooks.workbook.style.border.ShadingAttribute)"><CODE>setShadingAttribute(ShadingAttribute)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="nextRow()"><!-- --></A><H3>
nextRow</H3>
<PRE>
public <A HREF="../../../../application/workbooks/workbook/tables/Row.html" title="application.workbooks.workbook.tables 中的类">Row</A> <B>nextRow</B>()</PRE>
<DL>
<DD>得到当前表格行集合的下一个行对象。
<P>
<DD><DL>

<DT><B>返回：</B><DD>下一行对象
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
 Row row = rows.nextRow();
 row.select();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当返回的下一行对象中含有纵向合并的单元格<DT><B>另请参见：</B><DD><A HREF="../../../../application/workbooks/workbook/tables/Rows.html#previousRow()"><CODE>previousRow()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="previousRow()"><!-- --></A><H3>
previousRow</H3>
<PRE>
public <A HREF="../../../../application/workbooks/workbook/tables/Row.html" title="application.workbooks.workbook.tables 中的类">Row</A> <B>previousRow</B>()</PRE>
<DL>
<DD>得到当前表格行集合的上一个行对象。
<P>
<DD><DL>

<DT><B>返回：</B><DD>上一行对象
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();
 TextRange range = doc.getRange(0);
 Tables tables = doc.getTables();
 Table table = tables.addTable(range, 5, 5);
 application.workbooks.workbook.tables.Rows rows = table.getRows(2, 3);
 Row row = rows.previousRow();
 row.select();
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当返回的上一行对象中含有纵向合并的单元格<DT><B>另请参见：</B><DD><A HREF="../../../../application/workbooks/workbook/tables/Rows.html#nextRow()"><CODE>nextRow()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="removeRow(int)"><!-- --></A><H3>
removeRow</H3>
<PRE>
public void <B>removeRow</B>(int&nbsp;index)</PRE>
<DL>
<DD>删除指定的表格行。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>index</CODE> - 指定表格行的索引
 说明：这个索引值是指当前连续行集合中的位置，而不是在整个表格中的行号。
 <p>
 <b>例子：</b>
 <pre>
 Document doc = Application.getWorkbooks().getActiveWorkbook().getDocuments().getActiveDocument();