TechNet
Export (0) Print
Expand All

System.Printing Namespace

 

Provides classes that enable you to automate the management of print servers, print queues, and print jobs.

ClassDescription
System_CAPS_pubclassLocalPrintServer

Represents the local print server (the computer on which your application is running) and enables management of its print queues.

System_CAPS_pubclassPageImageableArea

Represents the area of a page that can be printed.

System_CAPS_pubclassPageMediaSize

Describes the page size for paper or other media.

System_CAPS_pubclassPageResolution

Defines the page resolution of printed output as either a qualitative value or as dots per inch, or both.

System_CAPS_pubclassPageScalingFactorRange

Specifies a range of percentages by which a printer can enlarge or reduce the print image on a page.

System_CAPS_pubclassPrintCapabilities

Defines the capabilities of a printer.

System_CAPS_pubclassPrintCommitAttributesException

The exception that is thrown when an error condition prevents some attributes from being committed by a PrintSystemObject to the actual computer, printer, or device that the object represents.

System_CAPS_pubclassPrintDocumentImageableArea

Specifies the size of the paper (or other media), the size of the imageable area, and the location of the imageable area.

System_CAPS_pubclassPrintDriver

Represents a print driver.

System_CAPS_pubclassPrintFilter

Defines disposal behavior that is common to both the PrintDriver and PrintProcessor classes. PrintFilter supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code.

System_CAPS_pubclassPrintingCanceledException

The exception that occurs when code attempts to access a canceled print job.

System_CAPS_pubclassPrintingNotSupportedException

The exception that is thrown when a printing operation is not supported.

System_CAPS_pubclassPrintJobException

The exception that occurs when the print job does not run correctly.

System_CAPS_pubclassPrintJobInfoCollection

Represents one or more PrintSystemJobInfo objects.

System_CAPS_pubclassPrintJobSettings

Describes a print job.

System_CAPS_pubclassPrintPort

Represents a printer port on a print server. Each print queue has a print port assigned to it.

System_CAPS_pubclassPrintProcessor

Represents a print processor on a print server.

System_CAPS_pubclassPrintQueue

Manages printers and print jobs.

System_CAPS_pubclassPrintQueueCollection

Represents a collection of PrintQueue objects.

System_CAPS_pubclassPrintQueueException

The exception that is thrown when an error condition prevents the accessing or creation of a PrintQueue.

System_CAPS_pubclassPrintQueueStream

A stream that represents a spooled print job in a print queue.

System_CAPS_pubclassPrintQueueStringProperty

Represents one, and only one, of three possible properties of a print queue: Location, Comment, or ShareName.

System_CAPS_pubclassPrintServer

Manages the print queues on a print server, which is usually a computer, but can be a dedicated hardware print server appliance.

System_CAPS_pubclassPrintServerException

The exception that occurs when an error condition prevents the accessing or creation of a PrintServer.

System_CAPS_pubclassPrintSystemException

The exception that occurs when an error condition prevents accessing or creating a PrintSystemObject.

System_CAPS_pubclassPrintSystemJobInfo

Defines a print job in detail.

System_CAPS_pubclassPrintSystemObject

Defines basic properties and methods that are common to the objects of the printing system. Classes that derive from this class represent such objects as print queues, print servers, and print jobs.

System_CAPS_pubclassPrintSystemObjectPropertiesChangedEventArgs

Provides data for a PropertiesChanged event, which you must create.

System_CAPS_pubclassPrintSystemObjectPropertyChangedEventArgs

Provides data for a PropertyChanged event, which you must create.

System_CAPS_pubclassPrintSystemObjects

Represents a collection of print system objects.

System_CAPS_pubclassPrintTicket

Defines the settings of a print job.

StructureDescription
System_CAPS_pubstructureValidationResult

Represents a merged PrintTicket that is guaranteed to be viable, with a report of any settings that were changed to make it viable.

EnumerationDescription
System_CAPS_pubenumCollation

Specifies whether a printer collates output when it prints multiple copies of a multi-page print job.

System_CAPS_pubenumConflictStatus

Specifies whether any changes were made to a merged PrintTicket to ensure a viable PrintTicket.

System_CAPS_pubenumDeviceFontSubstitution

Specifies whether device font substitution is enabled on a printer.

System_CAPS_pubenumDuplexing

Specifies whether a printer uses one-sided printing or some type of two-sided (duplex) printing.

System_CAPS_pubenumEnumeratedPrintQueueTypes

Specifies attributes of print queues.

System_CAPS_pubenumInputBin

Specifies the input bin that is used as the source of blank paper or other print media.

System_CAPS_pubenumLocalPrintServerIndexedProperty

Specifies the properties of a LocalPrintServer object that are initialized when it is constructed.

System_CAPS_pubenumOutputColor

Specifies how to print content that contains color or shades of gray.

System_CAPS_pubenumOutputQuality

Specifies the types of output quality for a print device.

System_CAPS_pubenumPageBorderless

Specifies whether a print device prints to the edge of the media or provides an unprinted margin around the edge.

System_CAPS_pubenumPageMediaSizeName

Specifies the page size or roll width of the paper or other print media.

System_CAPS_pubenumPageMediaType

Specifies types of printing paper or other media.

System_CAPS_pubenumPageOrder

Specifies whether a print device prints multi-page documents from front-to-back or back-to-front.

System_CAPS_pubenumPageOrientation

Specifies how pages of content are oriented on print media.

System_CAPS_pubenumPageQualitativeResolution

Specifies the page resolution as a qualitative, non-numerical, value.

System_CAPS_pubenumPagesPerSheetDirection

Specifies the arrangement of pages when more than one page of content appears on a single side of print media.

System_CAPS_pubenumPhotoPrintingIntent

Specifies the quality of output when a photograph is printed. The printer driver translates the PhotoPrintingIntent into quantitative values for resolution and other quality factors.

System_CAPS_pubenumPrintJobPriority

Specifies a non-numerical priority for a print job relative to other print jobs in the print queue.

System_CAPS_pubenumPrintJobStatus

Specifies the current status of a print job in a print queue.

System_CAPS_pubenumPrintJobType

Specifies whether the print job uses XML Paper Specification (XPS).

System_CAPS_pubenumPrintQueueAttributes

Specifies the attributes of a print queue and its printer.

System_CAPS_pubenumPrintQueueIndexedProperty

Specifies the properties that are initialized when a PrintQueue object is constructed.

System_CAPS_pubenumPrintQueueStatus

Specifies the status of a print queue or its printer.

System_CAPS_pubenumPrintQueueStringPropertyType

Specifies the intended meaning of a PrintQueueStringProperty.

System_CAPS_pubenumPrintServerEventLoggingTypes

Specifies the types of events that can be logged by a PrintServer.

System_CAPS_pubenumPrintServerIndexedProperty

Specifies the properties of a PrintServer object that are initialized when it is constructed.

System_CAPS_pubenumPrintSystemDesiredAccess

Specifies the different access rights (or levels of access) for printing objects.

System_CAPS_pubenumPrintSystemObjectLoadMode

Specifies whether the properties of an object are initialized when the object loads.

System_CAPS_pubenumPrintTicketScope

Specifies whether a PrintTicket applies to an entire print job, one document within the print job, or just a page within the print job.

System_CAPS_pubenumStapling

Specifies whether, and where, a printer staples a multi-page document.

System_CAPS_pubenumTrueTypeFontMode

Specifies how a printer handles text that is formatted with a TrueType font.

This namespace contains the following core classes:

  • The PrintSystemObject class, which is the base class for the other core printing classes.

  • The PrintServer class, which represents an actual print server, usually a computer.

  • The PrintQueue class, which represents an actual print queue and its printer.

  • The PrintSystemJobInfo class, which represents a particular print job.

  • The PrintTicket class, which instructs the printer how to process a print job.

Classes derived from the PrintSystemObject class each have a Commit and a Refresh method. You must use these methods to ensure that instances of the classes are synchronized with the hardware or software components that they represent.

The System.Printing namespace also includes many enumerations that describe printer capabilities, such as whether a printer can produce collated output, and that specify instructions to printers, such as the paper size to use for a print job.

This namespace is part of the enhanced printing services provided with Windows Presentation Foundation (WPF). Managed code developers using Windows Forms must use the API in the System.Drawing.Printing namespace.

System_CAPS_cautionCaution

Classes within the System.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Return to top
Show:
© 2016 Microsoft