PageSettings-Klasse

Artikel
08/20/2007

Gibt Einstellungen an, die auf eine einzelne gedruckte Seite angewendet werden.

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

Syntax

'Declaration
<SerializableAttribute> _
Public Class PageSettings
    Implements ICloneable
'Usage
Dim instance As PageSettings

[SerializableAttribute] 
public class PageSettings : ICloneable

[SerializableAttribute] 
public ref class PageSettings : ICloneable

/** @attribute SerializableAttribute() */ 
public class PageSettings implements ICloneable

SerializableAttribute 
public class PageSettings implements ICloneable

Hinweise

Die PageSettings-Klasse wird zur Angabe von Einstellungen verwendet, mit denen das Drucken einer Seite angepasst wird. Normalerweise werden Standardeinstellungen für alle zu druckenden Seiten durch die PrintDocument.DefaultPageSettings-Eigenschaft festgelegt. Um die Einstellungen für einzelne Seiten anzugeben, müssen Sie das PrintDocument.PrintPage-Ereignis oder das PrintDocument.QueryPageSettings-Ereignis behandeln und das in PrintPageEventArgs bzw. QueryPageSettingsEventArgs enthaltene PageSettings-Argument anpassen.

Weitere Informationen zum Behandeln von PrintDocument-Ereignissen finden Sie unter der Übersicht über die PrintDocument-Klasse. Weitere Informationen zum Drucken finden Sie in der Übersicht über den System.Drawing.Printing-Namespace.

Beispiel

Im folgenden Codebeispiel wird mit der PrintDocument.DefaultPageSettings-Eigenschaft die Standardseitenausrichtung des Dokuments auf Querformat festgelegt, und das Dokument wird unter Verwendung der Print-Methode gedruckt. Für das Beispiel müssen drei Voraussetzungen erfüllt sein:

Die Variable filePath wurde auf den Pfad der zu druckenden Datei festgelegt.
Die Methode pd_PrintPage, die das PrintPage-Ereignis behandelt, wurde definiert.
Die Variable printer wurde auf den Namen des Druckers festgelegt.

Verwenden Sie für dieses Beispiel die Namespaces System.Drawing, System.Drawing.Printing und System.IO.

Public Sub Printing()
    Try
        streamToPrint = New StreamReader(filePath)
        Try
            printFont = New Font("Arial", 10)
            Dim pd As New PrintDocument()
            AddHandler pd.PrintPage, AddressOf pd_PrintPage
            pd.PrinterSettings.PrinterName = printer
            ' Set the page orientation to landscape.
            pd.DefaultPageSettings.Landscape = True
            pd.Print()
        Finally
            streamToPrint.Close()
        End Try
    Catch ex As Exception
        MessageBox.Show(ex.Message)
    End Try
End Sub

public void Printing() {
   try {
     streamToPrint = new StreamReader (filePath);
     try {
       printFont = new Font("Arial", 10);
       PrintDocument pd = new PrintDocument(); 
       pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
       pd.PrinterSettings.PrinterName = printer;
       // Set the page orientation to landscape.
       pd.DefaultPageSettings.Landscape = true;
       pd.Print();
     } 
     finally {
       streamToPrint.Close() ;
     }
   } 
   catch(Exception ex) { 
     MessageBox.Show(ex.Message);
   }
 }

public:
   void Printing()
   {
      try
      {
         streamToPrint = gcnew StreamReader( filePath );
         try
         {
            printFont = gcnew Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler(
               this, &Sample::pd_PrintPage );
            pd->PrinterSettings->PrinterName = printer;
            // Set the page orientation to landscape.
            pd->DefaultPageSettings->Landscape = true;
            pd->Print();
         }
         finally
         {
            streamToPrint->Close();
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }

public void Printing()
{
    try {
        streamToPrint = new StreamReader(filePath);
        try {
            printFont = new Font("Arial", 10);
            PrintDocument pd = new PrintDocument();
            pd.add_PrintPage(new PrintPageEventHandler(pd_PrintPage));
            pd.get_PrinterSettings().set_PrinterName(printer);

            // Set the page orientation to landscape.
            pd.get_DefaultPageSettings().set_Landscape(true);
            pd.Print();
        }
        finally {
            streamToPrint.Close();
        }
    }
    catch (System.Exception ex) {
        MessageBox.Show(ex.get_Message());
    }
} //Printing

Vererbungshierarchie

System.Object
System.Drawing.Printing.PageSettings

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

PageSettings-Member
System.Drawing.Printing-Namespace
PrintDocument
PrinterSettings

Freigeben über