sspagesetup.html

永中OFFICE二次开发帮助文档

<A HREF="../../../../application/util/Utilities.html" title="application.util 中的类"><CODE>Utilities</CODE></A>, 
<A HREF="../../../../application/constants/UnitConstants.html" title="application.constants 中的接口"><CODE>UnitConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPageLeftMargin(double, int)"><!-- --></A><H3>
setPageLeftMargin</H3>
<PRE>
public void <B>setPageLeftMargin</B>(double&nbsp;pageLeftMargin,
                              int&nbsp;unitType)</PRE>
<DL>
<DD>设置左边距。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPageLeftMargin</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pageLeftMargin</CODE> - 左边距,double型,其取值范围介于0磅至1584磅之间<DD><CODE>unitType</CODE> - 度量单位，其取值为如下类型：
 <p>
 <pre>
 UnitConstants.INCH -- 英寸
 UnitConstants.CENTIMETER -- 厘米
 UnitConstants.MILLIMETER -- 毫米
 UnitConstants.POINT -- 磅
 UnitConstants.PICA -- 十二点活字
 </pre>
 <p>
 <b>例子:</b>
 <pre>
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setOrientation(PrintConstants.HORIZONTAL);
 pageSetup.setPaper("A5");
 pageSetup.setPageWidth(21.0,UnitConstants.CENTIMETER);
 pageSetup.setPageHeight(14.8,UnitConstants.CENTIMETER);
 pageSetup.setPageTopMargin(3.2,UnitConstants.CENTIMETER);
 pageSetup.setPageBottomMargin(3.0,UnitConstants.CENTIMETER);
 pageSetup.setPageLeftMargin(2.5,UnitConstants.CENTIMETER);
 pageSetup.setPageRightMargin(2.0,UnitConstants.CENTIMETER);
 pageSetup.setGutter(0.2,UnitConstants.CENTIMETER,PrintConstants.GUTTER_LEFT);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定参数的数值错误或越界<DT><B>另请参见：</B><DD><CODE>PageSetup.setPageLeftMargin(double)</CODE>, 
<A HREF="../../../../application/util/Utilities.html" title="application.util 中的类"><CODE>Utilities</CODE></A>, 
<A HREF="../../../../application/constants/UnitConstants.html" title="application.constants 中的接口"><CODE>UnitConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPageRightMargin(double, int)"><!-- --></A><H3>
setPageRightMargin</H3>
<PRE>
public void <B>setPageRightMargin</B>(double&nbsp;pageRightMargin,
                               int&nbsp;unitType)</PRE>
<DL>
<DD>设置右边距。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPageRightMargin</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pageRightMargin</CODE> - 右边距,double型,其取值范围介于0磅至1584磅之间<DD><CODE>unitType</CODE> - 度量单位，其取值为如下类型：
 <p>
 <pre>
 UnitConstants.INCH -- 英寸
 UnitConstants.CENTIMETER -- 厘米
 UnitConstants.MILLIMETER -- 毫米
 UnitConstants.POINT -- 磅
 UnitConstants.PICA -- 十二点活字
 </pre>
 <p>
 <b>例子:</b>
 <pre>
  //设置右边距为2.0厘米。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setOrientation(PrintConstants.HORIZONTAL);
 pageSetup.setPaper("A5");
 pageSetup.setPageWidth(21.0,UnitConstants.CENTIMETER);
 pageSetup.setPageHeight(14.8,UnitConstants.CENTIMETER);
 pageSetup.setPageTopMargin(3.2,UnitConstants.CENTIMETER);
 pageSetup.setPageBottomMargin(3.0,UnitConstants.CENTIMETER);
 pageSetup.setPageLeftMargin(2.5,UnitConstants.CENTIMETER);
 pageSetup.setPageRightMargin(2.0,UnitConstants.CENTIMETER);
 pageSetup.setGutter(0.2,UnitConstants.CENTIMETER,PrintConstants.GUTTER_LEFT);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定参数的数值错误或越界<DT><B>另请参见：</B><DD><CODE>PageSetup.setPageRightMargin(double)</CODE>, 
<A HREF="../../../../application/util/Utilities.html" title="application.util 中的类"><CODE>Utilities</CODE></A>, 
<A HREF="../../../../application/constants/UnitConstants.html" title="application.constants 中的接口"><CODE>UnitConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPageTopMargin(double, int)"><!-- --></A><H3>
setPageTopMargin</H3>
<PRE>
public void <B>setPageTopMargin</B>(double&nbsp;pageTopMargin,
                             int&nbsp;unitType)</PRE>
<DL>
<DD>设置上边距。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPageTopMargin</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pageTopMargin</CODE> - 上边距,double型,其取值范围介于0磅至1584磅之间<DD><CODE>unitType</CODE> - 度量单位，其取值为如下类型：
 <p>
 <pre>
 UnitConstants.INCH -- 英寸
 UnitConstants.CENTIMETER -- 厘米
 UnitConstants.MILLIMETER -- 毫米
 UnitConstants.POINT -- 磅
 UnitConstants.PICA -- 十二点活字
 </pre>
 <p>
 <b>例子:</b>
 <pre>
  //设置上边距为3.2厘米
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setOrientation(PrintConstants.HORIZONTAL);
 pageSetup.setPaper("A5");
 pageSetup.setPageWidth(21.0,UnitConstants.CENTIMETER);
 pageSetup.setPageHeight(14.8,UnitConstants.CENTIMETER);
 pageSetup.setPageTopMargin(3.2,UnitConstants.CENTIMETER);
 pageSetup.setPageBottomMargin(3.0,UnitConstants.CENTIMETER);
 pageSetup.setPageLeftMargin(2.5,UnitConstants.CENTIMETER);
 pageSetup.setPageRightMargin(2.0,UnitConstants.CENTIMETER);
 pageSetup.setGutter(0.2,UnitConstants.CENTIMETER,PrintConstants.GUTTER_LEFT);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定参数的数值错误或越界<DT><B>另请参见：</B><DD><CODE>PageSetup.setPageTopMargin(double)</CODE>, 
<A HREF="../../../../application/util/Utilities.html" title="application.util 中的类"><CODE>Utilities</CODE></A>, 
<A HREF="../../../../application/constants/UnitConstants.html" title="application.constants 中的接口"><CODE>UnitConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPageWidth(double, int)"><!-- --></A><H3>
setPageWidth</H3>
<PRE>
public void <B>setPageWidth</B>(double&nbsp;pageWidth,
                         int&nbsp;unitType)</PRE>
<DL>
<DD>设置页面宽度。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPageWidth</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pageWidth</CODE> - 页面宽度,double型,其取值范围介于7.2磅至1584磅之间<DD><CODE>unitType</CODE> - 度量单位，其取值为如下类型：
 <p>
 <pre>
 UnitConstants.INCH -- 英寸
 UnitConstants.CENTIMETER -- 厘米
 UnitConstants.MILLIMETER -- 毫米
 UnitConstants.POINT -- 磅
 UnitConstants.PICA -- 十二点活字
 </pre>
 <p>
 <b>例子:</b>
 <pre>
  //设置页面宽度为21.0厘米。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setOrientation(PrintConstants.HORIZONTAL);
 pageSetup.setPaper("A5");
 pageSetup.setPageWidth(21.0,UnitConstants.CENTIMETER);
 pageSetup.setPageHeight(14.8,UnitConstants.CENTIMETER);
 pageSetup.setPageTopMargin(3.2,UnitConstants.CENTIMETER);
 pageSetup.setPageBottomMargin(3.0,UnitConstants.CENTIMETER);
 pageSetup.setPageLeftMargin(2.5,UnitConstants.CENTIMETER);
 pageSetup.setPageRightMargin(2.0,UnitConstants.CENTIMETER);
 pageSetup.setGutter(0.2,UnitConstants.CENTIMETER,PrintConstants.GUTTER_LEFT);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定参数的数值错误或越界<DT><B>另请参见：</B><DD><CODE>PageSetup.setPageWidth(double)</CODE>, 
<A HREF="../../../../application/util/Utilities.html" title="application.util 中的类"><CODE>Utilities</CODE></A>, 
<A HREF="../../../../application/constants/UnitConstants.html" title="application.constants 中的接口"><CODE>UnitConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPrintArea(java.lang.String)"><!-- --></A><H3>
setPrintArea</H3>
<PRE>
public void <B>setPrintArea</B>(java.lang.String&nbsp;printRange)</PRE>
<DL>
<DD>设置打印区域。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPrintArea</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>printRange</CODE> - 当前的打印区域
 <p>
 <b>例子:</b>
 <pre>
 //设置打印区域为B4:F13。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setPrintArea("$B$4:$F$13");
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setPrintCommentStyle(int)"><!-- --></A><H3>
setPrintCommentStyle</H3>
<PRE>
public void <B>setPrintCommentStyle</B>(int&nbsp;type)</PRE>
<DL>
<DD>设置打印注释的类型。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPrintCommentStyle</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>type</CODE> - 打印注释类型 (见PrintConstants),其取值为如下常量:
 <pre>
 PRINT_COMMENT_NONE--0 表示不打印注释，
 PRINT_COMMENT_FOOTER--1 表示在工作表末尾， 
 PRINT_COMMENT_SAME--2 表示如同工作表显示。
 </pre>
 <p>
 <b>例子:</b>
 <pre>
  //设置不打印注释类型。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setPrintCommentStyle(PrintConstants.PRINT_COMMENT_NONE);
 </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/constants/PrintConstants.html" title="application.constants 中的接口"><CODE>PrintConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPrintErrorStyle(int)"><!-- --></A><H3>
setPrintErrorStyle</H3>
<PRE>
public void <B>setPrintErrorStyle</B>(int&nbsp;type)</PRE>
<DL>
<DD>设置打印错误值的类型。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPrintErrorStyle</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>type</CODE> - 打印错误值的类型,其取值为如下常量:
 <pre>
     PRINT_ERROR_VALUE -- 显示值<br>
     PRINT_ERROR_BLANK -- 空白<br>
     PRINT_ERROR_DASH -- --<br> 
     PRINT_ERROR_NA -- *N/A
 </pre>
 <p>
 <b>例子:</b>
 <pre>
 　//设置打印错误值的类型为显示值
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setPrintErrorStyle(PrintConstants.PRINT_ERROR_VALUE);
 </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/constants/PrintConstants.html" title="application.constants 中的接口"><CODE>PrintConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPrintOrder(int)"><!-- --></A><H3>
setPrintOrder</H3>
<PRE>
public void <B>setPrintOrder</B>(int&nbsp;printOrder)</PRE>
<DL>
<DD>该方法设置打印顺序。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPrintOrder</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>printOrder</CODE> - 打印顺序,其取值为如下常量:
 <pre>
  COLUMN_ROW  -- 先列后行
  ROW_COLUMN  -- 先行后列
 </pre>
 <p>
 <b>例子:</b>
 <pre>
 //设置打印顺序为先列后行。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setPrintOrder(PrintConstants.COLUMN_ROW);
 </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/constants/PrintConstants.html" title="application.constants 中的接口"><CODE>PrintConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPrintPagesHeight(int)"><!-- --></A><H3>
setPrintPagesHeight</H3>
<PRE>
public void <B>setPrintPagesHeight</B>(int&nbsp;height)</PRE>
<DL>
<DD>设置打印页高。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPrintPagesHeight</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>height</CODE> - 设置的打印几页高
 <p>
 <b>例子:</b>
 <pre>
  //设置的打印1页高
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setPrintPage