System.Printing 命名空间
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
提供使你能够自动管理打印服务器、打印队列和打印作业的类。
类
| 名称 | 说明 |
|---|---|
| LocalPrintServer |
表示本地打印服务器(应用程序正在运行的计算机),并启用其打印队列的管理。 |
| PageImageableArea |
表示可打印的页面区域。 |
| PageMediaSize |
描述纸张或其他媒体的页面大小。 |
| PageResolution |
将打印输出的页面分辨率定义为定性值或每英寸点,或同时定义两者。 |
| PageScalingFactorRange |
指定打印机可以放大或减少页面上打印图像的百分比范围。 |
| PrintCapabilities |
定义打印机的功能。 |
| PrintCommitAttributesException |
当错误条件阻止某些属性提交 PrintSystemObject 到对象所表示的实际计算机、打印机或设备时引发的异常。 |
| PrintDocumentImageableArea |
指定纸张的大小(或其他媒体)、可图像区域的大小以及可图像区域的位置。 |
| PrintDriver |
表示打印驱动程序。 |
| PrintFilter |
定义两者通用的 PrintDriver 处置行为和 PrintProcessor 类。 PrintFilter支持Windows Presentation Foundation(WPF)基础结构,不打算直接从代码使用。 |
| PrintingCanceledException |
当代码尝试访问已取消的打印作业时发生的异常。 |
| PrintingNotSupportedException |
不支持打印操作时引发的异常。 |
| PrintJobException |
打印作业未正确运行时发生的异常。 |
| PrintJobInfoCollection |
表示一个或多个 PrintSystemJobInfo 对象。 |
| PrintJobSettings |
描述打印作业。 |
| PrintPort |
表示打印服务器上的打印机端口。 每个打印队列都有一个分配给它的打印端口。 |
| PrintProcessor |
表示打印服务器上的打印处理器。 |
| PrintQueue |
管理打印机和打印作业。 |
| PrintQueueCollection |
表示 对象的集合 PrintQueue 。 |
| PrintQueueException |
错误条件阻止访问或创建异常时引发的 PrintQueue异常。 |
| PrintQueueStream |
表示打印队列中的后台打印作业的流。 |
| PrintQueueStringProperty | |
| PrintServer |
管理打印服务器上的打印队列,该服务器通常是计算机,但可以是专用的硬件打印服务器设备。 |
| PrintServerException |
当错误条件阻止访问或创建 PrintServer异常时发生的异常。 |
| PrintSystemException |
当错误条件阻止访问或创建 PrintSystemObject异常时发生的异常。 |
| PrintSystemJobInfo |
详细定义打印作业。 |
| PrintSystemObject |
定义打印系统对象通用的基本属性和方法。 派生自此类的类表示打印队列、打印服务器和打印作业等对象。 |
| PrintSystemObjectPropertiesChangedEventArgs |
为 PropertiesChanged 事件提供必须创建的数据。 |
| PrintSystemObjectPropertyChangedEventArgs |
提供 PropertyChanged 事件的数据,必须创建该事件。 |
| PrintSystemObjects |
表示打印系统对象的集合。 |
| PrintTicket |
定义打印作业的设置。 |
结构
| 名称 | 说明 |
|---|---|
| ValidationResult |
表示一个可保证可行的合并 PrintTicket 项,并报告已更改的任何设置,使其可行。 |
枚举
| 名称 | 说明 |
|---|---|
| Collation |
指定打印机是否在打印多页打印作业的多个副本时对输出进行排序。 |
| ConflictStatus |
指定是否对合并 PrintTicket 进行任何更改以确保可行的 PrintTicket。 |
| DeviceFontSubstitution |
指定是否在打印机上启用设备字体替换。 |
| Duplexing |
指定打印机是使用单面打印还是某种类型的双面(双面)打印。 |
| EnumeratedPrintQueueTypes |
指定打印队列的属性。 |
| InputBin |
指定用作空白纸或其他打印介质源的输入箱。 |
| LocalPrintServerIndexedProperty |
指定在构造 LocalPrintServer 对象时初始化的属性。 |
| OutputColor |
指定如何打印包含灰色颜色或阴影的内容。 |
| OutputQuality |
指定打印设备的输出质量类型。 |
| PageBorderless |
指定打印设备是打印到媒体边缘还是提供边缘周围的未打印边距。 |
| PageMediaSizeName |
指定纸张或其他打印介质的页面大小或卷宽。 |
| PageMediaType |
指定打印纸张或其他媒体的类型。 |
| PageOrder |
指定打印设备是从前到后还是从头到前打印多页文档。 |
| PageOrientation |
指定内容页面如何面向打印媒体。 |
| PageQualitativeResolution |
将页面分辨率指定为定性、非数值。 |
| PagesPerSheetDirection |
指定当多页内容出现在打印媒体的一侧时,页面的排列方式。 |
| PhotoPrintingIntent |
指定打印照片时输出的质量。 打印机驱动程序将 PhotoPrintingIntent 转换为分辨率和其他质量因素的定量值。 |
| PrintJobPriority |
指定打印作业相对于打印队列中的其他打印作业的非数值优先级。 |
| PrintJobStatus |
指定打印队列中打印作业的当前状态。 |
| PrintJobType |
指定打印作业是否使用 XML 纸张规范(XPS)。 |
| PrintQueueAttributes |
指定打印队列及其打印机的属性。 |
| PrintQueueIndexedProperty |
指定在构造 PrintQueue 对象时初始化的属性。 |
| PrintQueueStatus |
指定打印队列或其打印机的状态。 |
| PrintQueueStringPropertyType |
指定 PrintQueueStringProperty的预期含义。 |
| PrintServerEventLoggingTypes |
指定可由 PrintServer记录的事件的类型。 |
| PrintServerIndexedProperty |
指定在构造 PrintServer 对象时初始化的属性。 |
| PrintSystemDesiredAccess |
指定打印对象的不同访问权限(或访问权限级别)。 |
| PrintSystemObjectLoadMode |
指定对象加载时是否初始化对象的属性。 |
| PrintTicketScope |
指定 PrintTicket 是应用于整个打印作业、打印作业中的一个文档还是仅应用于打印作业中的页面。 |
| Stapling |
指定打印机是否在何处装订多页文档。 |
| TrueTypeFontMode |
指定打印机如何处理使用 TrueType 字体设置格式的文本。 |
注解
此命名空间包含以下核心类:
该 PrintSystemObject 类是其他核心打印类的基类。
表示 PrintServer 实际打印服务器的类,通常是计算机。
表示 PrintQueue 实际打印队列及其打印机的类。
表示 PrintSystemJobInfo 特定打印作业的类。
该 PrintTicket 类指示打印机如何处理打印作业。
派生自类的 PrintSystemObject 类都有一个 Commit 和一个 Refresh 方法。 必须使用这些方法来确保类的实例与它们所表示的硬件或软件组件同步。
该 System.Printing 命名空间还包括许多枚举,这些枚举描述了打印机功能,例如打印机是否可以生成排序规则输出,以及指定打印机的说明,例如用于打印作业的纸张大小。
此命名空间是Windows Presentation Foundation提供的增强打印服务的一部分。 使用 Windows 窗体 的托管代码开发人员必须使用 System.Drawing.Printing 命名空间中的 API。
Caution
命名空间中的 System.Printing 类不支持在 Windows 服务或 ASP.NET 应用程序或服务中使用。 尝试在这些应用程序类型之一内使用这些类可能会导致意外问题,例如服务性能和运行时异常的降低。