PrinterSettings Klasse

Definition

Gibt Informationen darüber an, wie ein Dokument gedruckt wird, einschließlich des Druckers, der es druckt, beim Drucken aus einer Windows Forms-Anwendung.

public ref class PrinterSettings : ICloneable
[System.Runtime.InteropServices.ComVisible(false)]
[System.Serializable]
public class PrinterSettings : ICloneable
[System.Serializable]
public class PrinterSettings : 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 druckbaren Datei festgelegt.

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

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

Verwenden Sie die System.DrawingNamespaces System.Drawing.Printingund System.IO die Namespaces 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 eine PrinterSettings Through PrintDocument.PrinterSettings - oder PageSettings.PrinterSettings Eigenschaften zu, um Druckereinstellungen zu ändern. Die am häufigsten verwendete Druckereinstellung ist PrinterName, die den zu druckden Drucker angibt.

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.

Note

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 führt zu Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Konstruktoren

Name Beschreibung
PrinterSettings()

Initialisiert eine neue Instanz der PrinterSettings-Klasse.

Eigenschaften

Name Beschreibung
CanDuplex

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

Collate

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das gedruckte Dokument sortiert ist.

Copies

Ruft die Anzahl der zu druckende Kopien des Dokuments ab oder legt sie fest.

DefaultPageSettings

Ruft die Standardseiteneinstellungen für diesen Drucker ab.

Duplex

Dient zum Abrufen oder Festlegen der Druckereinstellung für den doppelseitigen Druck.

FromPage

Ruft die Seitenzahl der ersten zu druckende Seite ab oder legt sie fest.

InstalledPrinters

Ruft die Namen aller auf dem Computer installierten Drucker ab.

IsDefaultPrinter

Ruft einen Wert ab, der angibt, ob die PrinterName Eigenschaft den Standarddrucker angibt, außer wenn der Benutzer explizit festgelegt wird PrinterName.

IsPlotter

Ruft einen Wert ab, der angibt, ob der Drucker ein Plotter ist.

IsValid

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

LandscapeAngle

Ruft den Winkel in Grad ab, in dem die Hochformatausrichtung gedreht wird, um die Querformatausrichtung zu erzeugen.

MaximumCopies

Ruft die maximale Anzahl von Kopien ab, mit denen der Drucker den Benutzer gleichzeitig drucken kann.

MaximumPage

Dient zum Abrufen oder Festlegen des Maximums FromPage oder ToPage festlegen, das in einer PrintDialog.

MinimumPage

Ruft das Minimum FromPage ab oder legt dieses fest, oder ToPage das in einer PrintDialog.

PaperSizes

Ruft die Papierformate ab, die von diesem Drucker unterstützt werden.

PaperSources

Ruft die Papierquellfächer ab, die auf dem Drucker verfügbar sind.

PrinterName

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

PrinterResolutions

Ruft alle Auflösungen ab, die von diesem Drucker unterstützt werden.

PrintFileName

Ruft den Dateinamen beim Drucken in eine Datei ab oder legt diesen fest.

PrintRange

Ruft die Seitenzahlen ab, die der Benutzer zum Drucken angegeben hat, oder legt diese fest.

PrintToFile

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Druckausgabe an eine Datei anstatt an einen Port gesendet wird.

SupportsColor

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

ToPage

Ruft die Nummer der letzten zu druckende Seite ab oder legt sie fest.

Methoden

Name Beschreibung
Clone()

Erstellt eine Kopie dieser PrinterSettingsDatei.

CreateMeasurementGraphics()

Gibt einen Graphics Wert zurück, der Druckerinformationen enthält, die beim Erstellen eines Druckers PrintDocumentnützlich sind.

CreateMeasurementGraphics(Boolean)

Gibt eine Graphics Druckerinformation zurück, die optional den Ursprung am Rand angibt.

CreateMeasurementGraphics(PageSettings, Boolean)

Erstellt eine Graphics Zuordnung zu den angegebenen Seiteneinstellungen und optional die Angabe des Ursprungs an den Rändern.

CreateMeasurementGraphics(PageSettings)

Gibt einen Graphics Wert zurück, der Druckerinformationen enthält, die dem angegebenen PageSettingsElement zugeordnet sind.

Equals(Object)

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

(Geerbt von Object)
GetHashCode()

Dient als Standardhashfunktion.

(Geerbt von Object)
GetHdevmode()

Erstellt einen Handle zu einer DEVMODE Struktur, die den Druckereinstellungen entspricht.

GetHdevmode(PageSettings)

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

GetHdevnames()

Erstellt einen Handle zu einer DEVNAMES Struktur, die den Druckereinstellungen entspricht.

GetType()

Ruft die 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 angegebene Bildformat unterstützt.

MemberwiseClone()

Erstellt eine flache Kopie der aktuellen Object.

(Geerbt von Object)
SetHdevmode(IntPtr)

Kopiert die relevanten Informationen aus dem angegebenen Handle und in die PrinterSettings.

SetHdevnames(IntPtr)

Kopiert die relevanten Informationen aus dem angegebenen Handle und in die PrinterSettings.

ToString()

Stellt Informationen zum Zeichenfolgenformular PrinterSettings bereit.

Gilt für:

Weitere Informationen