PrintFrame- 报表打印对话框
PrintFrame报表打印对话框类，本类为用户提供了一系列的接口，通过这些接口可以设置从指定页打印、从指定范围页打印，调整页面左、上、下页边距，细化打印比例，调整默认的打印显示比例等等。
◆ 实例请参考
l 构造函数
类：com.raqsoft.report.control.PrintFrame
public PrintFrame(IReport report, javax.swing.JFrame owner)
throws java.lang.Throwable
打印对话框构造函数
Parameters:
report - 要被打印的报表
owner - 此打印对话框的父窗口
public PrintFrame(IReport report,
java.lang.String userUnitName,
java.lang.String appRoot,
java.lang.String raqName,
boolean savePrintSetup,
java.awt.Frame owner)
throws java.lang.Throwable
Applet报表的打印对话框构造函数
Parameters:
report - 要被打印的报表
userUnitName - 授权用户单位名称
appRoot - 应用目录
raqName - 报表rpr文件名称
savePrintSetup - 是否保存打印设定
owner - 打印页面
Throws:
java.lang.Exception
java.lang.Throwable
public PrintFrame(IReport report,
java.lang.String userUnitName,
java.lang.String appRoot,
java.lang.String raqName,
boolean savePrintSetup,
java.awt.Frame owner,
java.applet.Applet applet)
throws java.lang.Throwable
Parameters:
report - 要被打印的报表
userUnitName - 授权用户单位名称
appRoot - 应用目录
raqName - 报表rpr文件名称
savePrintSetup - 是否保存打印设定
owner - 打印页面
applet - Applet报表
打印对话框构造函数
public PrintFrame(java.lang.String cachedId,
java.lang.String userUnitName,
java.lang.String appRoot,
java.lang.String raqName,
boolean savePrintSetup,
java.awt.Frame owner,
java.applet.Applet applet,
java.lang.String sessionId)
throws java.lang.Throwable
Parameters:
cachedId – 缓存
userUnitName - 授权用户单位名称
appRoot - 应用目录
raqName - 报表rpr文件名称
savePrintSetup - 是否保存打印设定
owner - 打印页面
applet - Applet报表
sessionId – 传入的sessionid
l 可用方法
actionPerformed
语 法： public void actionPerformed(java.awt.event.ActionEvent e)
参数说明： e - 功能控件定义的动作的语义事件
功能说明： 各种功能控件被点击时的执行处理
调用举例： 略
backgroundPrinting
语 法： public void backgroundPrinting()throws Exception
功能说明： 直接在后台打印报表，不显示打印窗口，不选择打印机
调用举例： 略
changeDisplayScale
语 法： public void changeDisplayScale()
功能说明： 改变当前显示比例
调用举例： 略
clearPrintablePages
语 法： public void clearPrintablePages()
功能说明： 清除要打印的指定页面
调用举例： 略
directPrint
语 法： public void directPrint(boolean needSelectPrinter)
hrows java.lang.Exception
参数说明： needSelectPrinter – 是否需要选择打印机
功能说明： 将报表直接发送到打印机进行打印
调用举例： 略
getPageBuilder
语 法： public PageBuilder getPageBuilder()
功能说明： 获取报表分页对象
Returns : PageBuilder分页对象
调用举例： 略
getReportPane
语 法： public JScrollPane getReportPane()
功能说明： 获取显示报表的面板
Returns : JScrollPane - 显示报表的面板
调用举例： 略
goToPage
语 法： public boolean goToPage(int pageNo)
参数说明： pageNo - 当前页编号，从1开始的编号
功能说明： 在当前的页面定义范围内设置要显示的页面
Returns : boolean，设置成功返回true，否则false
调用举例： 略
goToFirstPage
语 法： public boolean goToFirstPage()
功能说明： 设置当前定义范围内的首页
Returns : boolean，设置成功返回true，否则false
调用举例： 略
goToLastPage
语 法： public boolean goToLastPage()
功能说明： 设置当前定义范围内的末页
Returns : boolean，设置成功返回true，否则false
调用举例： 略
goToPreviousPage
语 法： boolean goToPreviousPage()
功能说明： 设置当前定义范围内的前页
Returns : boolean，设置成功返回true，否则false
调用举例： 略
goToNextPage
语 法： public boolean goToNextPage()
功能说明： 设置当前定义范围内的后页
Returns : boolean，设置成功返回true，否则false
调用举例： 略
语 法： public void print()
功能说明： 输出打印任务
调用举例： 略
getPrinterJob
语 法： public PrinterJob getPrinterJob()
功能说明： 获取当前的打印任务对象，可以自己取消或者获取对象里面的任何有意义的信息，注意：只有调用了类似于Print的方法之后，该对象才不为null
Returns : PrinterJob - 当前的打印任务对象
调用举例： 略
setPrinterJob
语 法： public void setPrinterJob(java.awt.print.PrinterJob job)
参数说明： job - 打印任务对象
功能说明： 设置打印任务
调用举例： 略
setColumns
语 法： public void setColumns(int newColumns)
参数说明： newColumns – 分栏数
功能说明： 设置报表的分栏数
调用举例： 略
setDisplayScale
语 法： public void setDisplayScale(int dispScale)
参数说明： dispScale – 要显示的报表比例数，该比例为百分数，例如100为原值大小。
功能说明： 设置预览报表使用的比例。修改该比例仅影响显示，跟实际打印输出没有关系
调用举例： 略
setHorizontalAlign
语 法： public void setHorizontalAlign(byte align)
参数说明： align- 横向居中方式。值为“PrintSetup.HALIGN_CENTER”表示居中; 值为“PrintSetup.HALIGN_LEFT”表示居左; 为“PrintSetup.HALIGN_RIGHT”表示居右
功能说明： 设置横向居中方式
调用举例： 略
setPrintablePages
语 法： public void setPrintablePages(int page)
参数说明： page - 要打印的页号
功能说明： 设置要打印的页号，可以多次调用以设置多个页
调用举例： 略
setPrintablePages
语 法： public void setPrintablePages(int beginPage, int endPage)
参数说明： beginPage - 要打印的起始页号
endPage - 要打印的终止页号
功能说明： 设置要打印的连续页号，包括起始和终止页号
调用举例： 略
setPrintablePages
语 法： public void setPrintablePages(byte type)
参数说明： type - 页类型。值为“PrintFrame.PAGE_ALL”表示打印所有页，值为“PrintFrame.PAGE_EVEN”表示打印偶数页，值为“ PrintFrame.PAGE_ODD”表示打印奇数页
功能说明： 设置要打印的页类型
调用举例： 略
setPrintEnabled
语 法： public void setPrintEnabled(boolean enable)
参数说明： enable - 打印按钮的使能状态，true表示打印按钮可用，false表示打印按钮不可用。
功能说明： 设置打印按钮的使能状态
调用举例： 略
setPrintPageFormat
语 法： public void setPrintPageFormat(PageFormat pf )
参数说明： pf – PageFormat对象，PageFormat中的Paper的单位为1/72英寸，近似于像素坐标，用户可以调用PrintSetup.mmToPixel(double xx)来将毫米转换为Paper的单位。
功能说明： 设置要打印的新的纸张页面设置
调用举例： 略
setPrintZoomScale
语 法： public void setPrintZoomScale(int scale)
参数说明： scale – 要缩放的报表比例数，该比例为百分数，例如100为原值大小。
功能说明： 设置打印时对报表的缩放比例。
调用举例： 略
setPrintZoomType
语 法： public void setPrintZoomType(byte zoomType)
参数说明： zoomType –打印时要缩放的类型，取值为：
不缩放PrintSetup.ZOOM_NONE
按宽缩放，报表宽度与纸宽匹配 PrintSetup.ZOOM_WIDTH
按高缩放，报表高度与纸高匹配 PrintSetup.ZOOM_HEIGHT
按指定比例缩放(需要填入缩放比例) PrintSetup.ZOOM_BY_SCALE
功能说明： 设置打印时对报表的缩放类型
调用举例： 略
setPromptString
语 法： public void setPromptString(java.lang.String prompt)
参数说明： prompt - String
功能说明： 设置在报表中显示的授权水印信息
调用举例： 略
setMirrorPrint
语 法： public void setMirrorPrint(boolean b)
参数说明： b - boolean
功能说明： 设置是否需要滤镜打印
调用举例： 略
setClearColor
语 法： public void setClearColor (boolean b)
参数说明： b - boolean
功能说明： 设置是否需要黑白打印
调用举例： 略
setClearImageLayer
语 法： public void setClearImageLayer (boolean b)
参数说明： b - boolean
功能说明： 设置是否需要清除图层
调用举例： 略
setPrintScale
语 法： public void setPrintScale (java.awt.print.Book book,double shrinkScale)
参数说明： book -类提供文档的表示形式
shrinkScale – 缩放方式
功能说明： 设置打印缩放
调用举例： 略
backgroundPrinting
语 法： public void backgroundPrinting()
throws java.lang.Exception
功能说明： 直接在后台打印报表，不显示打印窗口， 不选择打印机
调用举例： 略
Dispose
语 法： public void dispose ()
功能说明： 处理
调用举例： 略
setNeedExit
语 法： public void setNeedExit (boolean b)
参数说明： b - boolean
功能说明： 设置是否需要退出按钮
调用举例： 略
setPagesPerTime
语 法： public void setPagesPerTime (int pages)
参数说明： pages – int 页数
功能说明： 设置一次打印页数
调用举例： 略
setPrinterName
语 法： public void setPrinterName (java.lang.String printerName)
参数说明： printerName – String 打印机名称
功能说明： 设置打印机名称
调用举例： 略