PrinterSettings.PrinterResolutionCollection Class

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Source:

PrinterSettings.PrinterResolutionCollection.cs

Contains a collection of PrinterResolution objects.

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

public class PrinterSettings.PrinterResolutionCollection : System.Collections.ICollection

type PrinterSettings.PrinterResolutionCollection = class
    interface ICollection
    interface IEnumerable

Public Class PrinterSettings.PrinterResolutionCollection
Implements ICollection

Inheritance

Object

PrinterSettings.PrinterResolutionCollection

Implements

ICollection IEnumerable

Examples

The following code example populates the comboPrintResolution combo box with the supported resolutions. The example requires that a PrintDocument variable named printDoc exists and that the specific combo box exists.

// Add list of printer resolutions found on the printer to the combobox.
// The PrinterResolution's ToString() method will be used to provide the display String.
PrinterResolution^ pkResolution;
for ( int i = 0; i < printDoc->PrinterSettings->PrinterResolutions->Count; i++ )
{
   pkResolution = printDoc->PrinterSettings->PrinterResolutions[ i ];
   comboPrintResolution->Items->Add( pkResolution );
}

// Add list of printer resolutions found on the printer to the combobox.
// The PrinterResolution's ToString() method will be used to provide the display string.

PrinterResolution pkResolution;
for (int i = 0; i < printDoc.PrinterSettings.PrinterResolutions.Count; i++){
    pkResolution = printDoc.PrinterSettings.PrinterResolutions[i];
    comboPrintResolution.Items.Add(pkResolution);
}

' Add list of printer resolutions found on the printer to the combobox.
' The PrinterResolution's ToString() method will be used to provide the display string.
Dim pkResolution As PrinterResolution
For i = 0 to printDoc.PrinterSettings.PrinterResolutions.Count - 1
    pkResolution = printDoc.PrinterSettings.PrinterResolutions.Item(i)
    comboPrintResolution.Items.Add(pkResolution)
Next

Remarks

The PrinterSettings.PrinterResolutionCollection contains PrinterResolution instances that represents the printer resolutions supported through the PrinterResolution.Kind property, which contains one of the PrinterResolutionKind values.

Typically, you set the printer's resolution through the PageSettings.PrinterResolution property to a valid PrinterResolution instance available through the PrinterResolutions collection.

If PrinterResolutionKind is Custom, then use the X and Y properties to determine the custom printer resolution in the horizontal and vertical directions, respectively.

Constructors

PrinterSettings.PrinterResolutionCollection(PrinterResolution[])

Initializes a new instance of the PrinterSettings.PrinterResolutionCollection class.

Properties

Count	Gets the number of available printer resolutions in the collection.
Item[Int32]	Gets the PrinterResolution at a specified index.

Methods

Add(PrinterResolution)	Adds a PrinterResolution to the end of the collection.
CopyTo(PrinterResolution[], Int32)	Copies the contents of the current PrinterSettings.PrinterResolutionCollection 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

• PrinterResolution
• PrinterResolutions
• InstalledPrinters
• PaperSizes
• PaperSources