PrintDocument.DefaultPageSettings-Eigenschaft

Ruft die Seiteneinstellungen ab, die standardmäßig für alle zu druckenden Seiten verwendet werden, oder legt diese fest.

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

Syntax

'Declaration
Public Property DefaultPageSettings As PageSettings
'Usage
Dim instance As PrintDocument
Dim value As PageSettings

value = instance.DefaultPageSettings

instance.DefaultPageSettings = value

public PageSettings DefaultPageSettings { get; set; }

public:
property PageSettings^ DefaultPageSettings {
    PageSettings^ get ();
    void set (PageSettings^ value);
}

/** @property */
public PageSettings get_DefaultPageSettings ()

/** @property */
public void set_DefaultPageSettings (PageSettings value)

public function get DefaultPageSettings () : PageSettings

public function set DefaultPageSettings (value : PageSettings)

Eigenschaftenwert

Eine PageSettings-Eigenschaft, die die Standardseiteneinstellungen des Dokuments angibt.

Hinweise

Über die DefaultPageSettings-Eigenschaft können Sie mehrere Standardseiteneinstellungen festlegen. Die PageSettings.Color-Eigenschaft gibt z. B. an, ob eine Seite in Farbe gedruckt wird, die PageSettings.Landscape-Eigenschaft gibt an, ob eine Seite im Hochformat oder im Querformat gedruckt wird, und die PageSettings.Margins-Eigenschaft legt die Seitenränder fest.

Um die Einstellungen für einzelne Seite anzugeben, müssen Sie das PrintPage-Ereignis oder das QueryPageSettings-Ereignis behandeln und das in PrintPageEventArgs bzw. QueryPageSettingsEventArgs enthaltene PageSettings-Argument anpassen.

Hinweis

Nachdem dem starten des Druckvorgangs haben über die DefaultPageSettings-Eigenschaft durchgeführte Änderungen an den Seiteneinstellungen keine Auswirkungen auf die gerade gedruckten Seiten.

Beispiel

Im folgenden Codebeispiel wird als Seitenausrichtung eines Dokuments das Querformat festgelegt. Anschließend wird das Dokument gedruckt. Für das Beispiel müssen drei Voraussetzungen erfüllt sein: Eine Variable mit dem Namen filePath muss auf den Pfad der zu druckenden Datei festgelegt sein, eine Methode mit dem Namen pd_PrintPage muss zur Behandlung des PrintPage-Ereignisses definiert sein, und eine Variable mit dem Namen printer muss auf den Namen des Druckers festgelegt sein.

Verwenden Sie für dieses Beispiel die folgenden 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 System::Drawing::Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler(
               this, &Form1::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

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

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