C# 文档打印详解与示例

文章目录

• 一、概述
• 二、PrintDocument 类的使用
• 三、PrintDialog 类的使用
• 四、PageSetupDialog 类的使用
• 五、PrintPreviewDialog 类的使用
• 六、完整示例
• 七、总结

---

在软件开发过程中，文档打印是一个常见的功能需求。本文将详细介绍如何在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 命名空间中的类，可以方便地实现打印功能。

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