WinForms中如何实现打印预览功能？-C#.Net教程-PHP中文网

答案是确保打印预览与实际打印一致的关键在于统一Graphics对象的DPI和单位设置。通过在PrintPage事件中使用相同的字体、度量单位（如Inch或Pixel）并避免屏幕与打印机的DPI差异，可使预览与打印效果保持一致。同时，建议使用PrintDocument的默认设置，并在设计时测试真实打印机的输出。

winforms中如何实现打印预览功能？

在WinForms中实现打印预览，核心在于利用

PrintDocument

登录后复制

组件来承载你的打印内容，然后通过

PrintPreviewDialog

登录后复制

或

PrintPreviewControl

登录后复制

将其呈现在屏幕上。说白了，就是先把要打印的东西画出来，只不过不是直接到打印机，而是先给你看看效果，确保一切无误。这其实是个挺经典的需求，尤其在那些需要生成报表、发票或者任何需要物理输出的桌面应用里，它简直是标配。

解决方案

要搞定WinForms的打印预览，我们主要围绕

PrintDocument

登录后复制

这个核心组件来做文章。它负责管理打印设置，并在需要绘制页面内容时触发一个非常关键的事件——

PrintPage

登录后复制

。

首先，你需要一个

PrintDocument

登录后复制

实例。这玩意儿可以拖到你的窗体上，也可以在代码里直接实例化。

private PrintDocument _printDocument = new PrintDocument();

登录后复制

接着，也是最重要的一步，就是订阅

PrintDocument

登录后复制

的

PrintPage

登录后复制

事件。所有的绘制逻辑，你想要打印什么、怎么排版，都得在这个事件处理方法里完成。系统会为每一页内容触发一次这个事件。

public MyForm()
{
    InitializeComponent();
    // 绑定PrintPage事件，PrintDocument_PrintPage是你的事件处理方法
    _printDocument.PrintPage += new PrintPageEventHandler(PrintDocument_PrintPage);

    // 如果你有多个打印源，或者希望每次打印前都更新设置，可以在这里做一些初始化
    // 例如，设置纸张大小、方向等
    // _printDocument.DefaultPageSettings.Landscape = true;
    // _printDocument.DefaultPageSettings.PaperSize = new PaperSize("A4", 827, 1169); // A4尺寸，单位是百分之一英寸
}

private void PrintDocument_PrintPage(object sender, PrintPageEventArgs e)
{
    // 这里就是画图的核心区域了。
    // e.Graphics 是一个Graphics对象，你可以用它来绘制文本、图片、线条等等。
    // 它已经自动为你处理了打印机的DPI和缩放，所以你可以像在屏幕上画图一样操作。
    Graphics g = e.Graphics;

    // 假设我们要打印一个标题和一些文本
    Font titleFont = new Font("Arial", 24, FontStyle.Bold);
    Font bodyFont = new Font("Consolas", 12);
    SolidBrush blackBrush = new SolidBrush(Color.Black);

    // 绘制标题。坐标是相对于当前页面的左上角。
    // 这里的100, 100是X, Y坐标，单位是百分之一英寸。
    g.DrawString("我的打印预览标题", titleFont, blackBrush, 100, 100);

    // 绘制一些正文内容。为了自动换行，我们可以使用一个矩形区域。
    string content = "这是我想要打印的一些内容。它会显示在打印预览中。你可以想象这里是你的报表数据、发票明细或者其他任何需要输出的信息。WinForms的打印机制虽然有点老派，但胜在稳定和可控。很多时候，你可能需要根据实际数据动态生成这些内容。";
    // e.PageSettings.PrintableArea 获取的是当前页面的可打印区域，排除物理边距。
    // 我们可以基于这个区域来计算我们的内容布局。
    RectangleF layoutRectangle = new RectangleF(100, 150, e.PageSettings.PrintableArea.Width - 200, e.PageSettings.PrintableArea.Height - 250);
    g.DrawString(content, bodyFont, blackBrush, layoutRectangle);

    // 别忘了释放资源，虽然这里是局部变量，但养成好习惯，尤其是画刷和字体这种GDI对象。
    titleFont.Dispose();
    bodyFont.Dispose();
    blackBrush.Dispose();

    // 如果还有更多页，设置 e.HasMorePages = true; 这样PrintPage事件会再次触发。
    // 这里先简单处理，只打印一页。
    e.HasMorePages = false;
}

登录后复制

有了

PrintDocument

登录后复制

和它的

PrintPage

登录后复制

事件处理，接下来就是如何展示预览了。最简单直接的方式是使用

PrintPreviewDialog

登录后复制

。

// 假设你有一个按钮来触发打印预览
private void btnShowPreview_Click(object sender, EventArgs e)
{
    PrintPreviewDialog ppd = new PrintPreviewDialog();
    ppd.Document = _printDocument; // 将你的PrintDocument实例赋给它
    ppd.ShowDialog(); // 显示预览对话框
}

登录后复制

这样，一个带有工具栏、缩放、打印按钮的标准预览窗口就弹出来了。简单粗暴，但非常实用。

如何在WinForms打印预览中处理多页内容？

处理多页内容是打印预览中一个非常常见的需求，也是很多初学者会觉得有点儿绕的地方。核心思想是利用

PrintPage

登录后复制

事件的重复触发机制和

e.HasMorePages

登录后复制

属性来控制。

说起来，

PrintPage

登录后复制

事件每次触发，都代表着系统要渲染“当前”这一页的内容。所以，我们需要一个机制来告诉它，现在是第几页，以及这一页要画什么。

ViiTor实时翻译

AI实时多语言翻译专家！强大的语音识别、AR翻译功能。

116

查看详情

通常的做法是引入一个类成员变量来跟踪当前的页码，并在每次

PrintPage

登录后复制

事件触发时更新它。

private PrintDocument _printDocument = new PrintDocument();
private int _currentPage = 0; // 用于跟踪当前打印的页码

public MyForm()
{
    InitializeComponent();
    _printDocument.PrintPage += new PrintPageEventHandler(PrintDocument_PrintPage);
    // 假设你有一个按钮来触发预览
    buttonPreview.Click += (sender, e) =>
    {
        _currentPage = 0; // 在开始打印或预览前，务必重置页码！这是个容易忘记但很关键的步骤。
        PrintPreviewDialog ppd = new PrintPreviewDialog();
        ppd.Document = _printDocument;
        ppd.ShowDialog();
    };
}

private void PrintDocument_PrintPage(object sender, PrintPageEventArgs e)
{
    _currentPage++; // 每次触发事件，页码加1

    Graphics g = e.Graphics;
    Font bodyFont = new Font("Arial", 14);
    SolidBrush blackBrush = new SolidBrush(Color.Black);

    // 根据当前页码绘制不同的内容
    if (_currentPage == 1)
    {
        g.DrawString("这是多页文档的第一页。", bodyFont, blackBrush, 100, 100);
        g.DrawString("内容很多，所以需要分多页显示。", bodyFont, blackBrush, 100, 130);
        // 告诉系统：还有更多页要打印
        e.HasMorePages = true;
    }
    else if (_currentPage == 2)
    {
        g.DrawString("这是多页文档的第二页。", bodyFont, blackBrush, 100, 100);
        g.DrawString("这是第二页的额外内容。", bodyFont, blackBrush, 100, 130);
        // 告诉系统：这是最后一页了，没有更多页了
        e.HasMorePages = false;
    }
    else
    {
        // 如果_currentPage超出了你预期的页数，也应该设置为false，防止无限循环
        e.HasMorePages = false;
    }

    bodyFont.Dispose();
    blackBrush.Dispose();
}

登录后复制

在实际应用中，你可能不会像上面那样硬编码每一页的内容。更常见的情况是，你有一个数据列表，需要在页面上循环渲染。当当前页面的空间不足以容纳剩余数据时，你就设置

e.HasMorePages = true;

登录后复制

，并记录下一次应该从哪个数据项开始绘制，然后

PrintPage

登录后复制

事件会再次触发，为你提供一个全新的页面来继续绘制。这需要更精细的布局计算和状态管理，但基本原理是一样的：

PrintPage

登录后复制

事件是按需触发的，你负责告诉它是否还有下一页。

如何自定义WinForms打印预览的界面和交互？

PrintPreviewDialog

登录后复制

虽然方便，但它是一个模态对话框，而且界面样式固定。有时候，我们希望将打印预览功能直接集成到自己的窗体中，或者添加一些自定义的交互元素，比如更灵活的缩放、页面导航按钮，甚至是在预览旁边显示一些数据摘要。这时，

PrintPreviewControl

登录后复制

就派上用场了。

PrintPreviewDialog

登录后复制

本质上就是包裹了一个

PrintPreviewControl

登录后复制

。所以，我们可以直接在自己的窗体上拖一个

PrintPreviewControl

登录后复制

控件，或者在代码中创建它，然后把它放到一个

Panel

登录后复制

或其他容器里。

private PrintPreviewControl _previewControl = new PrintPreviewControl();

public MyCustomPreviewForm() // 假设这是你的自定义预览窗体
{
    InitializeComponent();

    // 假设你有一个Panel控件叫做panelPreviewHost，用来承载预览内容
    panelPreviewHost.Controls.Add(_previewControl);
    _previewControl.Dock = DockStyle.Fill; // 让预览控件填充整个Panel

    _previewControl.Document = _printDocument; // 绑定你的PrintDocument实例

    // 接下来，你可以添加自定义的按钮和逻辑
    // 例如，一个缩放按钮
    Button btnZoomIn = new Button { Text = "放大", Location = new Point(10, 10) };
    btnZoomIn.Click += (sender, e) =>
    {
        _previewControl.Zoom += 0.1; // 每次点击放大10%
        // Zoom属性的取值范围通常是0.1到10.0
        if (_previewControl.Zoom > 2.0) _previewControl.Zoom = 2.0; // 防止过大
    };
    this.Controls.Add(btnZoomIn); // 将按钮添加到窗体上

    Button btnZoomOut = new Button { Text = "缩小", Location = new Point(100, 10) };
    btnZoomOut.Click += (sender, e) =>
    {
        _previewControl.Zoom -= 0.1;
        if (_previewControl.Zoom < 0.1) _previewControl.Zoom = 0.1; // 防止过小
    };
    this.Controls.Add(btnZoomOut);

    // 页面导航按钮
    Button btnNextPage = new Button { Text = "下一页", Location = new Point(190, 10) };
    btnNextPage.Click += (sender, e) =>
    {
        // 注意：PrintPreviewControl的StartPage属性是基于0的索引
        // 而且它不直接知道总页数，需要你自己管理或估算
        // 这里只是一个简化示例，实际中你可能需要更复杂的逻辑来判断是否还有下一页
        _previewControl.StartPage++;
        // 刷新预览，让更改生效
        _previewControl.InvalidatePreview();
    };
    this.Controls.Add(btnNextPage);

    // 当然，你也可以通过 _previewControl.StartPage = N; 来直接跳转到第N页（0-based）
    // 或者 _previewControl.Rows / _previewControl.Columns 来控制多页显示布局
}

登录后复制

使用