System.Drawing.Printing 命名空间
System.Drawing.Printing 命名空间提供与打印相关的服务。
通常,您会创建 PrintDocument 类的新实例,设置对打印内容进行描述的属性,然后调用 Print 方法来实际打印文档。
使用 Graphics 属性可指定要打印的输出内容。如果您正在打印文本文件,请按如下方式使用 StreamReader:从输出流中一次读取一行,然后调用 DrawString 方法绘制图形对象中的行。有关此过程的更多信息,请参见 Graphics 和 StreamReader 类。
提示
不支持 TextRenderer 类的 DrawText 方法进行打印。而应使用 Graphics 类的 DrawString 方法。
当在派生类中实现后,PrintController 控制如何打印 PrintDocument。PrintDocument.Print 方法调用打印控制器的 OnStartPrint、OnEndPrint、OnStartPage 和 OnEndPage 方法,这些方法指示打印机如何打印文档。有关打印对话框的更多信息,请参见 PrintDialog 和 PageSetupDialog。
打印预览进程使用专用的打印控制器、对话框和控件。有关这种打印控制器和对话框的示例,请参见 PreviewPrintController、PrintPreviewDialog 和 PrintPreviewControl。
警告
不支持在 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 | 提供有关 BeginPrint 和 EndPrint 事件的数据。 | |
PrintingPermission | 控制对打印机的访问。无法继承此类。 | |
PrintingPermissionAttribute | 允许进行声明打印权限检查。 | |
PrintPageEventArgs | 为 PrintPage 事件提供数据。 | |
QueryPageSettingsEventArgs | 为 QueryPageSettings 事件提供数据。 | |
StandardPrintController | 指定一个打印控制器,它向打印机发送信息。 |
委托
委托 | 说明 | |
---|---|---|
PrintEventHandler | 表示将对 PrintDocument 的 BeginPrint 或 EndPrint 事件进行处理的方法。 | |
PrintPageEventHandler | 表示将要处理 PrintDocument 的 PrintPage 事件的方法。 | |
QueryPageSettingsEventHandler | 表示处理 PrintDocument 的 QueryPageSettings 事件的方法。 |
枚举
枚举 | 说明 | |
---|---|---|
Duplex | 指定打印机的双面打印设置。 | |
PaperKind | 指定标准的纸张大小。 | |
PaperSourceKind | 标准的纸张来源。 | |
PrintAction | 指定正在进行的打印操作的类型。 | |
PrinterResolutionKind | 指定打印机的分辨率。 | |
PrinterUnit | 指定几个用于打印的度量单位。 | |
PrintingPermissionLevel | 指定允许代码进行的打印类型。 | |
PrintRange | 指定要打印的文档部分。 |