PaperSize-Klasse

Artikel
08/20/2007

Gibt die Größe eines Blatt Papiers an.

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

Syntax

'Declaration
<SerializableAttribute> _
Public Class PaperSize
'Usage
Dim instance As PaperSize

[SerializableAttribute] 
public class PaperSize

[SerializableAttribute] 
public ref class PaperSize

/** @attribute SerializableAttribute() */ 
public class PaperSize

SerializableAttribute 
public class PaperSize

Hinweise

Diese Klasse wird von der PrinterSettings.PaperSizes-Eigenschaft und von der PageSettings.PaperSize-Eigenschaft verwendet, um die für den Drucker verfügbaren Papiergrößen abzurufen bzw. um die Papiergröße für eine Seite festzulegen.

Sie können den PaperSize-Konstruktor verwenden, um eine benutzerdefinierte Papiergröße anzugeben. Der Width-Eigenschaftenwert und der Height-Eigenschaftenwert können nur für benutzerdefinierte PaperSize-Objekte festgelegt werden.

Weitere Informationen zum Drucken finden Sie in der Übersicht über den System.Drawing.Printing-Namespace.

Beispiel

Im folgenden Codebeispiel wird das comboPaperSize-Kombinationsfeld mit den unterstützten Papierformaten des Druckers aufgefüllt. Außerdem wird ein benutzerdefiniertes Papierformat erstellt und dem Kombinationsfeld hinzugefügt. Der PaperName wird als die Eigenschaft identifiziert, die die Anzeigezeichenfolge für das Element bereitstellt, das von der DisplayMember-Eigenschaft des Kombinationsfelds hinzugefügt wird. Im Beispiel wird davon ausgegangen, dass die PrintDocument-Variable printDoc und das bestimmte Kombinationsfeld vorhanden sind.

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

// 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";
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.set_DisplayMember("PaperName");

PaperSize pkSize;
for (int i = 0; i < printDoc.get_PrinterSettings().get_PaperSizes().
    get_Count(); i++) {
    pkSize = printDoc.get_PrinterSettings().get_PaperSizes().
        get_Item(i);
    comboPaperSize.get_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.get_Items().Add(pkCustomSize1);

Vererbungshierarchie

System.Object
System.Drawing.Printing.PaperSize

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PaperSize-Member
System.Drawing.Printing-Namespace
Kind
PrinterSettings
PrinterSettings.PaperSizes
PageSettings.PaperSize-Eigenschaft
ListControl.DisplayMember

Freigeben über