核心内容摘要
浪迹天涯，遇见更好的自己：中国男生们的国际视野与成长之路
初识PrintDocument类打印功能的核心引擎第一次接触C#打印功能时我完全被各种打印对话框和设置搞晕了。
直到发现了PrintDocument这个神器才发现原来实现打印功能可以如此简单。
PrintDocument就像是打印功能的中央控制器它负责协调整个打印流程从页面设置到内容绘制全都由它一手包办。
记得当时我需要给一个餐饮系统添加小票打印功能用PrintDocument只花了不到半天就搞定了。
这个类位于System.Drawing.Printing命名空间使用时需要先添加引用。
最让我惊喜的是它不仅能打印文本还能处理图像、表格等各种复杂内容。
// 最基本的打印示例 PrintDocument pd new PrintDocument(); pd.PrintPage (sender, e) { e.Graphics.DrawString(Hello World, new Font(Arial,
, Brushes.Black, 100,
; }; pd.Print();这段代码虽然简单但包含了打印的三个核心要素创建打印文档对象、定义打印内容、执行打印命令。
在实际项目中我们通常会把它封装成一个专门的打印服务类方便各个模块调用。
打印机设置避开那些年我踩过的坑刚开始用PrintDocument时我最头疼的就是打印机设置问题。
明明代码写对了但打印机就是没反应。
后来才发现90%的打印问题都出在打印机配置上而不是代码本身。
1 获取可用打印机列表在打印之前我们首先需要知道系统中有哪些打印机可用。
通过PrinterSettings.InstalledPrinters可以获取所有已安装的打印机名称。
这里有个小技巧通常我们会把打印机列表显示在下拉框中让用户自己选择。
// 获取所有打印机名称 foreach(string printer in PrinterSettings.InstalledPrinters) { Console.WriteLine(printer); } // 设置默认打印机 PrintDocument pd new PrintDocument(); string defaultPrinter pd.PrinterSettings.PrinterName;
2 处理打印机状态问题在实际使用中经常会遇到打印机脱机、端口错误等问题。
我建议在打印前先检查打印机状态检查打印机是否就绪检查是否有未完成的打印任务阻塞队列验证打印机端口设置是否正确// 检查打印机状态 if(!pd.PrinterSettings.IsValid) { MessageBox.Show(打印机设置无效); return; } if(pd.PrinterSettings.IsDefaultPrinter) { // 处理默认打印机逻辑 }
页面布局设计让打印内容完美呈现打印内容布局是另一个需要重点关注的领域。
与屏幕显示不同打印布局需要考虑纸张大小、边距、分页等实际问题。
1 设置页面属性通过DefaultPageSettings属性我们可以控制纸张大小、方向、边距等// 设置页面属性 pd.DefaultPageSettings.PaperSize new PaperSize(A4, 827,
; // A4纸 pd.DefaultPageSettings.Margins new Margins(50, 50, 50,
; // 四边距50 pd.DefaultPageSettings.Landscape true; // 横向打印
2 精确计算打印位置打印内容的位置需要精确计算。
我习惯使用PrintPageEventArgs提供的MarginBounds属性来确定可打印区域pd.PrintPage (sender, e) { RectangleF bounds e.MarginBounds; float x bounds.Left; float y bounds.Top; // 计算行高 float lineHeight font.GetHeight(e.Graphics); // 打印文本 e.Graphics.DrawString(订单号: 20230001, font, Brushes.Black, x, y); y lineHeight *
5f; e.Graphics.DrawString(日期: DateTime.Now.ToString(), font, Brushes.Black, x, y); };
实战案例打印餐饮小票让我们通过一个完整的餐饮小票打印案例把前面学到的知识串起来。
这个例子包含了文本、表格线和汇总信息的打印。
1 构建打印内容首先我们需要准备打印内容。
我通常会创建一个专门的方法来生成打印文本public string BuildReceiptContent() { StringBuilder sb new StringBuilder(); sb.AppendLine( 美味餐厅 ); sb.AppendLine(---------------------); sb.AppendLine(订单号: orderNumber); sb.AppendLine(时间: DateTime.Now.ToString(yyyy-MM-dd HH:mm)); sb.AppendLine(---------------------); sb.AppendLine(菜品 数量 单价 小计); foreach(var item in orderItems) { sb.AppendLine(${item.Name,-10} {item.Quantity,3} {item.Price,6:C} {item.Total,6:C}); } sb.AppendLine(---------------------); sb.AppendLine($总计: {totalAmount:C}); sb.AppendLine(谢谢惠顾欢迎下次光临); return sb.ToString(); }
2 实现PrintPage事件接下来是核心的打印逻辑。
这里我们不仅要打印文本还要绘制表格线private void PrintReceipt(object sender, PrintPageEventArgs e) { Graphics g e.Graphics; Font titleFont new Font(黑体, 14, FontStyle.Bold); Font contentFont new Font(宋体,
; Font footerFont new Font(宋体,
; float x e.MarginBounds.Left; float y e.MarginBounds.Top; // 打印标题 g.DrawString(美味餐厅, titleFont, Brushes.Black, x (e.MarginBounds.Width - g.MeasureString(美味餐厅, titleFont).Width)/2, y); y titleFont.GetHeight(g) *
5f; // 打印分隔线 g.DrawLine(Pens.Black, x, y, x e.MarginBounds.Width, y); y 10; // 打印订单信息 string[] lines BuildReceiptContent().Split(\n); foreach(string line in lines) { g.DrawString(line, contentFont, Brushes.Black, x, y); y contentFont.GetHeight(g); } // 处理分页 e.HasMorePages false; // 本例只有一页 }
高级技巧打印预览与多页处理对于复杂的打印需求我们还需要考虑打印预览和多页打印的功能。
1 实现打印预览打印预览可以大大提升用户体验避免浪费纸张// 打印预览 PrintPreviewDialog preview new PrintPreviewDialog(); preview.Document printDocument; preview.ShowDialog();
2 处理多页打印当内容超过一页时需要使用HasMorePages属性来控制分页private Liststring printLines; private int currentLine; private void PrintMultiPage(object sender, PrintPageEventArgs e) { Graphics g e.Graphics; Font font new Font(宋体,
; float y e.MarginBounds.Top; while(currentLine printLines.Count) { string line printLines[currentLine]; g.DrawString(line, font, Brushes.Black, e.MarginBounds.Left, y); y font.GetHeight(g); currentLine; if(y e.MarginBounds.Bottom) { e.HasMorePages currentLine printLines.Count; return; } } e.HasMorePages false; currentLine 0; // 重置计数器 }
性能优化与异常处理在实际项目中打印功能还需要考虑性能和稳定性问题。
1 资源释放打印完成后一定要记得释放资源try { printDocument.Print(); } catch(InvalidPrinterException ex) { MessageBox.Show(打印机不可用: ex.Message); } finally { printDocument.Dispose(); }
2 异步打印大量打印任务可能会阻塞UI线程可以考虑使用异步打印// 异步打印 printDocument.PrintController new StandardPrintController(); printDocument.BeginPrint (s, e) { /* 打印前准备 */ }; printDocument.EndPrint (s, e) { /* 打印后清理 */ }; // 在新线程中打印 Task.Run(() printDocument.Print());
7.
常见问题解决方案在多年的开发中我
总结了一些
常见问题的解决方法打印内容偏移检查打印机驱动设置中的页边距确保与代码设置一致中文乱码使用支持中文的字体如宋体、微软雅黑打印速度慢减少不必要的绘图操作使用PrintController优化图片模糊确保图片分辨率足够高至少300dpi// 高质量打印设置 printDocument.DefaultPageSettings.PrinterResolution new PrinterResolution { Kind PrinterResolutionKind.High };掌握了这些技巧后你会发现用C#实现打印功能其实并不复杂。
关键是要理解PrintDocument的工作原理并在实际项目中不断实践和优化。