PrinterSettings.PaperSizeCollection-Klasse

Artikel
08/20/2007

Enthält eine Auflistung von PaperSize-Objekten.

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

Syntax

'Declaration
Public Class PaperSizeCollection
    Implements ICollection, IEnumerable
'Usage
Dim instance As PaperSizeCollection

public class PaperSizeCollection : ICollection, IEnumerable

public ref class PaperSizeCollection : ICollection, IEnumerable

public class PaperSizeCollection implements ICollection, IEnumerable

public class PaperSizeCollection implements ICollection, IEnumerable

Hinweise

Die PrinterSettings.PaperSizeCollection enthält Instanzen von PaperSize, die die Papiergröße mithilfe der PaperSize.Kind-Eigenschaft darstellt. Diese Eigenschaft einhält einen der PaperKind-Werte.

Üblicherweise legen Sie die Papiergröße der Seite mithilfe der PageSettings.PaperSize-Eigenschaft auf eine gültige PaperSize-Instanz fest, die über die PaperSizes-Auflistung verfügbar ist.

Informationen darüber, wie Sie eine benutzerdefinierte Papiergröße festlegen können, finden Sie unter PaperSize-Konstruktor.

Beispiel

Das folgende Codebeispiel füllt das comboPaperSize-Kombinationsfeld mit den unterstützten Papierformaten des Druckers. 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. Für dieses Beispiel müssen eine PrintDocument-Variable mit dem Namen printDoc und das angegebene Kombinationsfeld vorhanden sein.

' 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.PrinterSettings.PaperSizeCollection

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

PrinterSettings.PaperSizeCollection-Member
System.Drawing.Printing-Namespace
PaperSize-Klasse
PrinterSettings.PaperSizes-Eigenschaft
PrinterSettings.InstalledPrinters-Eigenschaft
PrinterSettings.PaperSources-Eigenschaft
PrinterSettings.PrinterResolutions-Eigenschaft
ListControl.DisplayMember

Freigeben über