PrinterSettings Klasse

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

PrinterSettings.cs

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

type PrinterSettings = class
    interface ICloneable

Public Class PrinterSettings
Implements ICloneable

Vererbung

Object

PrinterSettings

Implementiert

ICloneable

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.

Weitere Informationen

• PrinterName
• PrinterSettings
• PrinterSettings