Export (0) Print
Expand All

PaperSize Class

Specifies the size of a piece of paper.

Namespace:  System.Drawing.Printing
Assembly:  System.Drawing (in System.Drawing.dll)

[SerializableAttribute]
public class PaperSize

This class is used by the PrinterSettings.PaperSizes and PageSettings.PaperSize properties to get the paper sizes that are available on the printer and to set the paper size for a page, respectively.

You can use the PaperSize constructor to specify a custom paper size. The Width and Height property values can be set only for custom PaperSize objects.

For more information about printing, see the System.Drawing.Printing namespace overview.

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 will provide the display string for the item being added through the DisplayMember property of the combo box. The example assumes 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 = new PaperSize("First custom size", 100, 200);

comboPaperSize.Items.Add(pkCustomSize1);

System.Object
  System.Drawing.Printing.PaperSize

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

Community Additions

ADD
Show:
© 2014 Microsoft