UltraGrid打印深度解析：绕过PrintManager实现出版级表格输出

1. 为什么UltraGrid的打印功能总让人“不敢碰”——从需求错位说起在某跨平台系统重构项目里我接手了一个运行了八年的WinForms老模块。客户提的需求很朴素“导出表格到Excel能看就行但打印必须一模一样——表头要固定、页眉页脚要带公司Logo、跨页时表头得自动重复、行高列宽不能被打印机缩放糊弄。”听起来像基础功能可当我点开UltraGrid的PrintPreview按钮发现它默认输出的是一张“纸面快照”字体发虚、边框断线、页眉位置飘忽更别说跨页表头这种刚需了。翻遍Infragistics官方文档PrintSettings类里十几个属性像天书SetPrintStyle()方法传个枚举值就完事结果实际效果和预想差了三条街。这背后是典型的控件设计逻辑与业务场景的错位。UltraGrid本质是个高性能数据渲染引擎它的打印模块不是为“出版级排版”设计的而是为“快速生成可读性尚可的纸面副本”服务的。当你用它渲染万行数据时它优先保证滚动流畅但当你调用Print()时它却把渲染逻辑直接搬进GDI绘图上下文而GDI对字体度量、DPI适配、分页裁剪的处理远不如WPF或现代浏览器精细。所以问题从来不在“能不能打”而在于“怎么打才不翻车”。关键词里没写但所有踩过坑的人都懂UltraGrid打印的核心矛盾是WinForms时代控件架构与现代打印需求之间的代际鸿沟。它需要你主动接管渲染流程而不是依赖那个看似完整的PrintManager。适合谁来读这篇如果你正被三类问题卡住第一类打印预览看着正常真机输出后文字挤成一团或列宽全乱第二类跨页时表头消失客户指着合同说“这页没抬头不算正式文件”第三类想加自定义水印或动态页脚比如“第X页 共Y页”却发现PrintSettings里根本没对应API。那你不是控件用错了是还没摸清它的“打印人格”——它不拒绝定制但要求你亲手写每一行绘图指令。2. 打印链路拆解从PrintManager到GDI绘图的七层穿透UltraGrid的打印不是黑箱而是一条清晰可追溯的七层调用链。理解它才能知道在哪一层动手最省力。我们以一次标准Print()调用为起点逐层下钻2.1 第一层PrintManager的“指挥权让渡”当你调用ultraGrid1.Print()实际触发的是UltraGrid.PrintManager.Print()。这个PrintManager对象表面看是总控实则只做三件事初始化PrintDocument实例、绑定事件、调用DoPrint()。关键点在于——它不参与任何绘图只负责把控制权交给.NET Framework的PrintDocument。这意味着UltraGrid自身不持有打印机句柄也不直接调用Win32 GDI函数。它把整个绘图责任完整移交给了.NET的打印抽象层。提示别在PrintManager上死磕样式设置。它的PrintSettings属性组如HeaderStyle、FooterStyle只是为“简易模式”准备的快捷方式。一旦你需要精确控制就必须绕过它直接操作PrintDocument的PrintPage事件。2.2 第二层PrintDocument的“事件驱动”本质PrintDocument是.NET打印体系的中枢。它的核心是PrintPage事件每次需要绘制一页时触发。UltraGrid的PrintManager在内部订阅了这个事件并在事件处理器中调用DrawGrid()方法。但注意这个DrawGrid()不是公开API而是内部私有方法。你无法重写它但可以完全替换整个事件处理器——这才是破局点。// 正确姿势接管PrintPage事件放弃PrintManager的默认逻辑 PrintDocument printDoc new PrintDocument(); printDoc.PrintPage (sender, e) { // 在这里你拥有e.Graphics的完全控制权 // 可以用e.Graphics.DrawString画文字e.Graphics.DrawRectangle画边框 // UltraGrid的RenderInfo类会告诉你当前页该画哪些行 }; printDoc.Print();2.3 第三层RenderInfo——网格状态的“实时快照”UltraGrid提供了一个关键类UltraGrid.RenderInfo。它不是静态配置而是每次绘制前动态生成的“当前视图快照”。调用ultraGrid1.DisplayLayout.GetRenderInfo()你会得到一个包含以下核心信息的对象VisibleRows当前可见行集合含分页后的截断行VisibleColumns当前可见列集合含隐藏列状态RowHeight/ColumnWidth已计算好的像素高度与宽度考虑了缩放、字体、PaddingScrollPosition当前滚动偏移量用于计算首行Y坐标这才是你做分页计算的唯一可信源。别信ultraGrid1.Rows.Count那只是数据源行数也别信ultraGrid1.DisplayLayout.Bands[0].Columns[0].Width那是设计时宽度。RenderInfo里的值才是打印机真正要画的像素尺寸。2.4 第四层GDI绘图的“像素陷阱”当你拿到e.Graphics就进入了GDI领域。这里埋着第一个大坑DPI适配失准。e.Graphics.DpiX和e.Graphics.DpiY返回的是打印机逻辑DPI通常是96但真实打印机物理DPI可能是600或1200。直接用e.Graphics.MeasureString()测文字宽度结果会严重偏小。解决方案是强制使用GraphicsUnit.Pixel并手动换算// 错误依赖默认DPI测量 SizeF size e.Graphics.MeasureString(标题, font); // 正确指定单位为Pixel并用PrinterResolution校准 float printerDpi 600f; // 从打印机属性获取或设为保守值 float scale printerDpi / 96f; SizeF size e.Graphics.MeasureString(标题, font, int.MaxValue, StringFormat.GenericTypographic); size.Width * scale; // 按真实DPI缩放2.5 第五层分页算法的“行高累加术”UltraGrid没有内置分页器。RenderInfo.VisibleRows返回的是当前屏幕可见行不是当前页可见行。你需要自己实现分页从第0行开始累加RowHeight直到总高度超过e.MarginBounds.Height。但注意两个细节表头高度必须单独计算ultraGrid1.DisplayLayout.Bands[0].HeaderStyle.Height返回的是设计时高度实际渲染高度需用RenderInfo.GetRowHeight(-1)-1代表表头行最后一行可能被截断当累加高度刚超限时不能简单丢弃该行而要计算它在本页能显示的高度e.MarginBounds.Height - 已累加高度然后用e.Graphics.SetClip()裁剪绘图区域。2.6 第六层字体与边框的“抗锯齿博弈”UltraGrid默认用TextRenderingHint.ClearTypeGridFit但在打印时会导致文字边缘发虚。实测发现TextRenderingHint.AntiAliasGridFit在激光打印机上效果更锐利。边框同理Pen.DashStyle DashStyle.Solid比默认的DashStyle.Custom更稳定。这些细节没有文档说明全是实测出来的“手感”。2.7 第七层页眉页脚的“绝对定位”PrintManager.HeaderStyle只能设固定文本。要加Logo必须用e.Graphics.DrawImage()要加动态页码必须在PrintPage事件里维护一个全局页数计数器。关键技巧是页眉高度要从e.MarginBounds.Top开始算页脚高度要从e.MarginBounds.Bottom - footerHeight开始算永远不要用e.PageBounds——那是整页物理区域包含不可打印边距。这七层不是理论模型而是你调试时的真实栈帧。每次打印异常按这个顺序排查先看PrintPage事件是否触发确认PrintDocument工作正常→ 再查RenderInfo是否拿到正确行数确认数据源绑定无误→ 然后盯住GDI绘图代码中的DPI换算这是80%模糊问题的根源→ 最后检查分页累加逻辑跨页错乱的元凶。把这条链路刻进肌肉记忆UltraGrid打印就从玄学变成了手艺。3. 实战代码一份可直接粘贴的“出版级”打印类下面这份UltraGridPrinter类是我压箱底的生产环境代码。它不依赖PrintManager完全接管PrintPage事件支持表头跨页、动态页码、自定义Logo、字体抗锯齿优化。代码已去除所有业务耦合你只需传入UltraGrid实例和打印机名称即可。using System; using System.Drawing; using System.Drawing.Printing; using System.Windows.Forms; using Infragistics.Win.UltraWinGrid; public class UltraGridPrinter { private readonly UltraGrid _grid; private readonly string _printerName; private int _currentPage 0; private readonly Font _headerFont new Font(微软雅黑, 10f, FontStyle.Bold); private readonly Font _bodyFont new Font(微软雅黑, 9f); private readonly Brush _headerBrush Brushes.Black; private readonly Brush _bodyBrush Brushes.Black; private readonly Pen _borderPen new Pen(Color.FromArgb(200, 200, 200), 0.5f); public UltraGridPrinter(UltraGrid grid, string printerName null) { _grid grid ?? throw new ArgumentNullException(nameof(grid)); _printerName printerName; } public void Print() { var printDoc new PrintDocument(); if (!string.IsNullOrEmpty(_printerName)) printDoc.PrinterSettings.PrinterName _printerName; printDoc.PrintPage OnPrintPage; printDoc.BeginPrint (s, e) _currentPage 0; try { printDoc.Print(); } catch (Exception ex) { MessageBox.Show($打印失败{ex.Message}, 错误, MessageBoxButtons.OK, MessageBoxIcon.Error); } finally { _headerFont.Dispose(); _bodyFont.Dispose(); _borderPen.Dispose(); } } private void OnPrintPage(object sender, PrintPageEventArgs e) { _currentPage; var renderInfo _grid.DisplayLayout.GetRenderInfo(); var marginBounds e.MarginBounds; var pageHeight marginBounds.Height; var pageWidth marginBounds.Width; // 1. 绘制页眉含Logo和标题 DrawHeader(e, marginBounds); // 2. 计算可用内容区域高度扣除页眉页脚 float contentTop marginBounds.Top 40f; // 页眉预留40px float contentBottom marginBounds.Bottom - 30f; // 页脚预留30px float availableHeight contentBottom - contentTop; // 3. 分页渲染从第0行开始累加行高 float currentY contentTop; int startRowIndex 0; bool hasMoreRows true; while (hasMoreRows currentY contentBottom) { // 获取当前行渲染信息 var row renderInfo.VisibleRows[startRowIndex]; float rowHeight renderInfo.GetRowHeight(row.Index); // 如果是表头行Index-1特殊处理 if (row.Index -1) { DrawHeaderRow(e, row, currentY, pageWidth); currentY rowHeight; startRowIndex; continue; } // 检查是否超出页面底部 if (currentY rowHeight contentBottom) { // 最后一行被截断计算可显示高度 float visibleHeight contentBottom - currentY; DrawDataRow(e, row, currentY, pageWidth, visibleHeight); hasMoreRows false; // 本页结束 } else { DrawDataRow(e, row, currentY, pageWidth, rowHeight); currentY rowHeight; startRowIndex; if (startRowIndex renderInfo.VisibleRows.Count) hasMoreRows false; } } // 4. 绘制页脚含页码 DrawFooter(e, marginBounds); // 5. 设置HasMorePages标志 e.HasMorePages hasMoreRows startRowIndex renderInfo.VisibleRows.Count; } private void DrawHeader(PrintPageEventArgs e, RectangleF marginBounds) { // 绘制Logo假设Resources.logo.png存在 using (var logo Properties.Resources.logo) { if (logo ! null) { float logoWidth 80f; float logoHeight logoWidth * (logo.Height / (float)logo.Width); e.Graphics.DrawImage(logo, marginBounds.Left 10f, marginBounds.Top 5f, logoWidth, logoHeight); } } // 绘制标题 string title ${_grid.Name} 数据报表; var titleSize e.Graphics.MeasureString(title, _headerFont); e.Graphics.DrawString(title, _headerFont, _headerBrush, marginBounds.Left 100f, marginBounds.Top (40f - titleSize.Height) / 2f); // 绘制时间 string timeStr $打印时间{DateTime.Now:yyyy-MM-dd HH:mm:ss}; var timeSize e.Graphics.MeasureString(timeStr, _bodyFont); e.Graphics.DrawString(timeStr, _bodyFont, _bodyBrush, marginBounds.Right - timeSize.Width - 10f, marginBounds.Top (40f - timeSize.Height) / 2f); } private void DrawHeaderRow(PrintPageEventArgs e, UltraGridRow row, float y, float pageWidth) { // 表头背景色 using (var brush new SolidBrush(Color.FromArgb(240, 240, 240))) { e.Graphics.FillRectangle(brush, new RectangleF(0, y, pageWidth, row.Height)); } // 绘制表头文字遍历可见列 var columns _grid.DisplayLayout.Bands[0].Columns; float x 0f; foreach (UltraGridColumn col in columns) { if (!col.Hidden) { float colWidth col.Width; string text col.Header.Caption; var textSize e.Graphics.MeasureString(text, _headerFont); float textX x (colWidth - textSize.Width) / 2f; float textY y (row.Height - textSize.Height) / 2f; e.Graphics.DrawString(text, _headerFont, _headerBrush, textX, textY); e.Graphics.DrawRectangle(_borderPen, x, y, colWidth, row.Height); x colWidth; } } } private void DrawDataRow(PrintPageEventArgs e, UltraGridRow row, float y, float pageWidth, float drawHeight) { // 行背景色交替 Color rowColor row.Index % 2 0 ? Color.White : Color.FromArgb(248, 248, 248); using (var brush new SolidBrush(rowColor)) { e.Graphics.FillRectangle(brush, new RectangleF(0, y, pageWidth, drawHeight)); } // 绘制单元格文字 var columns _grid.DisplayLayout.Bands[0].Columns; float x 0f; foreach (UltraGridColumn col in columns) { if (!col.Hidden) { float colWidth col.Width; object cellValue row.Cells[col.Key].Value; string text cellValue?.ToString() ?? ; var textSize e.Graphics.MeasureString(text, _bodyFont); float textX x 5f; // 左侧内边距 float textY y (drawHeight - textSize.Height) / 2f; e.Graphics.DrawString(text, _bodyFont, _bodyBrush, textX, textY); e.Graphics.DrawRectangle(_borderPen, x, y, colWidth, drawHeight); x colWidth; } } } private void DrawFooter(PrintPageEventArgs e, RectangleF marginBounds) { string footerText $第 {_currentPage} 页共 {GetTotalPageCount()} 页 | $生成时间{DateTime.Now:yyyy-MM-dd}; var footerSize e.Graphics.MeasureString(footerText, _bodyFont); e.Graphics.DrawString(footerText, _bodyFont, _bodyBrush, marginBounds.Left (marginBounds.Width - footerSize.Width) / 2f, marginBounds.Bottom - 25f); } private int GetTotalPageCount() { // 简单估算总行数 / 每页行数实际应基于RenderInfo动态计算 var renderInfo _grid.DisplayLayout.GetRenderInfo(); float totalHeight 0f; foreach (UltraGridRow row in renderInfo.VisibleRows) { totalHeight renderInfo.GetRowHeight(row.Index); } float pageHeight 1100f; // A4纸内容区高度约1100px return (int)Math.Ceiling(totalHeight / pageHeight) 1; } }3.1 关键设计解析为什么这样写构造函数注入PrinterName避免硬编码方便测试时切换到“Microsoft Print to PDF”资源释放显式化_headerFont.Dispose()等放在finally块防止GDI资源泄漏——这是WinForms打印最隐蔽的内存杀手页眉高度硬编码为40px不是偷懒而是因为e.Graphics.MeasureString()在打印上下文中误差大固定值反而稳定表头行Index-1的判断UltraGrid内部约定表头行索引恒为-1这是识别表头的唯一可靠方式DrawHeaderRow中手动计算文字居中textX x (colWidth - textSize.Width) / 2f确保文字在列内水平居中比UltraGrid默认居中更精准GetTotalPageCount()的估算逻辑生产环境建议替换为真实分页计算此处简化仅为演示结构。3.2 如何集成到你的项目将上述代码保存为UltraGridPrinter.cs在窗体中添加打印按钮点击事件里写private void btnPrint_Click(object sender, EventArgs e) { var printer new UltraGridPrinter(ultraGrid1, HP LaserJet MFP); printer.Print(); }如果要支持“打印预览”只需将printDoc.Print()换成var preview new PrintPreviewDialog(); preview.Document printDoc; preview.ShowDialog();这套方案绕过了UltraGrid所有“半成品”打印API直击GDI底层。它牺牲了一点开发速度换来的是100%的可控性。你不再需要猜PrintSettings.HeaderStyle的枚举值含义因为所有逻辑都在你眼皮底下。4. 避坑指南那些文档里绝不会写的“血泪经验”UltraGrid打印的坑往往藏在文档的留白处。以下是我在三个不同客户项目中用真金白银试错换来的经验。它们不写在API手册里但每一条都价值千行调试代码。4.1 坑一VisibleRows的“幻影行”陷阱现象打印时最后一页多出半行空白或者某行数据突然消失。根因RenderInfo.VisibleRows返回的行集合包含了被RowSizing属性设为RowSizing.Fixed但实际高度为0的“幽灵行”。UltraGrid为了保持滚动一致性会把这些行计入可见行列表但GetRowHeight()返回0导致分页累加时跳过它们后续行索引错位。解决方案在遍历VisibleRows前先过滤掉高度为0的行var validRows renderInfo.VisibleRows .Where(r renderInfo.GetRowHeight(r.Index) 0.1f) // 0.1f防浮点误差 .ToList();注意这个过滤必须在每次OnPrintPage中执行因为用户可能在打印过程中调整行高。4.2 坑二字体嵌入的“许可证雷区”现象客户现场打印中文显示为方块英文正常。根因UltraGrid默认用SystemFonts.DefaultFont在无GUI服务的Windows Server上该字体可能不包含中文字形。更致命的是某些企业版Windows禁用了字体子集嵌入导致GDI无法回退到备用字体。解决方案永远不要用SystemFonts.DefaultFont。在UltraGridPrinter构造函数中强制指定一个带完整中文字形的字体// 推荐字体栈按兼容性排序 private readonly Font _bodyFont new Font(Microsoft YaHei UI, 9f); // Win10 // 或降级方案 // private readonly Font _bodyFont new Font(SimSun, 9f); // Win7兼容实测下来“Microsoft YaHei UI”在Win10/11上100%覆盖简体中文且字重比“微软雅黑”更清晰。4.3 坑三PrintPage事件的“异步假象”现象连续点击打印按钮第二次打印内容错乱甚至崩溃。根因PrintDocument.Print()是同步阻塞调用但PrintPage事件处理器内部如果做了耗时操作如读取数据库、调用Web API会阻塞整个打印线程导致后续事件堆积。更隐蔽的是PrintDocument对象本身不是线程安全的——多个打印任务共用一个实例会引发GDI句柄冲突。解决方案每个打印任务必须创建独立的PrintDocument实例。上面的UltraGridPrinter.Print()方法已实现此原则。切记不要在窗体类中声明private PrintDocument _printDoc然后复用。4.4 坑四DPI缩放的“双重惩罚”现象4K显示器用户打印文字小得看不见。根因Windows 10/11的DPI缩放会同时影响两个层面一是Form的AutoScaleMode二是PrintDocument的DefaultPageSettings。UltraGrid的RenderInfo返回的RowHeight是基于屏幕DPI计算的而e.Graphics的DPI是打印机DPI。当屏幕DPI150%打印机DPI600时你用屏幕DPI算出的行高再乘以打印机DPI缩放等于被放大了1.5倍×6.25倍9.375倍彻底失控。解决方案在OnPrintPage开头强制重置DPI感知// 在OnPrintPage方法最顶部添加 if (Environment.OSVersion.Version.Major 6) { var dpiX e.Graphics.DpiX; var dpiY e.Graphics.DpiY; // 强制使用打印机真实DPI忽略屏幕缩放 e.Graphics.ResetTransform(); e.Graphics.ScaleTransform(dpiX / 96f, dpiY / 96f); }这行代码让所有后续MeasureString和DrawString都基于真实DPI计算是4K屏用户的救命稻草。4.5 坑五跨页表头的“视觉欺骗”现象跨页时表头出现但位置偏移2像素看起来像没对齐。根因DrawHeaderRow中e.Graphics.DrawRectangle()绘制的边框其线条宽度是0.5px而GDI在非整数坐标绘制时会自动抗锯齿导致视觉上模糊偏移。解决方案所有边框绘制必须使用整数坐标。修改DrawHeaderRow中的循环// 原代码有问题 e.Graphics.DrawRectangle(_borderPen, x, y, colWidth, row.Height); // 改为修复后 float xInt (float)Math.Round(x); float yInt (float)Math.Round(y); float widthInt (float)Math.Round(colWidth); float heightInt (float)Math.Round(row.Height); e.Graphics.DrawRectangle(_borderPen, xInt, yInt, widthInt, heightInt);这个改动让边框像素级对齐跨页时表头与内容列严丝合缝。这些坑每一个都曾让我加班到凌晨。它们不炫技但直指生产环境的命门。记住UltraGrid的打印能力不是“有没有”而是“你敢不敢亲手写每一行绘图代码”。当你把GDI的DrawString和FillRectangle当成乐高积木来搭那些所谓的“第三方控件限制”就只是纸老虎。5. 进阶技巧让打印效果媲美专业报表工具做到基础打印只是入门。要让UltraGrid输出媲美Crystal Reports或FastReport的效果需要三招组合拳动态列宽适配、条件格式打印、以及PDF导出无缝衔接。这些不是噱头而是客户签验收单时真正在意的细节。5.1 动态列宽根据内容自动伸缩的“智能表格”UltraGrid默认列宽是固定的但打印时长文本会被截断或换行破坏版式。真正的智能是每列宽度 Max(设计宽度, 当前列所有单元格内容所需宽度)。实现分两步预扫描内容宽度在OnPrintPage之前遍历所有行用e.Graphics.MeasureString()计算每列最大内容宽度动态重绘列在DrawDataRow中不直接用col.Width而用预计算的maxWidths[col.Key]。// 在UltraGridPrinter类中添加字段 private Dictionarystring, float _columnMaxWidths new Dictionarystring, float(); // 在Print()方法中添加预扫描逻辑 private void PreScanColumnWidths(PrintPageEventArgs e) { var renderInfo _grid.DisplayLayout.GetRenderInfo(); var columns _grid.DisplayLayout.Bands[0].Columns; foreach (UltraGridColumn col in columns) { if (col.Hidden) continue; float maxWidth col.Width; // 至少不低于设计宽度 // 扫描表头 var headerSize e.Graphics.MeasureString(col.Header.Caption, _headerFont); maxWidth Math.Max(maxWidth, headerSize.Width 10f); // 10f左右内边距 // 扫描数据行取前100行避免性能问题 int scanCount Math.Min(100, renderInfo.VisibleRows.Count); for (int i 0; i scanCount; i) { var row renderInfo.VisibleRows[i]; if (row.Index -1) continue; // 跳过表头 object value row.Cells[col.Key].Value; string text value?.ToString() ?? ; var textSize e.Graphics.MeasureString(text, _bodyFont); maxWidth Math.Max(maxWidth, textSize.Width 10f); } _columnMaxWidths[col.Key] maxWidth; } } // 在DrawDataRow中用_maxWidths替代col.Width float colWidth _columnMaxWidths.ContainsKey(col.Key) ? _columnMaxWidths[col.Key] : col.Width;这个技巧让打印表格告别“省略号”客户看到的是完整数据而不是“XXX...”。5.2 条件格式让关键数据“自己跳出来”客户常提“亏损金额标红达标率超95%的行加绿色背景。”UltraGrid的CellAppearance在屏幕上生效但打印时不继承。解决方案是在DrawDataRow中根据单元格值动态设置画笔和画刷。private void DrawDataRow(PrintPageEventArgs e, UltraGridRow row, float y, float pageWidth, float drawHeight) { // 根据业务规则计算行背景色 Color rowColor GetRowBackgroundColor(row); using (var brush new SolidBrush(rowColor)) { e.Graphics.FillRectangle(brush, new RectangleF(0, y, pageWidth, drawHeight)); } // 遍历列为特定单元格应用条件格式 var columns _grid.DisplayLayout.Bands[0].Columns; float x 0f; foreach (UltraGridColumn col in columns) { if (!col.Hidden) { object value row.Cells[col.Key].Value; Brush textBrush _bodyBrush; // 示例金额列小于0时标红 if (col.Key Amount value is decimal amount amount 0) { textBrush Brushes.Red; } // 示例达标率列大于0.95时加粗 else if (col.Key AchievementRate value is double rate rate 0.95) { // 临时加粗字体 using (var boldFont new Font(_bodyFont, FontStyle.Bold)) { string text value?.ToString() ?? ; var textSize e.Graphics.MeasureString(text, boldFont); float textX x 5f; float textY y (drawHeight - textSize.Height) / 2f; e.Graphics.DrawString(text, boldFont, textBrush, textX, textY); } // 跳过默认绘制 x _columnMaxWidths.ContainsKey(col.Key) ? _columnMaxWidths[col.Key] : col.Width; continue; } // 默认绘制 string text value?.ToString() ?? ; var textSize e.Graphics.MeasureString(text, _bodyFont); float textX x 5f; float textY y (drawHeight - textSize.Height) / 2f; e.Graphics.DrawString(text, _bodyFont, textBrush, textX, textY); e.Graphics.DrawRectangle(_borderPen, x, y, _columnMaxWidths.ContainsKey(col.Key) ? _columnMaxWidths[col.Key] : col.Width, drawHeight); x _columnMaxWidths.ContainsKey(col.Key) ? _columnMaxWidths[col.Key] : col.Width; } } } private Color GetRowBackgroundColor(UltraGridRow row) { // 示例整行高亮逻辑 if (row.Cells[Status].Value?.ToString() Critical) return Color.FromArgb(255, 240, 240); // 浅红色背景 return row.Index % 2 0 ? Color.White : Color.FromArgb(248, 248, 248); }条件格式不再是屏幕专属打印稿同样具备业务语义。客户拿着打印件开会一眼就能抓住重点。5.3 PDF导出一套代码双端输出客户最终要的不是“打印”而是“可归档的电子文档”。UltraGrid自带ExportToExcel但Excel不是归档格式。最佳实践是用同一套GDI绘图逻辑输出到PDF流。借助开源库QuestPDF只需微调OnPrintPage// 安装NuGet包Install-Package QuestPDF using QuestPDF.Fluent; using QuestPDF.Infrastructure; // 在UltraGridPrinter中添加PDF导出方法 public byte[] ExportToPdf() { var document Document.Create(container { container.Page(page { page.Size(PageSizes.A4); page.Margin(20); page.Content().Element(CreateGridElement()); }); }); return document.GeneratePdf(); } private static IContainer CreateGridElement() { return container { // 复用DrawHeader、DrawHeaderRow、DrawDataRow的绘图逻辑 // 但将e.Graphics替换为QuestPDF的Canvas // 具体实现略核心是绘图API映射 }; }虽然QuestPDF的API与GDI不完全对应但核心思想一致把“绘制一张表”的逻辑从Graphics抽象为通用绘图指令。这样你维护一套业务逻辑既能打纸质报告又能生PDF存档还能未来扩展为HTML预览。这三招不是炫技而是把UltraGrid从“能用”推向“好用”的临界点。当客户说“这打印效果比我们原来的报表系统还专业”你就知道那些熬过的夜值了。