PrintDocument.PrinterSettings-Eigenschaft

Artikel
08/20/2007

Ruft den Drucker ab, auf dem das Dokument gedruckt wird, oder legt diesen fest.

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

Syntax

'Declaration
Public Property PrinterSettings As PrinterSettings
'Usage
Dim instance As PrintDocument
Dim value As PrinterSettings

value = instance.PrinterSettings

instance.PrinterSettings = value

public PrinterSettings PrinterSettings { get; set; }

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

/** @property */
public PrinterSettings get_PrinterSettings ()

/** @property */
public void set_PrinterSettings (PrinterSettings value)

public function get PrinterSettings () : PrinterSettings

public function set PrinterSettings (value : PrinterSettings)

Eigenschaftenwert

Eine Instanz von PrinterSettings, die angibt, wo und wie das Dokument gedruckt wird. In der Standareinstellung sind die Eigenschaften von PrinterSettings auf die entsprechenden Standardwerte festgelegt.

Hinweise

Mithilfe der PrinterSettings-Eigenschaft können Sie mehrere Druckereinstellungen festlegen. Mithilfe der PrinterSettings.Copies-Eigenschaft können Sie z. B. die Anzahl der zu druckenden Exemplare, mithilfe der PrinterSettings.PrinterName-Eigenschaft den zu verwendenden Drucker und mithilfe der PrinterSettings.PrintRange-Eigenschaft den Bereich der zu druckenden Seiten angeben.

Beispiel

Im folgenden Codebeispiel wird ein Dokument auf dem angegebenen Drucker 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
            ' Specify the printer to use.
            pd.PrinterSettings.PrinterName = printer
            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);
        // Specify the printer to use.
        pd.PrinterSettings.PrinterName = printer;
        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 );
            // Specify the printer to use.
            pd->PrinterSettings->PrinterName = printer;
            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));

            // Specify the printer to use.
            pd.get_PrinterSettings().set_PrinterName(printer);
            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
PrintDocument.DefaultPageSettings-Eigenschaft
PrintDocument.DocumentName-Eigenschaft
PrintDocument.PrintController-Eigenschaft
PrinterSettings

Freigeben über