简单介绍一下该功能所在的项目背景:C#语言编写的WPF客户端应用程序,在“结账”模块中,打印出的收款小票上需要显示一个二维码,服务生拿着小票去找顾客,顾客可以选择现金、银行卡等普通支付方式,也可以直接扫小票上的二维码进行微信支付。用于打印小票的模板使用FastReport制作。结账功能和收款单打印模板已经在使用,现在只需要在原有模板的基础上进行修改。
首先,我们要明确一点:二维码其实就是一张图片。因此和打印条形码不同,打印二维码,只需要使用FastReport中的图片控件就可以了。双击图片控件后,有四种方式可以用于设置图片的数据源,如下图所示:
这些方法大家一看就知道怎么用,本项目中我们使用最下面这张大图中的“数据列”方法,用FastReport数据源中的内容对图片进行设置。
以本项目的结账收款单打印模板为例,实现打印二维码的步骤如下所示:
1、在程序中获取需要打印的二维码数据,并将数据源传给打印模板
在该项目中,使用DataSet向打印模板传递数据源,使用Dictionary<string, string>向打印模板传递参数。传递的方法这里不再详述。
为了实现打印二维码这个功能,在传递给打印模板的数据源DataSet中添加了一张用于显示二维码的“微信数据”表,还添加了一个参数“微信二维码”。“微信二维码”参数中保存了这个二维码的地址,若地址为空字符串,说明没有微信二维码,不需要打印。在程序端,调用下面的方法AddQRCodeForPrint为打印模板添加二维码所需的数据。微信二维码图片的url(例:weixin://wxpay/payurl?pr=9BF4WY0)是线上的代码生成的,这里不做介绍。
/// <summary>
/// 向打印模板添加微信二维码
/// </summary>
/// <param name="dsPrint">数据源</param>
/// <param name="objdict">参数</param>
/// <param name="codeURL">微信二维码图片URL</param>
public static void AddQRCodeForPrint(DataSet dsPrint, Dictionary<string, string> objdict, String codeURL)
{
try
{
//添加参数:微信二维码图片URL
objdict.Add("微信二维码", codeURL); //将微信二维码写入数据源
Bitmap bp = GetQrImage(codeURL);
MemoryStream ms = new MemoryStream();
bp.Save(ms, System.Drawing.Imaging.ImageFormat.Bmp);
Byte[] code = ms.ToArray(); DataTable dt = new DataTable();
dt.Columns.Add("二维码", typeof(Byte[]));
DataRow dr = dt.NewRow();
dr["二维码"] = code;
dt.Rows.Add(dr);
dt.TableName = "微信数据";
dsPrint.Tables.Add(dt);
}
catch
{
if (objdict != null && !objdict.ContainsKey("微信二维码"))
objdict.Add("微信二维码", "");
}
}
这个方法中,用于绘制二维码图形的方法GetQrImage如下所示:
/// <summary>
/// 绘制二维码
/// </summary>
/// <param name="qrstr"></param>
/// <param name="ImageWidth"></param>
/// <param name="ImageHeight"></param>
/// <param name="savelocal"></param>
/// <returns>返回:二维码</returns>
private static Bitmap GetQrImage(String qrstr, int ImageWidth = , int ImageHeight = , bool savelocal = false)
{
try
{
Dictionary<EncodeHintType, object> ht = new Dictionary<EncodeHintType, object>();
ht.Add(EncodeHintType.MARGIN, );
BitMatrix matrix = new MultiFormatWriter().encode(qrstr, BarcodeFormat.QR_CODE, ImageWidth, ImageHeight, ht);
Bitmap bitmap = new BarcodeWriter().Write(matrix); //toBitmap(matrix);
int[] rec = matrix.getEnclosingRectangle(); //二维码所有的位置及大小 前两位是位置 后两位是大小
Bitmap argb32bp = new Bitmap(ImageWidth, ImageHeight);
Graphics g = Graphics.FromImage(argb32bp);
System.Drawing.Point[] point = new System.Drawing.Point[];
point[] = new System.Drawing.Point(, );
point[] = new System.Drawing.Point(ImageWidth - , );
point[] = new System.Drawing.Point(, ImageHeight - );
g.FillRectangle(System.Drawing.Brushes.White, new System.Drawing.Rectangle(, , ImageWidth, ImageHeight));
g.DrawImage(bitmap, point, new System.Drawing.Rectangle(rec[], rec[], rec[], rec[]), GraphicsUnit.Pixel);
argb32bp.SetResolution(, );
if (savelocal)
{
String filename = DateTime.Now.ToString("yyyyMMddHHmmssfff") + ".png";
bitmap.Save(String.Format(@"{0}\{1}", System.Windows.Forms.Application.StartupPath, filename), System.Drawing.Imaging.ImageFormat.Png);
}
bitmap.Dispose();
return argb32bp;
}
catch (Exception ex)
{
return null;
}
}
上述方法需要添加的引用:System.Drawing、System.IO,以及一个名为zxing的动态库。(zxing的下载链接:http://pan.baidu.com/s/1c2G39IS)
2、在上面的方法中,程序端已经实现了向打印模板提供所需的数据,接下来需要修改打印模板,接收这些新添加的数据。
这里有一个简单的方法,能够为FastReport的数据源中添加一张表。那就是不直接双击打开打印模板,而是在打印模板的文件上右击,选择打开方式为“记事本”。在记事本中找到<Dictionary></Dictionary>这部分,在里面添加数据源和参数。以本项目的结账收款单打印模板为例,添加了一张用于显示二维码的表“微信数据”,还添加了一个用于确定是否需要打印二维码的参数“微信二维码”。
因此,需要在<Dictionary></Dictionary>中添加如下内容:
<TableDataSource Name="微信数据" ReferenceName="Data.微信数据" DataType="System.Int32" Enabled="true">
<Column Name="二维码" DataType="System.Byte[]"/>
</TableDataSource>
<Parameter Name="微信二维码" DataType="System.String"/>
保存并关闭打印模板的记事本文件。再双击打开打印模板,此时在FastReport的右侧边栏中,能看到数据源里已经多了一个“微信数据”表,如下图所示:
这里的“二维码”就是步骤1中代码里绘制出的二维码图形,检查这个字段的属性,需要确保它的DataType是Byte[]型的。并且在下面的“参数”列表中,也能看到多了一个“微信二维码”参数。
为打印模板新建一个数据区,用于打印二维码。点击“报表”——“设置报表栏”菜单,在打开的窗体中点击“添加“按钮,添加”数据区”。将新添加的数据区重命名为Data_PictureCode。主要步骤如下图所示:
为什么要新建一个数据区,而不是在原来的数据区里添加二维码呢?因为当不需要打印二维码,也就是“微信二维码”参数为空时,我们可以直接把这个数据区隐藏,从而不用在打印出的小票上显示出空白的一大片来,也为客户节省纸张。
在新添加的数据区中插入图片,如下图所示:
双击图片,在图片编辑器的“数据列”中,选择“微信数据”表中的“二维码”。如下图所示:
最后,设置是否需要显示二维码所在的这个数据区。选择一个一定会打印的数据区,在这个数据区的BeforePrint事件中进行控制。首先为所选的数据区添加事件,在FastReport的右侧边栏中,进入到数据区的事件列表(点击那个闪电形状的按钮),在BeforePrint事件后面的编辑框内双击,即可为该数据区添加一个BeforePrint事件。该事件中的代码在打印数据区前执行,如下图所示:
在所选数据区的BeforePrint事件中添加如下代码,控制是否显示二维码所在的那个数据区:
private void Data10_BeforePrint(object sender, EventArgs e)
{
//获取微信二维码url
string codeURL=(String)Report.GetParameterValue("微信二维码"); //若微信二维码url为空,则不显示二维码数据区
if(codeURL=="")
{
Data_PictureCode.Visible=false;
}
}
代码和打印模板设计界面的切换按钮,在FastReport的左下角,见下图所示:
在进行了上述全部修改后,本项目的结账收款单上就能够打印出用于微信支付的二维码了。