PrinterSettings-Klasse

Artikel
08/20/2007

Gibt Informationen darüber an, wie ein Dokument gedruckt und welcher Drucker verwendet wird.

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

Syntax

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

[SerializableAttribute] 
public class PrinterSettings : ICloneable

[SerializableAttribute] 
public ref class PrinterSettings : ICloneable

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

SerializableAttribute 
public class PrinterSettings implements ICloneable

Hinweise

Normalerweise greifen Sie auf PrinterSettings mit der PrintDocument.PrinterSettings-Eigenschaft oder der PageSettings.PrinterSettings-Eigenschaft zu, um die Druckereinstellungen zu ändern. Die wichtigste Druckereinstellung ist PrinterName, die den Drucker angibt, auf dem gedruckt werden soll.

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

Beispiel

Im folgenden Codebeispiel wird ein Dokument auf dem angegebenen Drucker 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(printer As String)
    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

            If pd.PrinterSettings.IsValid then
               pd.Print()
            Else
               MessageBox.Show("Printer is invalid.")
            End If
        Finally
            streamToPrint.Close()
        End Try
    Catch ex As Exception
        MessageBox.Show(ex.Message)
    End Try
End Sub

public void Printing(string printer) {
  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;

      if (pd.PrinterSettings.IsValid) {
         pd.Print();
      } 
      else {    
         MessageBox.Show("Printer is invalid.");
      }
    } 
    finally {
      streamToPrint.Close();
    }
  } 
  catch(Exception ex) {
    MessageBox.Show(ex.Message);
  }
}

public:
   void Printing( String^ printer )
   {
      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;
            if ( pd->PrinterSettings->IsValid )
            {
               pd->Print();
            }
            else
            {
               MessageBox::Show( "Printer is invalid." );
            }
         }
         finally
         {
            streamToPrint->Close();
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }

public void Printing(String printer)
{
    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);
            if (pd.get_PrinterSettings().get_IsValid()) {
                pd.Print();
            }
            else {
                MessageBox.Show("Printer is invalid.");
            }
        }
        finally {
            streamToPrint.Close();
        }
    }
    catch (System.Exception ex) {
        MessageBox.Show(ex.get_Message());
    }
} //Printing

Vererbungshierarchie

System.Object
System.Drawing.Printing.PrinterSettings

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-Member
System.Drawing.Printing-Namespace
PrinterName
PrintDocument.PrinterSettings-Eigenschaft
PageSettings.PrinterSettings-Eigenschaft

Freigeben über