PrinterSettings.PaperSizeCollection Class

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Source:

PrinterSettings.PaperSizeCollection.cs

Contains a collection of PaperSize objects.

C#

public class PrinterSettings.PaperSizeCollection : System.Collections.ICollection

Inheritance

Object

PrinterSettings.PaperSizeCollection

Implements

ICollection IEnumerable

Examples

The following code example populates the comboPaperSize combo box with the printer's supported paper sizes. In addition, a custom paper size is created and added to the combo box. The PaperName is identified as the property that provides the display string for the item being added through the DisplayMember property of the combo box. The example requires that a PrintDocument variable named printDoc exists and that the specific combo box exists.

C#

// Add list of supported paper sizes found on the printer. 
// The DisplayMember property is used to identify the property that will provide the display string.
comboPaperSize.DisplayMember = "PaperName";

PaperSize pkSize;
for (int i = 0; i < printDoc.PrinterSettings.PaperSizes.Count; i++){
    pkSize = printDoc.PrinterSettings.PaperSizes[i];
    comboPaperSize.Items.Add(pkSize);
}

// Create a PaperSize and specify the custom paper size through the constructor and add to combobox.
PaperSize pkCustomSize1 = new PaperSize("First custom size", 100, 200);

comboPaperSize.Items.Add(pkCustomSize1);

Remarks

The PrinterSettings.PaperSizeCollection contains PaperSize instances that represents the paper sizes through the PaperSize.Kind property, which contains one of the PaperKind values.

Typically, you set a page's paper size through the PageSettings.PaperSize property to a valid PaperSize instance available through the PaperSizes collection.

See the PaperSize constructor to find out how you can specify a custom paper size.

Constructors

PrinterSettings.PaperSizeCollection(PaperSize[])

Initializes a new instance of the PrinterSettings.PaperSizeCollection class.

Properties

Count	Gets the number of different paper sizes in the collection.
Item[Int32]	Gets the PaperSize at a specified index.

Methods

Add(PaperSize)	Adds a PrinterResolution to the end of the collection.
CopyTo(PaperSize[], Int32)	Copies the contents of the current PrinterSettings.PaperSizeCollection to the specified array, starting at the specified index.
GetEnumerator()	Returns an enumerator that can iterate through the collection.

Explicit Interface Implementations

ICollection.CopyTo(Array, Int32)	For a description of this member, see CopyTo(Array, Int32).
ICollection.Count	For a description of this member, see Count.
ICollection.IsSynchronized	For a description of this member, see IsSynchronized.
ICollection.SyncRoot	For a description of this member, see SyncRoot.
IEnumerable.GetEnumerator()	For a description of this member, see GetEnumerator().

Extension Methods

Applies to

See also

• PaperSize
• PaperSizes
• InstalledPrinters
• PaperSources
• PrinterResolutions
• DisplayMember