PrintTicket.InputBin Property

Definition

Namespace:

System.Printing

Assembly:

ReachFramework.dll

Gets or sets a value indicating what input bin (paper tray) to use.

public:
 property Nullable<System::Printing::InputBin> InputBin { Nullable<System::Printing::InputBin> get(); void set(Nullable<System::Printing::InputBin> value); };

public System.Printing.InputBin? InputBin { get; set; }

member this.InputBin : Nullable<System.Printing.InputBin> with get, set

Public Property InputBin As Nullable(Of InputBin)

Property Value

Nullable<InputBin>

An InputBin value indicating what input tray is used and whether it is chosen manually or automatically.

Exceptions

ArgumentOutOfRangeException

Calling code has attempted to set the property to a value that is not in the InputBin enumeration.

Remarks

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. That is, there will be no markup for the Print Schema's features JobInputBin, DocumentInputBin, or PageInputBin.

When this property is not null, it will have the following relationships to the features defined in the Print Schema.

• If the XML form of the PrintTicket contains JobInputBin, then this property has the same value as JobInputBin (regardless of whether or not there is also DocumentInputBin or PageInputBin. markup in the XML version of the PrintTicket).

• If there is no JobInputBin markup, but there is DocumentInputBin, then this property has the same value as DocumentInputBin (regardless of whether or not there is also PageInputBin markup) present.

• If there is neither JobInputBin nor DocumentInputBin markup, but there is PageInputBin markup, then this property has the same value as PageInputBin.

When this property is set to any InputBin value, then matching JobInputBin markup will be added to the XML print ticket and any DocumentInputBin and PageInputBin markup that is already there will be removed.

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