System.Drawing.Printing 命名空间

为Windows 窗体应用程序提供与打印相关的服务。

类

InvalidPrinterException	表示当尝试用无效的打印机设置来访问打印机时所引发的异常。
Margins	指定打印页的边距尺寸。
MarginsConverter	为 MarginsConverter 提供一个 Margins。
PageSettings	指定应用于单页打印的设置。
PaperSize	指定纸张大小。
PaperSource	指定给打印机送纸的纸盒。
PreviewPageInfo	为单页指定打印预览信息。 此类不能被继承。
PreviewPrintController	指定一个打印控制器，它在屏幕上将文档显示为一系列图像。
PrintController	控制在从 Windows 窗体应用程序打印时如何打印文档。
PrintDocument	从 Windows 窗体应用程序打印时，定义一种可重用的可发送到打印机上的对象。
PrinterResolution	表示打印机支持的分辨率。
PrinterSettings	指定有关在从 Windows 窗体应用程序打印时如何打印文档的信息，包括打印文档的打印机。
PrinterSettings.PaperSizeCollection	包含 PaperSize 对象的集合。
PrinterSettings.PaperSourceCollection	包含 PaperSource 对象的集合。
PrinterSettings.PrinterResolutionCollection	包含 PrinterResolution 对象的集合。
PrinterSettings.StringCollection	包含 String 对象的集合。
PrinterUnitConvert	指定在与 Win32 打印 API 互操作时使用的一系列转换方法。 此类不能被继承。
PrintEventArgs	提供有关 BeginPrint 和 EndPrint 事件的数据。
PrintingPermission	控制对打印机的访问。 此类不能被继承。
PrintingPermissionAttribute	允许进行声明打印权限检查。
PrintPageEventArgs	为 PrintPage 事件提供数据。
QueryPageSettingsEventArgs	为 QueryPageSettings 事件提供数据。
StandardPrintController	指定一个打印控制器，它向打印机发送信息。

枚举

Duplex	指定打印机的双面打印设置。
PaperKind	指定标准纸张大小。
PaperSourceKind	标准的纸张来源。
PrintAction	指定正在进行的打印操作的类型。
PrinterResolutionKind	指定打印机的分辨率。
PrinterUnit	指定几个用于打印的度量单位。
PrintingPermissionLevel	指定允许代码进行的打印类型。
PrintRange	指定要打印的文档部分。

委托

PrintEventHandler	表示将对 BeginPrint 的 EndPrint 或 PrintDocument 事件进行处理的方法。
PrintPageEventHandler	表示将用来处理 PrintPage 的 PrintDocument 事件的方法。
QueryPageSettingsEventHandler	表示处理 PrintDocument 的 QueryPageSettings 事件的方法。

注解

通常，从 Windows 窗体 应用程序打印时，会创建 类的新实例PrintDocument，设置描述如何打印的属性（如 DefaultPageSettings 和 PrinterSettings），并调用 Print 方法来实际打印文档。 PrintDocument.Print调用 方法会PrintDocument.PrintPage引发 事件，应处理该事件以执行文档布局进行打印。

Graphics使用从 PrintDocument.PrintPage 事件获取的 PrintPageEventArgs 对象的 属性指定要打印的输出。 如果要打印文本文件，请使用 StreamReader 从流中一次读取一行，并调用 DrawString 方法在图形对象中绘制线条。 有关此过程的详细信息，请参阅 Graphics 和 StreamReader 类。 可以在类概述主题中 PrintDocument 查看打印文本文档的示例。

注意

TextRenderer 类的 DrawText 方法不支持打印。 请改用 DrawString 类的 Graphics 方法。

在派生类中实现时， PrintController 控制的打印方式 PrintDocument 。 方法 PrintDocument.Print 调用打印控制器的 OnStartPrint、 OnEndPrint、 OnStartPage和 OnEndPage 方法，这些方法又告诉打印机如何打印文档。 有关打印对话框的详细信息，请参阅 PrintDialog 和 PageSetupDialog。

打印预览过程使用专用的打印控制器、对话框和控件。 有关此类打印控制器和对话框的示例，请参阅 PreviewPrintController、 PrintPreviewDialog和 PrintPreviewControl。

注意

不支持在 System.Drawing.Printing Windows 服务或 ASP.NET 应用程序或服务中使用命名空间中的类。 尝试从这些应用程序类型之一中使用这些类可能会产生意外问题，例如服务性能下降和运行时异常。

如果要从Windows Presentation Foundation (WPF) 应用程序进行打印，请参阅 System.Printing 命名空间。

另请参阅

• PrintDialog
• Windows 窗体打印支持