PrinterSettings.PaperSizeCollection Class

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Contains a collection of PaperSize objects.

public: ref class PrinterSettings::PaperSizeCollection : System::Collections::ICollection

public class PrinterSettings.PaperSizeCollection : System.Collections.ICollection

type PrinterSettings.PaperSizeCollection = class
    interface ICollection
    interface IEnumerable

Public Class PrinterSettings.PaperSizeCollection
Implements 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.

// 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 = gcnew PaperSize( "First custom size",100,200 );
comboPaperSize->Items->Add( pkCustomSize1 );

// 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);

' 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"

Dim pkSize As PaperSize
For i = 0 to printDoc.PrinterSettings.PaperSizes.Count - 1
    pkSize = printDoc.PrinterSettings.PaperSizes.Item(i)
    comboPaperSize.Items.Add(pkSize)
Next

' Create a PaperSize and specify the custom paper size through the constructor and add to combobox.
Dim pkCustomSize1 As New PaperSize("Custom Paper 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.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetEnumerator()	Returns an enumerator that can iterate through the collection.
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

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

See also

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