System.Drawing.Printing 命名空间

System.Drawing.Printing 命名空间提供与打印相关的服务。

通常,您会创建 PrintDocument 类的新实例,设置对打印内容进行描述的属性,然后调用 Print 方法来实际打印文档。

使用 Graphics 属性可指定要打印的输出内容。如果您正在打印文本文件,请按如下方式使用 StreamReader:从输出流中一次读取一行,然后调用 DrawString 方法绘制图形对象中的行。有关此过程的更多信息,请参见 GraphicsStreamReader 类。

提示

不支持 TextRenderer 类的 DrawText 方法进行打印。而应使用 Graphics 类的 DrawString 方法。

当在派生类中实现后,PrintController 控制如何打印 PrintDocumentPrintDocument.Print 方法调用打印控制器的 OnStartPrintOnEndPrintOnStartPage 和 OnEndPage 方法,这些方法指示打印机如何打印文档。有关打印对话框的更多信息,请参见 PrintDialogPageSetupDialog

打印预览进程使用专用的打印控制器、对话框和控件。有关这种打印控制器和对话框的示例,请参见 PreviewPrintControllerPrintPreviewDialogPrintPreviewControl

警告

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

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

委托

  委托 说明
公共委托 PrintEventHandler 表示将对 PrintDocumentBeginPrintEndPrint 事件进行处理的方法。
公共委托 PrintPageEventHandler 表示将要处理 PrintDocumentPrintPage 事件的方法。
公共委托 QueryPageSettingsEventHandler 表示处理 PrintDocumentQueryPageSettings 事件的方法。

枚举

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