Freigeben über


PrinterSettings Klasse

Definition

Gibt Informationen darüber an, wie ein Dokument gedruckt wird, einschließlich des Druckers für das Drucken, sofern der Druck aus einer Windows Forms-Anwendung erfolgt.

public ref class PrinterSettings : ICloneable
public class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : ICloneable
type PrinterSettings = class
    interface ICloneable
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
[<System.Serializable>]
type PrinterSettings = class
    interface ICloneable
Public Class PrinterSettings
Implements ICloneable
Vererbung
PrinterSettings
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel wird ein Dokument auf dem angegebenen Drucker gedruckt. Das Beispiel hat drei Voraussetzungen:

  • Eine Variable mit dem Namen filePath wurde auf den Pfad der zu druckenden Datei festgelegt.

  • Eine Methode mit dem Namen pd_PrintPage, die das PrintPage Ereignis behandelt, wurde definiert.

  • Eine Variable mit dem Namen printer wurde auf den Namen des Druckers festgelegt.

Verwenden Sie die System.DrawingNamespaces , System.Drawing.Printingund System.IO für dieses Beispiel.

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.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 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

Hinweise

In der Regel greifen Sie auf eigenschaften PrinterSettingsPrintDocument.PrinterSettings oder PageSettings.PrinterSettings zu, um die Druckereinstellungen zu ändern. Die gebräuchlichste Druckereinstellung ist PrinterName, die den Drucker angibt, auf dem gedruckt werden soll.

Weitere Informationen zum Drucken mit Windows Forms finden Sie in der System.Drawing.Printing Namespaceübersicht. Wenn Sie aus einer Windows Presentation Foundation-Anwendung drucken möchten, lesen Sie den System.Printing Namespace.

Hinweis

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Kompilierzeitwarnungen und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

PrinterSettings()

Initialisiert eine neue Instanz der PrinterSettings-Klasse.

Eigenschaften

CanDuplex

Ruft einen Wert ab, der angibt, ob der Drucker beidseitiges Drucken unterstützt.

Collate

Ruft einen Wert ab, der angibt, ob das gedruckte Dokument sortiert wird, oder legt diesen fest.

Copies

Ruft die Anzahl der zu druckenden Exemplare des Dokuments ab oder legt diese fest.

DefaultPageSettings

Ruft die Standardseiteneinstellungen für diesen Drucker ab.

Duplex

Ruft die Druckereinstellung für beidseitiges Drucken ab oder legt diese fest.

FromPage

Ruft die Nummer der ersten zu druckenden Seite ab oder legt diese fest.

InstalledPrinters

Ruft die Namen aller auf dem Computer installierten Drucker ab.

IsDefaultPrinter

Ruft einen Wert ab, der angibt, ob die PrinterName-Eigenschaft immer dann den Standarddrucker festlegt, wenn der Benutzer PrinterName nicht explizit festlegt.

IsPlotter

Ruft einen Wert ab, der angibt, ob es sich bei dem Drucker um einen Plotter handelt.

IsValid

Ruft einen Wert ab, der angibt, ob die PrinterName-Eigenschaft einen gültigen Drucker bezeichnet.

LandscapeAngle

Ruft den Winkel in Grad ab, um den das Querformat gegenüber dem Hochformat gedreht wird.

MaximumCopies

Ruft die maximale Anzahl der Exemplare ab, die pro Auftrag auf dem Drucker gedruckt werden können.

MaximumPage

Ruft den Höchstwert für FromPage oder für ToPage ab, der in einem PrintDialog ausgewählt werden kann, oder legt diesen fest.

MinimumPage

Ruft den Mindestwert für FromPage oder für ToPage ab, der in einem PrintDialog ausgewählt werden kann, oder legt diesen fest.

PaperSizes

Ruft die von diesem Drucker unterstützten Papiergrößen ab.

PaperSources

Ruft die bei diesem Drucker verfügbaren Papierzufuhrschächte ab.

PrinterName

Ruft den Namen des zu verwendenden Druckers ab oder legt diesen fest.

PrinterResolutions

Ruft alle von diesem Drucker unterstützten Auflösungen ab.

PrintFileName

Ruft bei der Druckausgabe in eine Datei den Dateinamen ab oder legt diesen fest.

PrintRange

Ruft die Seitennummern ab, die entsprechend der Angabe des Benutzers gedruckt werden sollen, oder legt diese fest.

PrintToFile

Ruft einen Wert ab, der angibt, ob die Druckausgabe nicht an einen Druckeranschluss, sondern an eine Datei gesendet wird.

SupportsColor

Ruft einen Wert ab, der angibt, ob der Drucker Farbdruck unterstützt.

ToPage

Ruft die Nummer der letzten zu druckenden Seite ab oder legt diese fest.

Methoden

Clone()

Erstellt eine Kopie dieser Instanz von PrinterSettings.

CreateMeasurementGraphics()

Gibt eine Instanz von Graphics zurück, die Druckerinformationen enthält, die beim Erstellen von PrintDocument hilfreich sind.

CreateMeasurementGraphics(Boolean)

Gibt eine Instanz von Graphics zurück, die Druckerinformationen enthält. Optional wird der Ursprung an den Seitenrändern angegeben.

CreateMeasurementGraphics(PageSettings)

Gibt eine Instanz von Graphics zurück, die Druckerinformationen enthält, die den angegebenen PageSettings zugeordnet sind.

CreateMeasurementGraphics(PageSettings, Boolean)

Erstellt eine Instanz von Graphics, die den angegebenen Seiteneinstellungen zugeordnet ist. Optional wird der Ursprung an den Seitenrändern angegeben.

Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetHdevmode()

Erstellt ein Handle für eine DEVMODE-Struktur, die den Druckereinstellungen entspricht.

GetHdevmode(PageSettings)

Erstellt ein Handle für eine DEVMODE-Struktur, die den über den pageSettings-Parameter angegebenen Drucker- und Seiteneinstellungen entspricht.

GetHdevnames()

Erstellt ein Handle für eine DEVNAMES-Struktur, die den Druckereinstellungen entspricht.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IsDirectPrintingSupported(Image)

Ruft einen Wert ab, der angibt, ob der Drucker das Drucken der angegebenen Bilddatei unterstützt.

IsDirectPrintingSupported(ImageFormat)

Gibt einen Wert zurück, der angibt, ob der Drucker das Drucken des angegebenen Bildformats unterstützt.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
SetHdevmode(IntPtr)

Kopiert die relevanten Informationen vom angegebenen Handle in die PrinterSettings.

SetHdevnames(IntPtr)

Kopiert die relevanten Informationen vom angegebenen Handle in die PrinterSettings.

ToString()

Stellt Informationen zu PrinterSettings als Zeichenfolge bereit.

Gilt für:

Weitere Informationen