sspagesetup.html

永中OFFICE二次开发帮助文档

public boolean <B>isSingleColor</B>()</PRE>
<DL>
<DD>是否单色打印。
<P>
<DD><DL>

<DT><B>返回：</B><DD></DL>
</DD>
</DL>
<HR>

<A NAME="setFooterPosition(double, int)"><!-- --></A><H3>
setFooterPosition</H3>
<PRE>
public void <B>setFooterPosition</B>(double&nbsp;footerPosition,
                              int&nbsp;unitType)</PRE>
<DL>
<DD>设置页脚的位置。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setFooterPosition</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>footerPosition</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>
  //设置页脚的高度为1.0厘米
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setFooterPosition(1.0,UnitConstants.CENTIMETER);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定参数的数值错误或越界<DT><B>另请参见：</B><DD><CODE>PageSetup.setFooterPosition(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="setGridlines(boolean)"><!-- --></A><H3>
setGridlines</H3>
<PRE>
public void <B>setGridlines</B>(boolean&nbsp;gridlines)</PRE>
<DL>
<DD>设置是否打印网格线。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setGridlines</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>gridlines</CODE> - 布尔型值，如为true，打印网格线；否则，不打印网格线
 <p>
 <b>例子:</b>
 <pre>
  //设置打印网格线。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setGridlines(true);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setGutter(double, int, int)"><!-- --></A><H3>
setGutter</H3>
<PRE>
public void <B>setGutter</B>(double&nbsp;gutterValue,
                      int&nbsp;unitType,
                      int&nbsp;position)</PRE>
<DL>
<DD>设置装订线。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>gutterValue</CODE> - 装订线的值，即添至页边距中以便装订的额外间距量,
      double型,单位：磅,其取值范围介于0磅至1584磅之间<DD><CODE>unitType</CODE> - 度量单位，其取值为如下类型：
 <pre>
 UnitConstants.INCH -- 英寸
 UnitConstants.CENTIMETER -- 厘米
 UnitConstants.MILLIMETER -- 毫米
 UnitConstants.POINT -- 磅
 UnitConstants.PICA -- 十二点活字
 </pre><DD><CODE>position</CODE> - 装订线的位置
 <pre>
 GUTTER_LEFT       装订线位置：左
 GUTTER_TOP        装订线位置：上
 </pre>
 <p>
 <b>例子:</b>
 <pre>
  //设置装订线的值为0.2厘米，装订线的位置为左。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 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><A HREF="../../../../application/constants/PrintConstants.html" title="application.constants 中的接口"><CODE>PrintConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setHeaderPosition(double, int)"><!-- --></A><H3>
setHeaderPosition</H3>
<PRE>
public void <B>setHeaderPosition</B>(double&nbsp;headerPosition,
                              int&nbsp;unitType)</PRE>
<DL>
<DD>设置页眉的位置（默认以 pt 为单位）。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setHeaderPosition</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>headerPosition</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>
  //设置页眉的高度为1.5厘米
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setHeaderPosition(1.5,UnitConstants.CENTIMETER);
 </pre>
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../../application/exceptions/MacroRunException.html" title="application.exceptions 中的类">MacroRunException</A></CODE> - 当给定参数的数值错误或越界<DT><B>另请参见：</B><DD><CODE>PageSetup.setHeaderPosition(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="setHeadings(boolean)"><!-- --></A><H3>
setHeadings</H3>
<PRE>
public void <B>setHeadings</B>(boolean&nbsp;headings)</PRE>
<DL>
<DD>设置是否打印行头和列头。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setHeadings</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>headings</CODE> - 布尔型值，如为true，打印工作表时打印行头和列头；否则，不打印行头和列头
 <p>
 <b>例子:</b>
 <pre>
 //设置打印行头和列头。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setHeadings(true);
 </pre></DL>
</DD>
</DL>
<HR>

<A NAME="setHorizontal(int)"><!-- --></A><H3>
setHorizontal</H3>
<PRE>
public void <B>setHorizontal</B>(int&nbsp;horizontal)</PRE>
<DL>
<DD>设置页面的水平对齐方式。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setHorizontal</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>horizontal</CODE> - 水平对齐方式,其取值为如下常量:
<pre>
 PrintConstants.HORIZONTAL_LEFT    -- 左 -- 0
 PrintConstants.HORIZONTAL_CENTER  -- 中 -- 1
 PrintConstants.HORIZONTAL_RIGHT   -- 右 -- 2
</pre>
 <p>
 <b>例子:</b>
 <pre>
  //设置页面的水平对齐方式为左对齐。
 Worksheet worksheet = Application.getWorkbooks().getActiveWorkbook()
                                 .getWorksheets().getActiveWorksheet();
 SsPageSetup pageSetup = worksheet.getPageSetup();
 pageSetup.setHorizontal(PrintConstants.HORIZONTAL_LEFT);
 </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="setOrientation(int)"><!-- --></A><H3>
setOrientation</H3>
<PRE>
public void <B>setOrientation</B>(int&nbsp;orientation)</PRE>
<DL>
<DD>设置页面横排或竖排。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setOrientation</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>orientation</CODE> - 页面方向，其常量和相应的值如下：
 <pre>
 VERTICAL     = 0 -- 纵向
 HORIZONTAL   = 1 -- 横向
 </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><A HREF="../../../../application/constants/PrintConstants.html" title="application.constants 中的接口"><CODE>PrintConstants</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setPageBottomMargin(double, int)"><!-- --></A><H3>
setPageBottomMargin</H3>
<PRE>
public void <B>setPageBottomMargin</B>(double&nbsp;pageBottomMargin,
                                int&nbsp;unitType)</PRE>
<DL>
<DD>设置下边距。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPageBottomMargin</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pageBottomMargin</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.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.setPageBottomMargin(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="setPageHeight(double, int)"><!-- --></A><H3>
setPageHeight</H3>
<PRE>
public void <B>setPageHeight</B>(double&nbsp;pageHeight,
                          int&nbsp;unitType)</PRE>
<DL>
<DD>设置页面高度。
<P>
<DD><DL>
<DT><B>覆盖：</B><DD>类 <CODE>application.workbooks.workbook.print.PageSetup</CODE> 中的 <CODE>setPageHeight</CODE></DL>
</DD>
<DD><DL>
<DT><B>参数：</B><DD><CODE>pageHeight</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>
  //设置页面高度为14.8厘米
 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.setPageHeight(double)</CODE>,