Defines the capabilities of a printer.
Assembly: ReachFramework (in ReachFramework.dll)
Thetype exposes the following members.
|CollationCapability||Gets a collection of values that identify the collation capabilities of a printer.|
|DeviceFontSubstitutionCapability||Gets a collection of values that identify whether and how a printer can substitute device-based fonts for computer-based fonts.|
|DuplexingCapability||Gets a collection of values that identify whether and how a printer can perform two-sided printing.|
|InputBinCapability||Gets a collection of values that indicate what input bin (paper tray) is used.|
|MaxCopyCount||Gets a value indicating the maximum number of copies that the device can print in a single print job.|
|OrientedPageMediaHeight||Gets a value indicating the height of the imageable area on a page, where height means the vertical dimension relative to the page's orientation.|
|OrientedPageMediaWidth||Gets a value indicating the width of the imageable area on a page, where width means the horizontal dimension relative to the page's orientation.|
|OutputColorCapability||Gets a collection of values that specify the ways in which a printer can print content with color and shades of gray.|
|OutputQualityCapability||Gets a collection of values that indicate the types of output quality the printer supports.|
|PageBorderlessCapability||Gets a collection of values that indicate whether the printer can print up to the edge of the media.|
|PageImageableArea||Gets an object that represents the area of a page that the printer can use.|
|PageMediaSizeCapability||Gets a collection of PageMediaSize objects that identify the paper and media sizes that a printer supports.|
|PageMediaTypeCapability||Gets a collection of values that identify what types of paper and other media a printer supports.|
|PageOrderCapability||Gets a collection of values that indicate whether a printer is capable of printing multiple-page documents from front-to-back, back-to-front, or both ways.|
|PageOrientationCapability||Gets a collection of values that identify what types of page orientation a printer supports.|
|PageResolutionCapability||Gets a collection of PageResolution objects that identify what levels of page resolution the printer supports.|
|PageScalingFactorRange||Gets the maximum and minimum percentages by which a printer can enlarge or reduce the print image on a page.|
|PagesPerSheetCapability||Gets a collection of integers, each identifying the number of pages that a user can choose to print on a single side of a sheet of paper.|
|PagesPerSheetDirectionCapability||Gets a collection of values that identify what patterns a printer supports for presenting multiple pages on a single side of a sheet of paper.|
|PhotoPrintingIntentCapability||Gets a collection of values that identify the quality options the printer supports for printing photographs.|
|StaplingCapability||Gets a collection of values that identify the types of automatic stapling that a printer supports.|
|TrueTypeFontModeCapability||Gets a collection of values that identify the methods that a printer supports for handling TrueType fonts.|
|Equals(Object)||Determines whether the specified object is equal to the current object. (Inherited from Object.)|
|GetHashCode||Serves as the default hash function. (Inherited from Object.)|
|GetType||Gets the Type of the current instance. (Inherited from Object.)|
|ToString||Returns a string that represents the current object. (Inherited from Object.)|
A object is an easy-to-work-with representation of a certain type of XML document called a PrintCapabilities document. The latter is a snapshot of all of a printer's capabilities and their current settings. For example, if the printer supports color printing, then the document would have a <PageOutputColor … > element that sets out how color output will be handled. The element is, in turn, represented by the OutputColorCapability property of the object. If the printer does not support color, then there is no <PageOutputColor … > element in the document and the value of the OutputColorCapability property is a null reference (Nothing in Visual Basic). The PrintCapabilities document must conform to the Print Schema.
The class enables your application to obtain a printer's capabilities without having to engage in any direct reading of XML Stream objects.
All of the most popular features of file and photo printers, for both home and business, are encapsulated by the class. But the Print Schema defines many more, less common, features and it can be extended to handle features of specialty printing devices. So, although the PrintTicket and classes cannot be inherited, you can extend the Print Schema to recognize print device features that are not accounted for in the PrintTicket or classes.
Note When the object is created with the constructor that takes a PrintCapabilities document (as a Stream) parameter, that entire document is stored in a non-public field in the object, including the XML elements within it that express less common features that are not represented by any of the public properties of the class. In fact, if the driver that produced the PrintCapabilities document is using a private extension of the Print Schema, that privately defined markup is also stored as part of the non-public PrintCapabilities document.
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.
If you want to print from a Windows Forms application, see the System.Drawing.Printing namespace.
Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.