PowerBuilder票据打印全指南：从参数设置到走纸偏移排查

简介：面向PowerBuilder 12开发者的票据打印示例资源，用于解决PB应用程序中票据、小票、凭证等自定义格式设计与打印输出需求，尤其适合处理非标准纸张、多联票据或连续打印的商用场景。压缩包共18个文件、大小78KB，包含PowerBuilder工程文件（pbl/pbt/pbw）、HTML演示页面、CSS样式、GIF/JPG图片素材及TXT使用说明，其中pbl/pbt/pbw构成可运行的PB项目主体，htm与css展示票据预览和样式控制，图片辅助界面示意，txt则提供使用说明与环境配置指引，整体体积小巧，便于下载后快速试运行。已有256人学习下载。通过该资源可了解PB12中数据窗口对象在票据打印中的典型应用，包括自定义纸张、动态数据填充、多页连续打印、打印参数控制等，并借鉴报表设计工具的分组、排序和计算字段思路。压缩包中的自定义票据打印示例与说明文档，适合需要快速落地票据功能、复用打印模板、排查打印配置问题或理解PB12打印模块的开发者参考。 做PowerBuilder的人，几乎早晚都会碰到票据打印这件事。不管是商超的小票、物流面单、医院就诊条，还是厂里的领料单，项目一上线，这类“纸比系统重要”的需求就会找上门。PB项目里做票据打印，说难不难，DataWindow天生就是干这个的；但说容易也真不容易，纸张高度、走纸偏移、条码扫描率、表格线发虚，这些坑我一个个都踩过。这篇就把我在pb12里落地票据打印的完整思路、关键参数和排错经验整理出来，给还在跟“打印出来歪了”“第二张开始上下跑”搏斗的朋友一点参考。

1. 直接把票据打印当成一个独立模块来设计

1.1 为什么票据打印会被单独拎出来

很多刚接触PB的朋友会奇怪，打印不就是PrintDataWindow()一行代码吗？为什么还要当成一个模块来设计？我的经验是：普通报表打印和票据打印，对“准”的要求完全不是一个量级。A4报表多打几毫米没人盯着看，但热敏纸票据第二张开始往下偏一毫米，扫码枪就可能扫不出来，金额小票切出来歪的，客户当面就能看出来。

票据打印还有一个特性：纸张规格千奇百怪。58mm热敏、80mm热敏、241×140mm压感、A5三联、自定义长度的连续纸，每种纸张对应的数据窗口设计、打印参数、走纸策略都不一样。同一套程序要兼容几种纸，就必须把“打印”这件事从业务代码里独立出来，用一个集中的模块处理数据窗口的打印参数和纸张计算。这正是pb12里值得专门做的一层。

1.2 PB打印数据的完整链路

上手之前，先把PB打印的完整数据流理清楚。数据从数据库取出来后进DataWindow或DataStore，DataWindow本身维护一套“打印视图”的属性——包括纸张大小、边距、方向、DPI、预览模式，这些属性可以通过Modify()动态修改，也可以在数据窗口画板里直接配。真正触发打印时，系统把这套视图交给GDI，由Windows驱动转换成打印机语言。

这个链路决定了三件事：第一，所有打印控制都要在DataWindow层面做，绕开它去碰底层是不现实的；第二，数据窗口里的显示单位、Preview视图、打印DPI这三个环节如果设置不一致，就会出现“屏幕看着正常、打出来不对”的经典问题；第三，打印驱动和自定义纸张设置会直接影响最终物理效果，这部分PB控制不了，但可以配合。理解这条链，后面所有问题都能顺着找根源。

2. 数据窗口设计是票据打印的第一关

2.1 纸张参数别用默认值

我见过太多票据项目死在一开始：新建数据窗口时，Paper Size用的默认值，通常是A4。然后程序设计者把所有控件堆在左上角，打印时靠打印机驱动自动裁切。这么做的结果往往是：第二张纸的位置完全不可控，因为PB以为自己在打A4，实际纸只有十几厘米长。

正确做法是，在设计阶段就明确打印介质。现在用的热敏票据打印机，一般需要在驱动里添加自定义纸张，比如80mm×130mm的连续纸。添加好之后，数据窗口的DataWindow.Print.Paper.Size设置成对应自定义纸张（很多驱动是256或具体的Index），Paper.Length和Paper.Width再按实际尺寸设一遍。两个地方都设置了，驱动才不容易中途弹“纸张不匹配”的对话框。

2.2 常用打印参数速查

放一张我在实际项目里反复用的参数表，这些都是DataWindow对象Print属性组里的，用Modify()可以动态设置，比在画板里一个个点快得多。

2.3 用Modify动态覆盖默认打印参数

画板里配好的参数只能管住一种纸。实际项目里往往是一台机器换纸就要换参数，这时候就得在代码里动态设置。PB12里最稳定的是用Modify()直接改数据窗口属性，我的习惯是写一个统一函数：

// 参数：dw目标数据窗口，as_width纸张宽，as_height纸张高（单位0.001英寸） // 返回：修改是否成功 public function integer f_setup_print(datawindow adv_dw, integer ai_width, integer ai_height) string ls_modify integer li_ret ls_modify = "DataWindow.Print.Paper.Size=256 " li_ret = adv_dw.Modify(ls_modify) if li_ret < 0 then return li_ret ls_modify = "DataWindow.Print.Paper.Width=" + String(ai_width) + " " + & "DataWindow.Print.Paper.Length=" + String(ai_height) li_ret = adv_dw.Modify(ls_modify) if li_ret < 0 then return li_ret ls_modify = "DataWindow.Print.DPI=300 " + & "DataWindow.Print.Orientation=2 " + & "DataWindow.Print.Margin.Left=0 " + & "DataWindow.Print.Margin.Right=0 " + & "DataWindow.Print.Margin.Top=0 " + & "DataWindow.Print.Margin.Bottom=0" li_ret = adv_dw.Modify(ls_modify) if li_ret < 0 then return li_ret return 1 end function

有一点必须提醒：Modify()改完属性后，数据窗口的显示不会立刻刷新，特别是在预览和普通视图切换时。最好在后面跟一句adv_dw.SetRedraw(True)，或者对数据窗口重新触发一次dw_1.Retrieve()。这一步忘了，常常会出现参数改了但打印出来没变化的假象。

3. 核心难点：连续纸走纸不准的背后原理

3.1 第二张开始歪的根源

连续纸票据最典型的故障就是：第一张正常，第二张开始位置往下跑，越打越歪。我排查下来，绝大多数都是因为PB的打印引擎不知道“纸有多高”。它默认拿A4的高度来排版，第一张纸如果内容不满一页，打印机走纸到A4末尾才切纸，打印头已经把第二张纸推出了初始位置，自然就对不齐。

解决办法就一句话：把Paper.Length告诉PB，而且要算得准。票据内容会有多少行明细是运行时才知道的——今天卖10件商品，明天卖3件，高度完全不同。用固定值做出来的票据，要么内容多时被截断，要么内容少时多走一段空白。这种动态高度需求，正好对应很多人在问的“数据窗口自动高度怎么设置”——在票据打印这里，它不是把Detail Band拉高就算了，而是要反过来：根据明细行数反推纸张高度。

3.2 按明细行数动态计算纸张高度

我的做法分三步。第一步，把数据窗口里的Header、Detail、Footer三个Band的高度都取出来。第二步，算出内容总高：Header.Height + Footer.Height + 明细行数 × Detail.Height。第三步，把总高换算成纸张长度，写进Paper.Length。

代码大概是这样的：

long ll_row, ll_header_h, ll_detail_h, ll_footer_h, ll_total_h long ll_paper_len ll_row = dw_1.RowCount() ll_header_h = Long(dw_1.Object.DataWindow.Header.Height) ll_detail_h = Long(dw_1.Object.DataWindow.Detail.Height) ll_footer_h = Long(dw_1.Object.DataWindow.Footer.Height) ll_total_h = ll_header_h + ll_footer_h + ll_row * ll_detail_h // 加上下安全边距，6000个单位=1英寸 ll_paper_len = ll_total_h + 300 dw_1.Modify("DataWindow.Print.Paper.Length=" + String(ll_paper_len)) dw_1.Modify("DataWindow.Print.Preview=True") dw_1.SetRedraw(True)

这套逻辑看起来简单，真正用的时候有几个细节要注意。第一，明细行里如果某一列设置了AutoSize Height，行高会在运行时变，取到的Detail.Height只是设计值，必须自己在代码里对每行重新算一次。第二，Footer里如果放了合计之类的动态文本，文本高度也可能变，需要在itemchanged或数据窗口的rowchanged事件里重新触发高度计算。第三，取出来的高度单位是数据窗口单位，1英寸等于6000个单位，如果之前有人把DPI调过，单位换算会跟着变，最好统一以6000为基准算。

3.3 关于单位和DPI的换算问题

这里顺便把单位换算一次说清楚。数据窗口里的坐标默认不是像素，也不是毫米，而是PowerBuilder自研的unit，固定1英寸=6000 units。打印时，Print.DPI决定了输出分辨率基准，300是票据设备的主流选择。如果数据窗口里的控件是按照屏幕96DPI摆放的，打印时DPI改成300，就会遇到“打印出来放大”的问题——因为两者的映射基准变了。

我在项目里的经验是：票据数据窗口从建表开始，就把所有Band的高度、控件位置按实际毫米数换算成units来设计。一个80mm宽的票据，打印区域大概72mm（去掉驱动不可打印边距），约2.835英寸，换算成units就是17000左右。这样设计出来的数据窗口，不管前面换什么DPI，物理尺寸都不会跑偏。当然，很多老项目的数据窗口是从A4报表改过来的，那就要在打印前用脚本把整体缩放或重新排一遍，工作量会大一些。

4. 条码、表格线和明细行的打印细节

4.1 条码的两种实现方式

票据上最常见的条码是Code128和EAN-13。PB12里实现条码打印，主流有两种方式。第一种是数据窗口自带的BarCode表达式，在Column的Expression里写类似BarCode(Code128, 0, 0, 0, 0, "字符串列")的表达式，PB自动生成可扫描的条码图形。这种方式不依赖外部字体，打印出来稳定性最好，但样式可调项少，条码下方的数字、宽度比例都受表达式参数限制。

第二种是装条码字体，把数据显示成条码样式。优点是所见即所得，在屏幕上就能直接看到效果，缺点也很明显：字体必须在每台打印机所在的电脑上安装，否则打印出来就是一串普通数字或方框。部署时漏装字体，现场排查起来很狼狈。

我的习惯是优先用BarCode表达式。实际测试下来，Code128在300DPI下效果很好，扫描枪识别率很高。如果实在要用字体方案，务必把字体文件跟程序一起分发，并在安装脚本里加字体注册步骤。

4.2 表格线打印发虚

小票打印经常要打表格线，但很多人发现，屏幕上清清楚楚的细线，打印出来要么变成虚线，要么整条线都看不见。原因在PB里很典型：数据窗口里Line控件默认线宽是整数像素，屏幕显示时1像素就够了，但在300DPI打印时，1像素对应的物理尺寸太小，接近驱动的最小可打印线宽，于是驱动为了省事直接丢弃，或者用抖动方式画出断断续续的线。

解决方案有三个层次。第一层，把表格线的Pen.Width从1改成2或3，这样打印时线条有足够的物理宽度，代价是屏幕上看会略粗。第二层，把表格区域用Rectangle矩形控件代替Line，矩形边框的打印稳定性通常比Line好。第三层，如果对线条粗细特别敏感，干脆用Picture控件放一张1像素宽的纯色图片，横向拉长后作为表格线，打印效果最接近设计稿。我做88mm热敏票据时，一般是表格线用2像素，外框用3像素，配合DPI=300，清晰度基本满足客户要求。

4.3 明细行超长分页处理

商品名称太长、明细行数太多，票据会碰到一页放不下的情况。连续纸小票一般是不希望分页的，整张打出来就是一个长条。要处理好这个，我认为有两个关键点。

第一个关键点在数据准备阶段就做掉：明细进入数据窗口之前，先做文本截断。商品名超过固定字节数就截成两行，实在超长就缩略，不让Detail Band里出现动态超高。第二个关键点是确认驱动里选的纸张类型是“连续纸”或“卷纸”，而不是“A4”之类的单页纸。连续纸模式下，内容超出一页时打印头会继续往下走；单页纸模式下，打印机会强制进新纸，两张小票之间就会夹一张空白页。

如果客户确实要求多页小票，每页都要有抬头和合计，那就要在数据窗口里分组，用Group的newpage属性强制每组分页，并在每页的Footer放本页汇总。这个场景不如单页连续纸常见，但一旦遇到，直接改数据窗口分组会比在代码里拼多个DataWindow靠谱得多。

5. 预览与实际打印对不上的排查思路

5.1 差异从哪里来

用户最常提的投诉是：“预览好好的，打出来怎么差这么多？”这个问题的根源，在于预览和打印走了两套坐标换算。预览是按屏幕分辨率显示的，缩放比例再准也只是模拟；打印是被驱动接管后，按照驱动和纸张实际参数输出的。两个环节里任何一个参数不一致，结果就必然有偏差。

最常见的三个变量：第一，Paper.Width和Paper.Length有没有设；第二，驱动中选中的纸张尺寸是不是和数据窗口一致；第三，驱动有没有设置“缩放以适合页面”之类的选项。这三个地方只要有一处冲突，预览和打印就会不一致。

5.2 一个可靠的预览实现方案

我自己项目中比较稳妥的做法是：预览时用数据窗口自带的Print Preview模式，而不是人为缩放控件。进入预览前，先执行一次前面写的f_setup_print()，把Paper参数都设好，再设置DataWindow.Print.Preview=True。这样预览虽然不完全等于最终打印效果，但纸张尺寸、边距、分页位置都是同一套参数在计算，误差基本可以控制在1mm以内。

另外有两点经验。第一，预览模式里的Zoom不要拉得太小或太大，太小时PB可能不做完整排版，太大时又容易因为字体平滑导致线条位置错觉，我一般设成80~100。第二，预览状态下发现内容偏移，优先检查数据窗口的Margin设置，而不是在Print Preview里手拖控件位置。因为手拖的位置会写进数据窗口布局，下次正式打印还是会乱。

6. 票据打印常见问题速查表

把这些年遇到的现场问题整理成一张表，按“现象—原因—解法”的格式列出来，排查时可以对着看。

7. 一点个人经验

做PB票据打印这几年，我最大的体会是：不要急着写代码，先搞清楚目标打印机和纸张规格，再去设计数据窗口。现场很多“打印问题”，其实是环境问题——驱动没配好、自定义纸张没加、程序里写的参数和驱动里选的不一致。程序逻辑再严谨，也扛不住环境参数全乱套。

另外，给新项目做票据打印时，我会提前把打印参数集中封装成一个函数库，所有数据窗口统一走一套设置。这样后续换打印机、换纸张规格，只改函数里几个常量，不用每个窗口逐一排查。如果你手头正好在改一个老模块，建议从“先把纸的高度算准”这一步开始，这一步对了，至少一半的票据打印问题都能当场消失。

本文还有配套的精品资源，点击获取