System.Drawing.Printing Namespace

  • Referenz

Stellt druckrelevante Dienste für Windows Forms-Anwendungen bereit.

Klassen

InvalidPrinterException

Stellt die Ausnahme dar, die ausgelöst wird, wenn Sie mit ungültigen Druckereinstellungen auf einen Drucker zugreifen.
Margins

Gibt die Abmessungen der Ränder einer gedruckten Seite an.
MarginsConverter

Stellt einen MarginsConverter für Margins bereit.
PageSettings

Gibt Einstellungen an, die auf eine einzelne gedruckte Seite angewendet werden.
PaperSize

Gibt die Größe eines Blatt Papiers an.
PaperSource

Gibt den Papierschacht an, aus dem der Drucker das Papier einzieht.
PreviewPageInfo

Gibt Informationen über die Seitenansicht für eine einzelne Seite an. Diese Klasse kann nicht vererbt werden.
PreviewPrintController

Gibt einen Druckercontroller an, der ein Dokument als eine Reihe von Bildern auf einem Bildschirm anzeigt.
PrintController

Steuert, wie ein Dokument gedruckt wird, wenn der Druck aus einer Windows Forms-Anwendung erfolgt.
PrintDocument

Definiert ein wiederverwendbares Objekt, das Ausgaben an einen Drucker sendet, sofern der Druck aus einer Windows Forms-Anwendung erfolgt.
PrinterResolution

Stellt die von einem Drucker unterstützte Auflösung dar.
PrinterSettings

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

Enthält eine Auflistung von PaperSize-Objekten.
PrinterSettings.PaperSourceCollection

Enthält eine Auflistung von PaperSource-Objekten.
PrinterSettings.PrinterResolutionCollection

Enthält eine Auflistung von PrinterResolution-Objekten.
PrinterSettings.StringCollection

Enthält eine Auflistung von String-Objekten.
PrinterUnitConvert

Gibt eine Reihe von Konvertierungsmethoden an, die sich bei der Arbeit mit der Win32-Drucker-API anbieten. Diese Klasse kann nicht vererbt werden.
PrintEventArgs

Stellt Daten für das BeginPrint-Ereignis und das EndPrint-Ereignis bereit.
PrintingPermission

Steuert den Zugriff auf Drucker. Diese Klasse kann nicht vererbt werden.
PrintingPermissionAttribute

Lässt deklarative Druckberechtigungsüberprüfungen zu.
PrintPageEventArgs

Stellt Daten für das PrintPage-Ereignis bereit.
QueryPageSettingsEventArgs

Stellt Daten für das QueryPageSettings-Ereignis bereit.
StandardPrintController

Gibt einen Druckercontroller an, der Informationen an einen Drucker sendet.

Enumerationen

Duplex

Gibt die Duplexeinstellungen des Druckers an.
PaperKind

Gibt die Standardpapierformate an.
PaperSourceKind

Standardpapierzufuhren.
PrintAction

Gibt den Typ des Druckvorgangs an.
PrinterResolutionKind

Definiert eine Druckerauflösung.
PrinterUnit

Gibt verschiedene Maßeinheiten an, die zum Drucken verwendet werden.
PrintingPermissionLevel

Gibt die für den Code zugelassene Druckart an.
PrintRange

Gibt den zu druckenden Teil des Dokuments an.

Delegaten

PrintEventHandler

Stellt die Methode dar, die das BeginPrint-Ereignis oder das EndPrint-Ereignis eines PrintDocument behandelt.
PrintPageEventHandler

Stellt die Methode zur Behandlung des PrintPage-Ereignisses eines PrintDocument-Objekts dar.
QueryPageSettingsEventHandler

Stellt die Methode dar, die das QueryPageSettings-Ereignis eines PrintDocument behandelt.

Hinweise

Wenn Sie in einer Windows Forms-Anwendung drucken, erstellen Sie in der Regel eine neue instance der PrintDocument -Klasse, legen Eigenschaften wie DefaultPageSettings und PrinterSettingsfest, die beschreiben, wie gedruckt wird, und rufen die Print -Methode auf, um das Dokument tatsächlich zu drucken. Durch Aufrufen der PrintDocument.Print -Methode wird das PrintDocument.PrintPage -Ereignis ausgelöst, das behandelt werden sollte, um das Dokumentlayout für den Druck auszuführen.

Verwenden Sie die Graphics -Eigenschaft des PrintPageEventArgs Aus dem -Ereignis abgerufenen PrintDocument.PrintPage Objekts, um die ausgabe anzugeben, die gedruckt werden soll. Wenn Sie eine Textdatei drucken, verwenden StreamReader Sie , um jeweils eine Zeile aus dem Datenstrom zu lesen, und rufen Sie die DrawString -Methode auf, um die Linie im Grafikobjekt zu zeichnen. Weitere Informationen zu diesem Prozess finden Sie in den Graphics Klassen und StreamReader . Ein Beispiel für das Drucken eines Textdokuments finden Sie im Thema Klassenübersicht PrintDocument .

Hinweis

Die DrawText-Methoden der TextRenderer-Klasse werden für den Druck nicht unterstützt. Verwenden Sie stattdessen die DrawString Methoden der Graphics -Klasse.

Bei Implementierung in einer abgeleiteten Klasse steuert, PrintController wie ein PrintDocument gedruckt wird. Die PrintDocument.Print -Methode ruft die Methoden , OnEndPrint, OnStartPageund OnEndPage des Druckcontrollers OnStartPrintauf, die dem Drucker wiederum mitteilen, wie das Dokument gedruckt werden soll. Weitere Informationen zum Drucken von Dialogfeldern finden Sie unter PrintDialog und PageSetupDialog.

Der Druckvorschauprozess verwendet einen speziellen Druckcontroller, ein Dialogfeld und ein Steuerelement. Ein Beispiel für einen solchen Druckcontroller und das Dialogfeld finden Sie unter PreviewPrintController, PrintPreviewDialogund PrintPreviewControl.

Achtung

Klassen innerhalb des Namespace werden nicht für die System.Drawing.Printing Verwendung innerhalb eines Windows-Diensts oder ASP.NET-Anwendung oder -Diensts unterstützt. Der Versuch, diese Klassen aus einem dieser Anwendungstypen zu verwenden, kann zu unerwarteten Problemen führen, z. B. verminderte Dienstleistung und Laufzeitausnahmen.

Wenn Sie aus einer WPF-Anwendung (Windows Presentation Foundation) drucken möchten, lesen Sie den System.Printing Namespace.

Weitere Informationen