简介这是一套面向.NET开发者的C#可视化打印模板设计源码纯.NET实现、不依赖任何第三方控件适合需要为发票、报告、证书、标签及单据类业务快速搭建打印能力的初中级工程师。资源提供模板编辑器、图形设计工具与布局管理器等组件支持拖拉控件、所见即所得编辑模板既可嵌入其他项目也能独立作为打印程序使用仅需提供Excel数据即可调用模板打印并支持单头标签与带表体明细行的单据自动翻页。压缩包共639个文件约89.25MB以dll、xml、txt、pdb、nupkg、cs、png、xlsx等为主涵盖程序集、配置说明、源码、图标素材与示例数据另含sln、csproj等工程文件便于直接编译调试。目前已有1588人学习下载可帮助读者掌握模板设计、数据绑定与分页打印的完整实现思路。1. 从一张“拖出来”的打印单说起很多做 C# 桌面应用的朋友都遇到过这种需求客户要打印发货单、检验报告、标签格式还三天两头改。每次改模板都得重新编译、发版运维成本高得离谱。这个项目解决的就是这个问题——它是一套纯 .NET 实现的可视化打印模板设计器控件可以拖拽、缩放、对齐设计界面就是最终打印效果所见即所得。整个方案不依赖任何第三方控件源码里带了一个可直接运行的测试 Demo拿来就能跑、就能改。如果你正在做 ERP、MES、进销存这类需要大量单据打印的系统这套东西能帮你省掉至少一周的模板引擎开发时间。2. 项目定位与技术选型为什么是纯 .NET 自绘方案2.1 它到底解决了哪类打印问题传统打印方案大致分三种一是用PrintDocument硬编码坐标改一次格式就要动代码二是用Crystal Reports、DevExpress这类报表工具功能强但授权贵、部署重三是用 HTML 转 PDF样式还原度看运气。这个项目走的是第四条路把“设计器”和“渲染器”都做进 WinForms 里模板存成 XML 或 JSON运行时动态加载并绘制到PrintDocument的Graphics上。它的核心能力包括拖拽控件到画布、鼠标拉伸调整大小、属性面板改字体边框、多页模板管理、打印预览、直接输出到打印机。适合的场景很明确——单据格式经常变、打印量大、又不想引入商业报表组件的 .NET 项目。2.2 技术栈与依赖边界项目基于 .NET Framework常见是 4.0 到 4.8 区间UI 层用 WinForms绘图全部走System.Drawing命名空间下的Graphics、Pen、Brush、Font。没有引用任何第三方 DLL这意味着部署时只需要拷贝编译产物不用装运行时组件也不用处理授权。模板序列化常见做法是用XmlSerializer或手写 XML 读写好处是模板文件可读、可手工微调、方便版本管理。如果你打算迁移到 .NET 6/8System.Drawing.Common在非 Windows 平台有限制但纯 Windows 桌面场景没问题。2.3 整体架构分层从源码结构看项目大致分四层层次职责关键类设计器层画布交互、拖拽、选中、对齐设计面板、选择框、拖拽处理器元素模型层定义文本、线条、图片、条码等元素属性元素基类及各子类序列化层模板存取、版本兼容XML/JSON 读写器渲染打印层把元素绘制到 Graphics、分页、预览渲染引擎、打印控制器这种分层的价值在于设计器只负责“改模型”渲染器只负责“读模型画图”两边通过统一的元素模型解耦。你后续要加一个新控件类型只需要在模型层加一个类、在渲染层加一个绘制分支设计器那边基本不用大动。3. 跑起来从源码到第一张打印预览3.1 环境准备与编译步骤先确认本机装了 Visual Studio2015 以上都行和对应版本的 .NET Framework 开发包。打开解决方案后一般会看到两个项目一个是设计器主程序一个是测试 Demo。直接设 Demo 为启动项目F5 运行。如果编译报“找不到类型或命名空间”八成是目标框架版本对不上。右键项目属性把目标框架调成和你机器一致的版本比如.NET Framework 4.7.2。没有 NuGet 包要还原这点很省心。# 如果你习惯命令行编译可以用 msbuild msbuild PrintDesigner.sln /p:ConfigurationRelease # 编译产物在 bin\Release 下直接双击 exe 即可运行命令行编译适合做自动化构建参数/p:ConfigurationRelease指定发布配置输出目录默认在项目下的bin\Release。如果提示 msbuild 不是内部命令用 VS 开发者命令提示符打开终端即可。3.2 设计器界面与拖拽交互运行后主界面通常分三块左边是控件工具箱中间是画布右边是属性网格。从工具箱拖一个“文本”到画布松开鼠标就能看到元素出现。选中后四周出现八个控制点拖角点改大小拖边点改宽高拖中间改位置。拖拽的实现核心是鼠标事件链MouseDown记录起始点和选中元素MouseMove计算偏移量并更新元素坐标MouseUp结束拖拽并刷新画布。常见做法是加一个拖拽阈值移动超过 3 像素才认为是拖拽而不是点击避免误操作。// 简化的拖拽处理逻辑 private Point _startPoint; private bool _isDragging false; private void Canvas_MouseDown(object sender, MouseEventArgs e) { _startPoint e.Location; _isDragging false; // 命中测试判断点到了哪个元素 _selectedElement HitTest(e.Location); } private void Canvas_MouseMove(object sender, MouseEventArgs e) { if (_selectedElement null || e.Button ! MouseButtons.Left) return; // 超过阈值才进入拖拽状态防止点击误触 if (!_isDragging Math.Abs(e.X - _startPoint.X) 3 Math.Abs(e.Y - _startPoint.Y) 3) return; _isDragging true; // 计算偏移并更新元素位置 int dx e.X - _startPoint.X; int dy e.Y - _startPoint.Y; _selectedElement.X dx; _selectedElement.Y dy; _startPoint e.Location; Invalidate(); // 触发重绘 }这段代码里HitTest是命中测试通常从后往前遍历元素列表判断点是否落在元素矩形内。Invalidate()通知系统重绘画布配合OnPaint里的渲染逻辑就能看到元素跟着鼠标走。阈值判断是血泪经验——不加的话用户想点选元素结果轻微抖动就变成拖拽体验很差。3.3 模板的保存与加载设计完模板要能存下来。项目里一般用 XML 序列化把元素列表写成一个.xml文件。保存时遍历所有元素调用序列化器输出加载时反序列化回元素集合再刷新画布。// 模板保存示例 public void SaveTemplate(string path, ListPrintElement elements) { var serializer new XmlSerializer(typeof(ListPrintElement)); using (var writer new StreamWriter(path)) { serializer.Serialize(writer, elements); } } // 模板加载示例 public ListPrintElement LoadTemplate(string path) { var serializer new XmlSerializer(typeof(ListPrintElement)); using (var reader new StreamReader(path)) { return (ListPrintElement)serializer.Deserialize(reader); } }XmlSerializer要求元素类有公开无参构造函数属性要有 get/set。如果元素类里有抽象基类序列化时需要在基类上标注[XmlInclude(typeof(TextElement))]之类的特性否则反序列化会报“无法识别类型”。这是新手最容易翻车的地方报错信息还不直观。3.4 打印预览与输出预览的本质是把模板渲染到内存位图上再显示在一个带缩放功能的窗体里。打印则把同样的渲染逻辑作用到PrintDocument的Graphics上。private void PrintDocument_PrintPage(object sender, PrintPageEventArgs e) { // e.Graphics 就是打印机的绘图表面 foreach (var element in _elements) { element.Draw(e.Graphics); // 每个元素自己负责绘制 } e.HasMorePages false; // 多页时按需设为 true }PrintPage事件可能被调用多次每次画一页。HasMorePages控制是否继续。注意打印机的 DPI 和屏幕 DPI 不同坐标要做换算常见做法是用e.Graphics.DpiX和设计时的 DPI 比值来缩放否则打出来尺寸会偏。4. 核心模块拆解元素模型与渲染引擎4.1 元素基类设计所有可拖拽的控件都继承自同一个基类基类里放公共属性位置、大小、名称、是否可见、旋转角度等。子类各自实现Draw方法。public abstract class PrintElement { public int X { get; set; } public int Y { get; set; } public int Width { get; set; } public int Height { get; set; } public string Name { get; set; } // 每个子类实现自己的绘制逻辑 public abstract void Draw(Graphics g); // 命中测试默认用外接矩形 public virtual bool HitTest(Point p) { return new Rectangle(X, Y, Width, Height).Contains(p); } }基类用抽象方法强制子类实现Draw保证渲染引擎可以统一调用。HitTest给默认实现特殊形状比如圆形、线条可以重写。这种设计的好处是新增元素类型时渲染循环一行都不用改。4.2 文本、线条、图片元素的实现差异文本元素最复杂要处理字体、对齐、自动换行、旋转。常见做法是用Graphics.DrawString配合StringFormat旋转则用Graphics.TranslateTransform和RotateTransform。public class TextElement : PrintElement { public string Text { get; set; } public Font Font { get; set; } public Color ForeColor { get; set; } public override void Draw(Graphics g) { // 保存画布状态避免变换影响后续元素 var state g.Save(); // 平移到元素中心再旋转保证绕中心转 g.TranslateTransform(X Width / 2, Y Height / 2); g.RotateTransform(Rotation); g.TranslateTransform(-Width / 2, -Height / 2); g.DrawString(Text, Font, new SolidBrush(ForeColor), new RectangleF(0, 0, Width, Height), _format); g.Restore(state); // 恢复状态 } }Graphics.Save()和Restore()是配对使用的后悔药——不保存状态的话旋转会累积影响后面所有元素的绘制画面会越来越歪。线条元素相对简单用DrawLine画两点图片元素用DrawImage注意图片要缓存别每次重绘都从磁盘读否则拖拽会卡。4.3 渲染引擎如何统一调度渲染引擎的核心就是一个循环遍历元素列表按 Z 序列表顺序依次调用Draw。设计器画布和打印预览共用这套逻辑区别只是传入的Graphics来源不同。public class RenderEngine { public void Render(Graphics g, ListPrintElement elements) { // 设置高质量渲染模式打印更清晰 g.SmoothingMode SmoothingMode.AntiAlias; g.TextRenderingHint TextRenderingHint.ClearTypeGridFit; foreach (var el in elements) { if (!el.Visible) continue; el.Draw(g); } } }SmoothingMode.AntiAlias让线条和圆角更平滑TextRenderingHint.ClearTypeGridFit让文字更锐利。这两个设置对打印质量影响很大建议在渲染前统一设好。Z 序就是列表顺序后加的元素盖在前面元素上设计器里通常提供“上移一层/下移一层”来调整。4.4 属性面板与数据绑定属性面板让用户改选中元素的属性。常见做法是用PropertyGrid控件把选中元素对象直接赋给SelectedObject它会自动反射出所有公开属性并生成编辑界面。// 选中元素变化时刷新属性面板 private void OnSelectionChanged(PrintElement element) { propertyGrid.SelectedObject element; propertyGrid.Refresh(); }PropertyGrid的好处是零代码就能编辑属性坏处是默认编辑器对Font、Color支持还行对自定义类型需要写UITypeEditor。如果不想用PropertyGrid也可以手写一堆TextBox、ComboBox但工作量大。我一般先用PropertyGrid快速跑通后期再针对高频属性做定制面板。5. 避坑与常见问题排查5.1 拖拽时元素闪烁严重现象拖动元素时画面疯狂闪烁像在抽搐。原因每次MouseMove都调用Invalidate()触发全画布重绘而 WinForms 默认不双缓冲。解决给画布控件设置DoubleBuffered true或者用SetStyle(ControlStyles.OptimizedDoubleBuffer | ControlStyles.AllPaintingInWmPaint, true)。如果画布是Panel需要继承一个子类在构造函数里开双缓冲。5.2 打印出来尺寸和屏幕不一致现象屏幕上看着刚好打出来要么偏大要么偏小。原因屏幕 DPI 通常是 96打印机 DPI 可能是 300 甚至 600直接用像素坐标绘制必然错位。解决在PrintPage里按e.Graphics.DpiX / 96f计算缩放比对所有坐标和尺寸做等比缩放。更稳妥的做法是模板坐标用毫米或英寸存储渲染时再换算成像素。5.3 序列化后字体丢失或报错现象保存模板再加载字体变成默认宋体或者直接抛异常。原因Font类没有无参构造函数XmlSerializer无法直接序列化。解决序列化时只存字体名称、大小、样式加载时用new Font(name, size, style)重建。常见做法是给元素类加一个FontData字符串属性专门用于序列化Font属性标记[XmlIgnore]。5.4 多页打印时内容重复或丢失现象明明有两页数据打印出来第一页内容重复或者第二页空白。原因PrintPage事件里没有正确更新当前页索引或者HasMorePages逻辑写错。解决在打印控制器里维护一个_currentPage变量每次PrintPage先渲染当前页然后_currentPage再判断_currentPage _totalPages来决定HasMorePages。注意PrintPage可能因为打印机缓冲被调用多次索引更新要幂等。5.5 高 DPI 屏幕下设计器界面错乱现象在 4K 屏上控件重叠、文字被截断。原因WinForms 默认不感知 DPI 缩放。解决在 app.manifest 里开启 DPI 感知或者在Program.cs里调用Application.SetHighDpiMode(HighDpiMode.SystemAware).NET Core 以上。老项目如果改不动至少把窗体的AutoScaleMode设为Dpi能缓解大部分问题。6. 二次开发加一个自定义条码元素假设客户要求支持 Code128 条码打印你需要做三件事加模型类、加绘制逻辑、加工具箱入口。先定义条码元素类继承PrintElement加一个BarCodeText属性。绘制时不能自己画条码——那太费劲了——常见做法是引用一个轻量条码库或者用系统自带的System.Drawing手写编码表。如果坚持零第三方依赖可以内置一个 Code128 编码表把字符转成条空序列再用FillRectangle逐条绘制。public class BarCodeElement : PrintElement { public string BarCodeText { get; set; } public int ModuleWidth { get; set; } 2; // 单条宽度 public override void Draw(Graphics g) { // 伪代码把文本编码成条空序列 var bars Code128Encoder.Encode(BarCodeText); int x X; foreach (var bar in bars) { if (bar.IsBar) g.FillRectangle(Brushes.Black, x, Y, bar.Width * ModuleWidth, Height); x bar.Width * ModuleWidth; } } }ModuleWidth控制条码密度值越大条码越宽、越容易扫。编码部分建议单独抽一个Code128Encoder静态类输入字符串输出条空列表方便单元测试。绘制时注意条码下方通常要显示可读文本可以在Draw末尾加一句DrawString。然后在工具箱注册这个新类型让用户能拖出来。工具箱一般是一个ListBox或ToolStrip每项对应一个元素类型。拖拽时用DoDragDrop传递类型信息画布DragDrop事件里根据类型创建实例。最后在渲染引擎里不用改任何代码——因为Draw是多态的循环调用时自动走条码的绘制分支。这就是基类设计带来的扩展性红利。验证方法拖一个条码到画布输入一串数字点打印预览用手机扫一下屏幕上的条码能不能识别。如果扫不出先检查ModuleWidth是不是太小再检查编码表有没有写错。我一般会拿几个标准测试串比如1234567890跑一遍确认编码正确后再上真实数据。从那以后我每次加新元素类型都强制先写一个最小 Demo 单独验证Draw逻辑确认无误再集成进设计器。这样能把问题隔离在绘制层不会和拖拽、序列化搅在一起。希望帮到你。本文还有配套的精品资源点击获取