C# 技术使用笔记：winform 程序打印控制实现详解

在软件开发中，打印功能是许多应用程序不可或缺的一部分。无论是办公软件、票据打印还是报表生成等场景，都需要开发者能够熟练地实现打印控制。C# 结合 Winform 界面开发，能够方便地实现各种打印需求。本教程将从基础到实战，详细讲解如何在 C# Winform 程序中实现打印控制功能，帮助开发者快速掌握相关技能，开发出实用且高效的打印应用程序。

1. 环境准备与基础设置

1.1 开发环境搭建

在开始使用C#设计Winform程序实现打印控制之前，首先需要搭建合适的开发环境。

• 硬件要求：推荐使用至少4GB内存、1GHz处理器的计算机，以确保开发过程流畅。目前主流的开发电脑配置大多能满足要求，例如搭载Intel Core i5处理器、8GB内存的机型，可轻松应对Winform程序开发及打印控制功能的调试。

• 软件要求：需安装Microsoft Visual Studio，这是开发C# Winform程序的常用集成开发环境。以Visual Studio 2022为例，它提供了丰富的功能支持，包括代码编辑、调试、项目管理等。安装时，选择“使用C++的桌面开发”工作负载，同时确保安装了“.NET桌面开发”组件，这样可以获取到Winform开发所需的所有工具和库。

• 操作系统：推荐使用Windows 10及以上版本，因为这些版本对打印功能的支持更为完善。例如，在Windows 10中，系统自带的打印机驱动程序管理功能可以方便地与Winform程序的打印功能进行交互，确保打印任务能够正确执行。

1.2 添加打印相关控件

搭建好开发环境后，接下来要在Winform项目中添加打印相关的控件，以便实现打印控制功能。

• 打开Visual Studio，创建一个新的Winform项目。在项目中，通过工具箱（Toolbox）添加控件。首先添加一个PrintDocument控件，它是实现打印功能的核心控件。在工具箱中找到PrintDocument控件，将其拖放到窗体上。PrintDocument控件提供了打印文档的相关方法和事件，例如PrintPage事件，该事件在打印的每一页时触发，可以在其中编写绘制打印内容的代码。

• 除了PrintDocument控件，还可以根据需要添加其他辅助控件。例如，添加一个Button控件用于触发打印操作。将Button控件拖放到窗体上，并为其设置合适的文本，如“打印”。然后双击该按钮，在其Click事件处理程序中编写代码，调用PrintDocument控件的Print方法来启动打印任务。

• 如果需要预览打印效果，还可以添加一个PrintPreviewDialog控件。将PrintPreviewDialog控件拖放到窗体上，并将其与PrintDocument控件关联起来。通过设置PrintPreviewDialog控件的Document属性，将其指向PrintDocument控件，这样就可以在打印前查看打印内容的预览效果，方便用户确认打印内容是否符合要求。

2. 打印文档设置

2.1 创建打印文档对象

在Winform程序中实现打印控制功能时，创建打印文档对象是关键步骤之一。通过PrintDocument类来创建打印文档对象，该对象负责定义要打印的内容以及打印相关的属性和事件。

在代码中，可以通过以下方式创建PrintDocument对象：

private PrintDocument printDocument1;
printDocument1 = new PrintDocument();

创建对象后，需要为其添加事件处理程序，以便在打印过程中执行相应的操作。例如，为PrintPage事件添加处理程序：

printDocument1.PrintPage += new PrintPageEventHandler(printDocument1_PrintPage);

在printDocument1_PrintPage方法中，可以编写绘制打印内容的代码。例如，打印一些文本内容

private void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
{
    string textToPrint = "这是打印的内容";
    Font printFont = new Font("Arial", 12);
    e.Graphics.DrawString(textToPrint, printFont, Brushes.Black, new PointF(10, 10));
}

通过这种方式，PrintDocument对象能够将指定的内容绘制到打印页面上。

2.2 设置打印文档属性

创建打印文档对象后，需要对其属性进行设置，以满足打印需求。

打印机设置

可以通过PrinterSettings属性来设置打印机相关参数。例如，选择默认打印机：

printDocument1.PrinterSettings = new PrinterSettings();

还可以设置打印机的纸张大小、纸张来源等属性。例如，设置纸张大小为A4：

printDocument1.DefaultPageSettings.PaperSize = new PaperSize("A4", 827, 1169);

页边距设置

可以通过Margins属性来设置打印页面的边距。例如，设置上下左右边距分别为10毫米：

printDocument1.DefaultPageSettings.Margins = new Margins(10, 10, 10, 10);

打印方向设置

可以通过Landscape属性来设置打印方向。例如，设置为横向打印：

printDocument1.DefaultPageSettings.Landscape = true;

打印内容设置

在PrintPage事件处理程序中，可以通过Graphics对象来绘制打印内容。除了文本内容，还可以打印图片、表格等。例如，打印一张图片：

private void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
{
    Image imageToPrint = Image.FromFile("image.jpg");
    e.Graphics.DrawImage(imageToPrint, new PointF(10, 10));
}

通过合理设置打印文档的属性，可以实现满足用户需求的打印效果。

3. 打印预览功能实现

3.1 添加打印预览控件

在实现打印预览功能时，PrintPreviewDialog控件是必不可少的。该控件可以显示打印内容的预览效果，让用户在实际打印之前能够查看打印内容是否符合预期，从而避免不必要的纸张浪费和打印错误。

在Visual Studio中，通过工具箱（Toolbox）可以轻松添加PrintPreviewDialog控件。将其拖放到窗体上后，需要将其与PrintDocument控件关联起来。具体操作如下：

private PrintPreviewDialog printPreviewDialog1;
printPreviewDialog1 = new PrintPreviewDialog();
printPreviewDialog1.Document = printDocument1; // 将PrintDocument对象与PrintPreviewDialog关联

此外，还需要为打印预览按钮添加事件处理程序，以便在用户点击按钮时显示打印预览对话框。例如：

private void btnPrintPreview_Click(object sender, EventArgs e)
{
    printPreviewDialog1.ShowDialog(); // 显示打印预览对话框
}

通过这种方式，用户可以在点击“打印预览”按钮后，看到打印内容的预览效果。

3.2 配置打印预览

为了提升打印预览的效果和用户体验，可以对PrintPreviewDialog控件进行进一步的配置。以下是一些常见的配置选项：

设置打印预览的显示方式

PrintPreviewDialog控件提供了多种显示方式，例如单页显示、多页显示等。可以通过设置PrintPreviewDialog控件的UseAntiAlias属性来启用抗锯齿效果，使打印预览更加清晰：

printPreviewDialog1.UseAntiAlias = true;

此外，还可以设置PrintPreviewDialog控件的AutoZoom属性，使其自动调整打印内容的显示比例，以适应窗口大小：

printPreviewDialog1.AutoZoom = true;

添加打印预览的导航功能

PrintPreviewDialog控件自带导航功能，用户可以通过工具栏上的按钮进行页面切换、放大、缩小等操作。为了增强用户体验，可以自定义导航工具栏，例如添加自定义按钮或修改按钮的样式。

配置打印预览的页面布局

在打印预览中，页面布局的显示效果与实际打印效果密切相关。可以通过设置PrintDocument对象的DefaultPageSettings属性来调整页面布局，例如设置纸张大小、页边距、打印方向等。这些设置会直接影响打印预览的显示效果。

例如，设置纸张大小为A4，页边距为10毫米，打印方向为纵向：

printDocument1.DefaultPageSettings.PaperSize = new PaperSize("A4", 827, 1169);
printDocument1.DefaultPageSettings.Margins = new Margins(10, 10, 10, 10);
printDocument1.DefaultPageSettings.Landscape = false;

通过合理配置打印预览功能，可以为用户提供更加直观、便捷的打印预览体验，从而提高打印操作的准确性和效率。

4. 打印页面内容绘制

4.1 处理 PrintPage 事件

PrintPage 事件是实现打印页面内容绘制的关键环节，每当打印一页时，该事件都会被触发。在事件处理程序中，可以使用 Graphics 对象来绘制打印内容。

在创建 PrintDocument 对象后，需要为其 PrintPage 事件添加处理程序。例如：

printDocument1.PrintPage += new PrintPageEventHandler(printDocument1_PrintPage);

在 printDocument1_PrintPage 方法中，可以获取 PrintPageEventArgs 参数，其中包含了用于绘制打印内容的 Graphics 对象。通过该对象，可以绘制文本、图形、图片等内容。

例如，绘制简单的文本内容：

private void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
{
    string textToPrint = "这是打印的内容";
    Font printFont = new Font("Arial", 12);
    e.Graphics.DrawString(textToPrint, printFont, Brushes.Black, new PointF(10, 10));
}

在绘制内容时，需要注意以下几点：

• 坐标系统：Graphics 对象的坐标原点位于页面的左上角，PointF 类型的参数用于指定绘制内容的位置。

• 字体和颜色：可以使用 Font 和 Brush 类来设置文本的字体、大小和颜色。

• 页面范围：可以通过 PrintPageEventArgs 的 MarginBounds 属性获取页面的可打印区域，避免绘制内容超出可打印范围。

4.2 绘制文本与图形

在 PrintPage 事件处理程序中，不仅可以绘制文本内容，还可以绘制各种图形，如线条、矩形、圆形等，以丰富打印页面的视觉效果。

绘制文本

绘制文本时，可以使用 Graphics.DrawString 方法。除了基本的文本内容、字体和颜色设置外，还可以通过 StringFormat 类来控制文本的对齐方式、换行规则等。

例如，绘制居中的文本：

private void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
{
    string textToPrint = "这是居中的打印内容";
    Font printFont = new Font("Arial", 12);
    StringFormat format = new StringFormat();
    format.Alignment = StringAlignment.Center; // 水平居中
    format.LineAlignment = StringAlignment.Center; // 垂直居中
    e.Graphics.DrawString(textToPrint, printFont, Brushes.Black, e.MarginBounds, format);
}

绘制图形

绘制图形时，可以使用 Graphics 对象提供的各种绘图方法。例如：

• 绘制线条：

e.Graphics.DrawLine(Pens.Black, new Point(10, 10), new Point(100, 100));

• 绘制矩形：

e.Graphics.DrawRectangle(Pens.Black, new Rectangle(10, 10, 100, 50));

• 绘制圆形：

e.Graphics.DrawEllipse(Pens.Black, new Rectangle(10, 10, 50, 50));

• 填充图形：

e.Graphics.FillRectangle(Brushes.Blue, new Rectangle(10, 10, 100, 50));
e.Graphics.FillEllipse(Brushes.Red, new Rectangle(10, 10, 50, 50));

在绘制图形时，可以使用 Pen 和 Brush 类来设置线条的颜色、宽度和填充颜色。通过组合不同的图形绘制方法，可以创建复杂的打印页面布局。

通过合理处理 PrintPage 事件，并使用 Graphics 对象绘制文本和图形，可以实现丰富的打印页面内容，满足各种打印需求。

5. 打印任务执行

5.1 调用打印方法

在完成打印文档的设置和打印页面内容的绘制后，接下来需要调用打印方法来启动打印任务。在C# Winform程序中，可以通过PrintDocument控件的Print方法来执行打印操作。

在按钮的Click事件处理程序中，调用PrintDocument控件的Print方法：

private void btnPrint_Click(object sender, EventArgs e)
{
    printDocument1.Print(); // 启动打印任务
}

当调用Print方法时，PrintDocument控件会触发PrintPage事件，并在每一页上绘制指定的内容。打印任务会根据设置的打印机参数和打印内容，将文档发送到打印机进行打印。

需要注意的是，在调用Print方法之前，应确保打印文档对象已经正确设置，并且PrintPage事件处理程序中已经编写了绘制打印内容的代码。此外，如果需要打印多页内容，可以在PrintPage事件处理程序中通过e.HasMorePages属性来控制是否继续打印下一页。

5.2 处理打印异常

在打印任务执行过程中，可能会出现各种异常情况，例如打印机故障、纸张不足、打印任务被取消等。为了确保程序的稳定性和用户体验，需要对打印异常进行有效的处理。

可以通过为PrintDocument控件添加PrintController来处理打印异常。PrintController提供了对打印任务的控制和异常处理机制。例如，使用StandardPrintController可以捕获打印过程中的异常：

printDocument1.PrintController = new StandardPrintController();

此外，还可以通过添加QueryPageSettings事件来处理打印页面设置相关的异常。在QueryPageSettings事件处理程序中，可以获取和设置打印页面的属性，例如纸张大小、页边距等。如果在设置打印页面属性时出现异常，可以在该事件处理程序中进行捕获和处理：

private void printDocument1_QueryPageSettings(object sender, QueryPageSettingsEventArgs e)
{
    try
    {
        // 设置打印页面属性
        e.PageSettings.PaperSize = new PaperSize("A4", 827, 1169);
        e.PageSettings.Margins = new Margins(10, 10, 10, 10);
    }
    catch (Exception ex)
    {
        // 处理异常
        MessageBox.Show("打印页面设置异常：" + ex.Message);
    }
}

在打印任务执行过程中，还可以通过捕获PrintDocument控件的PrintPage事件中的异常来处理打印内容绘制相关的异常。例如：

private void printDocument1_PrintPage(object sender, PrintPageEventArgs e)
{
    try
    {
        // 绘制打印内容
        string textToPrint = "这是打印的内容";
        Font printFont = new Font("Arial", 12);
        e.Graphics.DrawString(textToPrint, printFont, Brushes.Black, new PointF(10, 10));
    }
    catch (Exception ex)
    {
        // 处理异常
        MessageBox.Show("打印内容绘制异常：" + ex.Message);
    }
}

通过合理处理打印异常，可以及时发现和解决打印过程中出现的问题，提高程序的稳定性和可靠性，确保打印任务能够顺利完成。

6. 自定义打印样式

6.1 设置字体与颜色

在使用 C# 设计 Winform 程序实现打印控制时，自定义打印样式可以让打印内容更加符合用户的需求和美观要求。设置字体与颜色是自定义打印样式的重要方面。

• 字体设置：在 PrintPage 事件处理程序中，可以通过 Font 类来设置文本的字体、大小和样式。例如，设置标题文本使用加粗的 Arial 字体，字号为 14：

Font titleFont = new Font("Arial", 14, FontStyle.Bold);

对于正文文本，可以使用常规的字体样式：

Font contentFont = new Font("Arial", 12);

然后在绘制文本时使用相应的字体对象：

e.Graphics.DrawString("标题内容", titleFont, Brushes.Black, new PointF(10, 10));
e.Graphics.DrawString("正文内容", contentFont, Brushes.Black, new PointF(10, 30));

• 颜色设置：颜色可以通过 Brush 类来设置。Brushes 类提供了多种预定义的颜色，也可以通过 SolidBrush 类来创建自定义颜色。例如，设置标题文本为蓝色：

Brush titleBrush = Brushes.Blue;

正文文本为黑色：

Brush contentBrush = Brushes.Black;

在绘制文本时使用相应的颜色对象：

e.Graphics.DrawString("标题内容", titleFont, titleBrush, new PointF(10, 10));
e.Graphics.DrawString("正文内容", contentFont, contentBrush, new PointF(10, 30));

通过灵活设置字体与颜色，可以突出重要信息，使打印内容层次分明，更加易于阅读和美观。

6.2 添加页眉页脚

页眉和页脚是打印文档中常见的元素，可以包含页码、日期、文档标题等信息，为打印内容提供更多的上下文信息和格式化效果。

• 添加页眉：在 PrintPage 事件处理程序中，可以通过 Graphics 对象在页面顶部绘制页眉。例如，添加包含文档标题和打印日期的页眉：

string documentTitle = "打印文档标题";
string printDate = DateTime.Now.ToString("yyyy-MM-dd");
Font headerFont = new Font("Arial", 10);
Brush headerBrush = Brushes.Gray;
e.Graphics.DrawString(documentTitle, headerFont, headerBrush, new PointF(10, 10));
e.Graphics.DrawString(printDate, headerFont, headerBrush, new PointF(200, 10));

• 添加页脚：页脚通常包含页码等信息。可以通过 e.PageSettings 获取当前页码，并在页面底部绘制页脚。例如，添加包含页码的页脚：

int currentPage = e.PageSettings.PrinterSettings.FromPage;
string pageText = "第 " + currentPage + " 页";
Font footerFont = new Font("Arial", 10);
Brush footerBrush = Brushes.Gray;
SizeF footerSize = e.Graphics.MeasureString(pageText, footerFont);
e.Graphics.DrawString(pageText, footerFont, footerBrush, new PointF(e.MarginBounds.Width - footerSize.Width - 10, e.MarginBounds.Height - footerSize.Height - 10));

在添加页眉页脚时，需要注意以下几点：

• 位置设置：根据页面的边距和内容布局，合理设置页眉和页脚的位置，避免与正文内容冲突。

• 样式统一：页眉和页脚的字体、颜色等样式应保持统一，与正文内容形成协调的整体效果。

• 动态内容：页码等动态内容需要在每次打印页面时动态生成和更新，确保每一页的页眉页脚信息准确无误。 通过添加页眉页脚，可以为打印文档提供更加完整和专业的格式化效果，提升打印内容的质量和可读性。# 7. 总结

在本教程中，我们详细介绍了如何使用 C# 设计 Winform 程序来实现打印控制功能。从开发环境的搭建到打印任务的执行，再到自定义打印样式的设置，每一步都通过具体的代码示例和详细的操作说明进行了阐述。

通过学习本教程，读者可以掌握以下关键技能：

• 如何搭建适合开发 C# Winform 程序的环境，包括硬件和软件要求。

• 如何在 Winform 项目中添加打印相关控件，并设置其属性。

• 如何创建打印文档对象，设置打印文档的属性，包括打印机设置、页边距、打印方向等。

• 如何实现打印预览功能，让用户在打印前能够查看打印内容的预览效果。

• 如何处理 PrintPage 事件，使用 Graphics 对象绘制文本、图形等打印内容。

• 如何执行打印任务，并处理打印过程中可能出现的异常。

• 如何自定义打印样式，包括设置字体与颜色、添加页眉页脚等，以提升打印内容的美观性和可读性。

通过这些内容的学习和实践，读者可以开发出功能完善、用户体验良好的打印控制程序，满足不同场景下的打印需求。

7、实战实例

实例需求：打印带二维码和文字的页面

在本实例中，我们将在 Winform 窗体中绘制一个二维码，并在二维码上下分别添加不同的文字。然后通过打印功能将该内容打印出来。具体需求如下：

• 在窗体中绘制一个二维码，二维码加上边框。

• 在二维码上方添加标题文字，如“欢迎使用本系统”。

• 在二维码下方添加说明文字，如“二维码有效期：2025年03月30日”。

实现步骤

7.1. 创建项目

• 打开 Visual Studio，创建一个新的 Winform 应用程序项目，命名为 PrintQRCodeDemo。

• 添加必要的 NuGet 包，如 QRCoder 用于生成二维码。

7.2. 设计窗体

• 在窗体中添加一个 Button 控件，用于触发打印操作。

• 添加一个 PrintDocument 控件，用于处理打印任务。

7.3. 编写代码

以下是实现该功能的完整代码：

using QRCoder;
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Drawing.Printing;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace PrintQRCodeDemo
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void Form1_Load(object sender, EventArgs e)
        {
            // 设置按钮的点击事件
            this.ButtonPrint.Click += new EventHandler(this.ButtonPrint_Click);
        }

        private void ButtonPrint_Click(object sender, EventArgs e)
        {
            // 创建打印文档
            PrintDocument printDocument = new PrintDocument();
            printDocument.PrintPage += new PrintPageEventHandler(PrintPage);

            // 打印预览
            PrintPreviewDialog printPreviewDialog = new PrintPreviewDialog();
            printPreviewDialog.Document = printDocument;
            printPreviewDialog.ShowDialog();
        }

        private void PrintPage(object sender, PrintPageEventArgs e)
        {
            // 获取绘图区域
            Graphics graphics = e.Graphics;

            // 设置二维码内容
            string qrCodeText = "https://moonshot.cn";

            // 生成二维码
            QRCodeGenerator qrGenerator = new QRCodeGenerator();
            QRCodeData qrCodeData = qrGenerator.CreateQrCode(qrCodeText, QRCodeGenerator.ECCLevel.Q);
            QRCode qrCode = new QRCode(qrCodeData);
            Bitmap qrCodeImage = qrCode.GetGraphic(20);

            // 绘制二维码
            int qrCodeX = (e.MarginBounds.Width - qrCodeImage.Width) / 2;
            int qrCodeY = (e.MarginBounds.Height - qrCodeImage.Height) / 2;
            graphics.DrawImage(qrCodeImage, qrCodeX, qrCodeY);

            // 绘制二维码边框
            graphics.DrawRectangle(Pens.Black, qrCodeX - 5, qrCodeY - 5, qrCodeImage.Width + 10, qrCodeImage.Height + 10);

            // 绘制标题文字
            string titleText = "欢迎使用本系统";
            Font titleFont = new Font("Arial", 16, FontStyle.Bold);
            SizeF titleSize = graphics.MeasureString(titleText, titleFont);
            int titleX = (e.MarginBounds.Width - (int)titleSize.Width) / 2;
            int titleY = qrCodeY - (int)titleSize.Height - 20;
            graphics.DrawString(titleText, titleFont, Brushes.Black, titleX, titleY);

            // 绘制说明文字
            string descriptionText = "二维码有效期：2025年03月30日";
            Font descriptionFont = new Font("Arial", 12, FontStyle.Regular);
            SizeF descriptionSize = graphics.MeasureString(descriptionText, descriptionFont);
            int descriptionX = (e.MarginBounds.Width - (int)descriptionSize.Width) / 2;
            int descriptionY = qrCodeY + qrCodeImage.Height + 20;
            graphics.DrawString(descriptionText, descriptionFont, Brushes.Black, descriptionX, descriptionY);
        }
    }
}

实现效果

• 点击打印按钮后，会弹出打印预览窗口，显示二维码及其上下方的文字内容。

• 二维码带有边框，标题文字和说明文字分别位于二维码的上下方，布局美观。

通过以上步骤，我们成功实现了在 Winform 程序中打印带二维码和文字的功能。

8. 总结

通过本教程的学习，我们从基础搭建到实战应用，全面深入地掌握了在 C# Winform 程序中实现打印控制的方法。教程首先介绍了开发环境的搭建，包括硬件与软件的准备，为后续开发打下坚实基础。接着详细讲解了如何在 Winform 项目中添加打印相关控件，并设置其属性，这是实现打印功能的关键步骤之一。

在打印任务的执行过程中，我们重点学习了如何创建打印文档对象，设置其属性，如打印机选择、页边距、打印方向等，这些设置直接影响打印效果。同时，教程还详细介绍了打印预览功能的实现，通过 PrintPreviewDialog 让用户在打印前能够直观地查看打印内容，避免不必要的打印错误，提升用户体验。

在实战环节，我们通过一个具体实例——在窗体中绘制二维码并打印，深入探讨了如何处理 PrintPage 事件，使用 Graphics 对象绘制文本、图形等打印内容。这个实例不仅展示了如何将二维码与文字结合，还通过添加边框、设置字体与颜色等操作，提升了打印内容的美观性和可读性。

此外，教程还强调了异常处理的重要性，在打印过程中可能会遇到各种意外情况，如打印机故障、纸张不足等，通过合理的异常处理机制，可以确保程序的稳定运行，避免因打印错误导致程序崩溃。

本教程以系统性和实用性为核心，旨在帮助开发者快速掌握 C# Winform 打印控制的技能。无论是初学者还是有一定基础的开发者，都能通过本教程的学习，开发出功能完善、用户体验良好的打印应用程序。在学习过程中，我们不仅掌握了技术知识，还通过实战演练，提升了实际开发能力，为今后的项目开发积累了宝贵经验。希望读者在完成本教程后，能够将所学知识应用到实际工作中，不断探索和创新，开发出更多优秀的应用程序。