首页

pb函数库之打印函数

减小字体

增大字体作者：佚名来源：本站整理发布时间：2017-03-06 14:26:14

Print()
功能以当前字体在打开的打印作业中打印一行或多行文本。
语法Print(printjobnumber,{tab1,}string{,tab2})
参数printjobnumber：用PrintOpen()函数打开的打印作业号tab1：Integer类型，可选项，指定文本开始打印的位置，在开始打印字符串之前将打印光标移动到该位置，从打印区的左边界开始计算，以千分之一英寸为单位。如果打印光标已经位于指定位置、或打印光标已经超过了指定位置、或省略了该参数，那么，Print()函数从打印光标的当前位置开始打印string：string类型，指定要打印的字符串。如果字符串中包括回车换行字符（~r~n），那么该字符串将被分成多行输出，但是，除第一行之外，其它行忽略tab1参数指定的起始打印位置tab2：Integer类型，可选项，指定字符串打印结束后打印光标移动到的位置，从打印区的左边界开始计算，以千分之一英寸为单位。如果打印光标已经超过了指定位置，那么Print()函数忽略该参数，打印光标位于已打印字符串的尾部。如果省略了该参数，Print()函数把打印光标移动到下一行的起始位置。返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，Print()函数返回NULL。用法在打印作业中，PowerBuilder使用打印光标来跟踪打印位置。打印光标保存了即将打印区域左上角的坐标。使用Print()函数打印文本后，PowerBuilder自动更新打印光标。PowerBuilder使用行距来决定打印出的两行文本之间的距离，行距与字符的高度成比例，缺省的行距是字符高度的1.2倍。使用PrintSetSpacing()函数可以改变行距。当Print()函数在下一行打印输出时，它把打印光标的x坐标设置为0、y坐标增加当前行距指示的数值。由于每打印一行时Print()函数都自动调整打印光标的y坐标位置，因此，该函数会自动处理分页，因此，应用程序没有必要调用PrintPage()函数进行分页。打印区由纸张的物理尺寸和边界空白决定，PrintSend()函数能够发送具体打印机的ESC控制序列，使用这个函数可以改变边界空白的大小。另外，在打印开始之前，使用PrintDefineFont()和PrintSetFont()函数可以改变Print()使用的字体。
PrintBitmap()
功能在打印区域的指定位置打印位图。
语法PrintBitmap ( printjobnumber, bitmap, x, y, width, height )
参数printjobnumber：用PrintOpen()函数打开的打印作业号bitmap：string类型，指定要打印的位图文件的文件名x：integer类型，指定位图起始打印位置的x坐标，以千分之一英寸为单位y：integer类型，指定位图起始打印位置的y坐标，以千分之一英寸为单位width：integer类型，指定位图的打印宽度，以千分之一英寸为单位。如果该参数的值指定为0，那么按图像的原始宽度打印height：integer类型，指定位图的打印高度，以千分之一英寸为单位。如果该参数的值指定为0，那么按图像的原始高度打印返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，PrintBitmap()函数返回NULL。用法执行PrintBitmap()函数后，打印光标的位置不变，依然停留在执行该函数前的位置上。
PrintCancel()
功能取消用PrintOpen()函数启动的打印作业。
语法PrintCancel ( printjobnumber )
参数printjobnumber：要取消的打印作业的作业号返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数printjobnumber的值为NULL，PrintCancel()函数返回NULL。用法PrintCancel()函数取消指定的打印作业，删除相应的打印池文件，关闭打印作业，所以，应用程序执行了PrintCancel()函数之后，不需要再执行PrintClose()函数关闭打印作业了。
PrintClose()
功能关闭打印作业并把打印页面发送到打印机上。
语法PrintClose ( printjobnumber )
参数printjobnumber：要关闭的打印作业的作业号返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数printjobnumber的值为NULL，PrintClose()函数返回NULL。用法应用程序使用PrintOpen()函数启动打印作业后，必须使用PrintClose()在完成打印任务后关闭打印作业，或根据需要使用PrintCancel()函数取消打印作业。
PrintDataWindow()
功能打印数据窗口控件的内容，用该函数可以在一个打印作业中打印多个数据窗口控件的内容，每个都从新的一页开始打印。
语法PrintDataWindow ( printjobnumber, dwcontrol )
参数printjobnumber：用PrintOpen()函数打开的打印作业号dwcontrol：要打印其内容的数据窗口控件名或子数据窗口控件名返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果参数printjobnumber的值为NULL，PrintDataWindow()函数返回NULL。用法应用程序通过多次执行PrintDataWindow()函数可以在一个打印作业中一次打印多个数据窗口的内容，并且每个数据窗口都从新的一页开始打印。当数据窗口的表现风格为RichTextEdit时，数据窗口中的每一行都在新的一页上开始打印。需要注意的是，PrintDataWindow()函数在打印数据窗口时使用数据窗口本身定义的字体以及风格，使用PrintDefineFont()和PrintSetFont()函数为当前作业定义的字体不起作用。
PrintDefineFont()
功能定义打印作业使用的字体，对每个打印作业PowerBuilder支持八种字体。
语法PrintDefineFont(printjobnumber,fontnumber,facename,height,weight,fontpitch,fontfamily, italic,underline)
参数printjobnumber：用PrintOpen()函数打开的打印作业号fontnumber：指定赋给当前定义字体的编号，有效值在1到8之间 facename：string类型，指定字体名称，该字体应该是你的打印机支持的字体，比如“宋体”height：Integer类型，使用正值指定字体的高度，以千分之一英寸为单位；使用负值指定字体点数，比如，-18代表18点。一般来说，使用点数更精确些weight：指定字体的磅数，正常字体为400磅，粗体为700磅fontpitch：FontPitch枚举类型，指定字体标准。有效取值为：Default! - 缺省值；Fixed! - 固定形式；Variable! - 可变形式fontfamily：FontFamily枚举类型，指定字体系列。有效取值为：AnyFont!、Decorative!、Modern!、Roman!、Script!、Swiss!italic：boolean类型，指定是否使用斜体样式。有效取值为：TRUE - 使用斜体样式；FALSE - 不使用斜体样式。缺省值为FALSEunderline：boolean类型，指定是否加下划线。有效取值为：TRUE - 加下划线；FALSE - 不加下划线。缺省值为FALSE返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，PrintDefineFont()函数返回NULL。用法在一个打印作业中，应用程序能够最多同时定义8种字体。当应用程序需要使用更多的字体时，可以在使用了某个字体号输出内容后使用PrintDefineFont()函数将该字体号对应的字体更换为其它字体。
PrintLine()
功能在当前打印页上绘出指定厚度的一条线。
语法PrintLine ( printjobnumber, x1, y1, x2, y2, thickness )
参数printjobnumber：用PrintOpen()函数打开的打印作业号x1：integer类型，指定直线起点的x坐标，以千分之一英寸为单位y1：integer类型，指定直线起点的y坐标，以千分之一英寸为单位x2：integer类型，指定直线终点的x坐标，以千分之一英寸为单位y2：integer类型，指定直线终点的y坐标，以千分之一英寸为单位thickness：integer类型，指定直线的厚度，以千分之一英寸为单位返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，PrintLine()函数返回NULL。用法应用程序执行了PrintLine()函数后，该函数并不改变打印光标的位置。
PrintOpen()
功能启动打印作业并返回作业号。
语法PrintOpen ( { jobname } )
参数jobname：string类型，可选项，指定要打开打印作业的名称，该名称将显示在打印管理器窗口中返回值Long。函数执行成功时返回打印作业号，发生错误时返回-1。如果任何参数的值为NULL，PrintOpen()函数返回NULL。用法应用程序执行PrintOpen()函数后，启动新的打印作业并走纸到下一页，同时将打印机缺省字体设置为该打印作业的字体。打印光标的位置位于打印区的左上角。其它同组的打印函数使用PrintOpen()函数返回的作业号来标识作业。需要注意的是，使用PrintOpen()函数打开打印作业、使用同组的其它函数完成打印任务后，必须使用PrintClose()关闭打印作业，或根据需要使用PrintCancel()函数取消打印作业。
PrintOval()功能在指定位置以指定线宽绘制椭圆或圆。
语法PrintOval ( printjobnumber, x, y, width, height, thickness )
参数printjobnumber：用PrintOpen()函数打开的打印作业号x：integer类型，指定椭圆或圆外形框左上角的x坐标，以千分之一英寸为单位y：integer类型，指定椭圆或圆外形框左上角的y坐标，以千分之一英寸为单位width：integer类型，指定椭圆或圆外形框的宽度，以千分之一英寸为单位height：integer类型，指定椭圆或圆外形框的高度，以千分之一英寸为单位thickness：integer类型，指定椭圆或圆外边线的厚度，以千分之一英寸为单位返回值Integer。函数执行成功时返回1，发生错误时返回-1。如果任何参数的值为NULL，PrintOval()函数返回NULL。用法应用程序执行了PrintOval()函数后，该函数并不改变打印光标的位置。PrintOval()函数绘出