C# 文档打印详解与示例

---

在软件开发过程中，文档打印是一个常见的功能需求。本文将详细介绍如何在C#中实现文档打印，并给出示例代码。

一、概述

C#中实现文档打印主要涉及到以下几个类：

1. PrintDocument：用于设置打印文档的基本属性，如页边距、打印份数等。
2. PrintDialog：提供一个对话框，让用户选择打印机、设置打印选项等。
3. PageSetupDialog：提供一个对话框，让用户设置页面布局，如纸张大小、方向等。
4. PrintPreviewDialog：提供一个预览窗口，让用户查看打印效果。

下面我们将分别介绍这些类的使用方法。

二、PrintDocument 类的使用

1. 创建 PrintDocument 对象
   首先，我们需要创建一个 PrintDocument 对象。

PrintDocument printDocument = new PrintDocument();

2. 设置 PrintDocument 事件
   接下来，我们需要为 PrintDocument 对象设置一些事件处理程序，如 PrintPage 事件。

printDocument.PrintPage += new PrintPageEventHandler(PrintPage);

3. 实现 PrintPage 事件处理方法
   在 PrintPage 事件处理方法中，我们可以编写具体的打印逻辑。

private void PrintPage(object sender, PrintPageEventArgs e)
{// 获取打印页面的 Graphics 对象Graphics g = e.Graphics;// 设置字体和颜色Font font = new Font("宋体", 12);SolidBrush brush = new SolidBrush(Color.Black);// 打印文本g.DrawString("Hello, World!", font, brush, 100, 100);// 释放资源font.Dispose();brush.Dispose();
}

三、PrintDialog 类的使用

1. 创建 PrintDialog 对象

PrintDialog printDialog = new PrintDialog();

2. 设置 PrintDialog 属性

printDialog.Document = printDocument; // 关联 PrintDocument 对象
printDialog.AllowSomePages = true; // 允许用户选择打印部分页面

3. 显示 PrintDialog 对话框

if (printDialog.ShowDialog() == DialogResult.OK)
{printDocument.Print();
}

四、PageSetupDialog 类的使用

1. 创建 PageSetupDialog 对象

PageSetupDialog pageSetupDialog = new PageSetupDialog();

2. 设置 PageSetupDialog 属性

pageSetupDialog.Document = printDocument; // 关联 PrintDocument 对象

3. 显示 PageSetupDialog 对话框

if (pageSetupDialog.ShowDialog() == DialogResult.OK)
{// 更新 PrintDocument 的页面设置printDocument.DefaultPageSettings = pageSetupDialog.PageSettings;
}

五、PrintPreviewDialog 类的使用

1. 创建 PrintPreviewDialog 对象

PrintPreviewDialog printPreviewDialog = new PrintPreviewDialog();

2. 设置 PrintPreviewDialog 属性

printPreviewDialog.Document = printDocument; // 关联 PrintDocument 对象
printPreviewDialog.WindowState = FormWindowState.Maximized; // 最大化预览窗口

3. 显示 PrintPreviewDialog 对话框

printPreviewDialog.ShowDialog();

六、完整示例

以下是一个完整的打印示例，包括打印文本、图片和表格。

using System;
using System.Drawing;
using System.Drawing.Printing;
using System.Windows.Forms;public partial class MainForm : Form
{private PrintDocument printDocument;public MainForm(){InitializeComponent();InitializePrintDocument();}private void InitializePrintDocument(){printDocument = new PrintDocument();printDocument.PrintPage += new PrintPageEventHandler(PrintPage);}private void btnPrint_Click(object sender, EventArgs e){PrintDialog printDialog = new PrintDialog();printDialog.Document = printDocument;if (printDialog.ShowDialog() == DialogResult.OK){printDocument.Print();}}private void btnPageSetup_Click(object sender, EventArgs e){PageSetupDialog pageSetupDialog = new PageSetupDialog();pageSetupDialog.Document = printDocument;if (pageSetupDialog.ShowDialog() == DialogResult.OK){printDocument.DefaultPageSettings = pageSetupDialog.PageSettings;}}private void btnPrintPreview_Click(object sender, EventArgs e){PrintPreviewDialog printPreviewDialog = new PrintPreviewDialog();printPreviewDialog.Document = printDocument;printPreviewDialog.WindowState = FormWindowState.Maximized;printPreviewDialog.ShowDialog();}private void PrintPage(object sender, PrintPageEventArgs e)
{Graphics g = e.Graphics;Font font = new Font("Arial", 12);SolidBrush brush = new SolidBrush(Color.Black);Pen pen = new Pen(Color.Black);// 打印文本g.DrawString("Hello, World!", font, brush, 100, 100);// 打印图片Image image = Image.FromFile("path_to_image.jpg");g.DrawImage(image, 100, 150, image.Width / 2, image.Height / 2);// 打印表格int startX = 100;int startY = 350;int width = 300;int height = 20;// 表格标题g.DrawString("Products", font, brush, startX, startY);// 表格行string[] products = { "Product 1", "Product 2", "Product 3" };for (int i = 0; i < products.Length; i++){g.DrawString(products[i], font, brush, startX, startY + (i + 1) * height);g.DrawLine(pen, startX, startY + (i + 1) * height + 5, startX + width, startY + (i + 1) * height + 5);}// 释放资源font.Dispose();brush.Dispose();pen.Dispose();image.Dispose();
}

在上述代码中，我们实现了以下功能：

1. 在 PrintPage 方法中，我们使用 Graphics 对象来绘制文本、图片和表格。
2. 我们打印了一行文本 “Hello, World!”。
3. 我们加载并打印了一个图片，注意替换 “path_to_image.jpg” 为实际图片路径。
4. 我们创建了一个简单的表格，并打印了三行产品信息。
   最后，确保在 MainForm 的构造函数中调用 InitializePrintDocument 方法，并在窗体上创建三个按钮（btnPrint、btnPageSetup、btnPrintPreview），并为它们分别绑定 btnPrint_Click、btnPageSetup_Click 和 btnPrintPreview_Click 事件处理程序。

以下是 MainForm 的构造函数和按钮点击事件的示例代码：

public MainForm()
{InitializeComponent();InitializePrintDocument();
}private void btnPrint_Click(object sender, EventArgs e)
{PrintDialog printDialog = new PrintDialog();printDialog.Document = printDocument;if (printDialog.ShowDialog() == DialogResult.OK){printDocument.Print();}
}private void btnPageSetup_Click(object sender, EventArgs e)
{PageSetupDialog pageSetupDialog = new PageSetupDialog();pageSetupDialog.Document = printDocument;if (pageSetupDialog.ShowDialog() == DialogResult.OK){printDocument.DefaultPageSettings = pageSetupDialog.PageSettings;}
}private void btnPrintPreview_Click(object sender, EventArgs e)
{PrintPreviewDialog printPreviewDialog = new PrintPreviewDialog();printPreviewDialog.Document = printDocument;printPreviewDialog.WindowState = FormWindowState.Maximized;printPreviewDialog.ShowDialog();
}

在运行此示例之前，请确保您的窗体（MainForm）上已经添加了相应的按钮，并正确地绑定了事件处理程序。这样，您的应用程序就可以进行文档打印、页面设置和打印预览了。

七、总结

本文介绍了 C# 中的文档打印功能，包括如何创建打印文档、处理打印预览、以及如何处理多个页面的打印。通过使用 System.Drawing.Printing 命名空间中的类，可以方便地实现打印功能。

打印功能在应用程序中的实现，能够提升用户体验，让用户更方便地输出他们所需的文档。希望通过本文的示例和解释，您能够在自己的项目中轻松实现文档打印功能。