pb打印功能使用函数

 

在PowerBuilder应用程序的开发中,各种报表的打印功能是必不可少的。Power- Builder4.0提供了大量与打印机进行通信的内部函数,用于各种打印输出。运用这些函数,您不仅可以打印常见的DataWindow对象,还可以打 印字符串、位图、图形对象,甚至是全屏。

DataWindow的两种打印方法:

在PowerBuilder中我们可以有两种方法打印DataW-indows。一种最简单的方法就是直接地将DataWindow提交给打印机,另一种方法是将大量的DataWindow(或混合其他的对象)放在一起作为一个单一的打印作业提交输出。

法一:不指定打印作业,而发送一个单一的DataW-indow。将报表传给打印机输出的最简单的方式是使用DataWindow对象的Print()函数,您只需简单指明您打印的DataWindow控件的名字就可以得到该DataWindow生成的报表了。例:

dw_data.print({cancel dialog})

Print()函数不需要任何参数,但是它有一个可选参数,可以控制PowerBuilder是否显示Print Cancel对话框窗口(缺省为自动出现,如图1所示)。Cancel dialog参数是一个布尔型变量,其缺省值为真。

一 Print:HP LaserJet HP on LPT1:

Preparing page 1 of 2

Cancel

图1:除非特别指定,否则将在打印时缺省出现Print Cancel对话框。Print()函数还有一些格式可控制打印正文字符串,但是它们要求首先打开一个打印作业。这些格式将在后面解释。

法 二:集成多个DataWindow作为一个打印作业。您可以将提交打印的多个DataWindow作为一个单一的打印指令。为实现这一功能必须打开一个所 谓打印作业(Print job),即发送给打印机一个单一工作单元,其中可以包含多个子任务。在PowerBuilder中一个打印作业由它的作业代号唯一指定。我们使用 PrintOpen({job name})函数打开一个作业,并得到打印作业号。PrintOpen()函数有一个可选参数,就是打印作业名称,这个作业名字将作为Windows 3.x的Print Manager作业集中的名字。当您使用PrintOpen()函数时,系统将另起一页开始打印。当然在打印作业中,您还可以使用其他函数换页,比如将在 后面讲述的PrintPage()函数。

在您打开了一个作业号后,就可以在这个作业内使用下列函数继续其他各种各样的打印项目。

1)在打印作业中加入字符串:

我们也可以使用另外一个与Print()函数略微不同的函数来打印字符串:

PrintText(print_job_number,string,x,y{,font_number})

这 个函数将包含在string参数中的正文字符串当作一个对象进行打印。这个打印的字符串在由X,Y参数(以千分之一寸为单位)指定的坐标处开始。 font_number参数是一个可选参数,缺省使用当前字型,否则font_number的值可以从0到8,0是打印机缺省的字型,1-8是使用后面讲 述的PrintDefineFont()函数定义的字型。这个函数不像其他指定坐标的函数,它将改变打印光标的位置。这个函数的返回值是打印光标的新X坐 标,但它不改变Y坐标。

在打印作业中打印对象

下面的这些函数可以使您在打开的打印作业中打印不同的对象。这些函数中的任一个指定X、Y坐标的函数都不会改变当前打印光标位置。

objectname.Print(print_job_number,x,y {,width,height})

这 个函数可以将任何一个object_name指定的对象放在print_job_number定义的打印作业中打印,这个对象可以是一个窗口也可以是一个 DragObject类的继承类(包括了所有的窗口控件)。X、Y参数指定了一页中的坐标,您可以指出所打印对象出现的位置(以千分之一寸为单位)。 Width和Height参数是可选的参数,用来指明你所需的打印对象的宽和高(仍以千分之一寸为单位)。如果缺省,PowerBuilder将使用对象 本身的尺寸打印。

PrintBitmap(print_job_number,bitmap,x,y,width,height)