System.Drawing.Printing Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.
