PrintTicket.PagesPerSheet Property

Reference

Definition

Namespace:: System.Printing

Assembly:: ReachFramework.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the number of pages that print on each printed side of a sheet of paper.

public:
 property Nullable<int> PagesPerSheet { Nullable<int> get(); void set(Nullable<int> value); };

public int? PagesPerSheet { get; set; }

member this.PagesPerSheet : Nullable<int> with get, set

Public Property PagesPerSheet As Nullable(Of Integer)

Property Value

Nullable<Int32>

A nullable Int32 value that represents the number of pages that print on each printed side of a sheet of paper.

Exceptions

ArgumentOutOfRangeException

Calling code has attempted to set the property to a value that is less than 1.

Remarks

Most printers support only a limited range of specific possibilities, such as 1, 2, 4, 6, 8, and 16 pages per side. You can test for the options that the printer supports by using the PagesPerSheetCapability property.

A null value for this property means that this feature setting is not specified. Also, when the value is null, the XML versions of the PrintTicket (see SaveTo and GetXmlStream) will not contain any markup for this feature.

This property corresponds to the PagesPerSheetScoredProperty of the Print Schema's JobNUpAllDocumentsContiguously keyword, not the DocumentNUp keyword.

You can test for the options that the printer supports by using the PagesPerSheetCapability property.

Applies to