System.Drawing.Printing-Namespace
Der System.Drawing.Printing-Namespace stellt Dienste für das Drucken bereit.
Sie erstellen i. d. R. eine neue Instanz der PrintDocument-Klasse, legen die Eigenschaften für die Druckausgabe fest und rufen die Print-Methode auf, um das Dokument zu drucken.
Verwenden Sie die Graphics-Eigenschaft, um das zu druckende Dokument anzugeben. Wenn Sie eine Textdatei drucken, verwenden Sie StreamReader wie folgt: Lesen Sie jeweils eine Zeile aus dem Stream, und rufen Sie die DrawString-Methode auf, um die Linie im Grafikobjekt zu zeichnen. Weitere Informationen zu diesem Vorgang finden Sie unter Graphics und StreamReader.
Hinweis
Die DrawText-Methoden der TextRenderer-Klasse werden für Druckvorgänge nicht unterstützt. Verwenden Sie stattdessen die DrawString-Methoden der Graphics-Klasse.
Wenn der PrintController in einer abgeleiteten Klasse implementiert ist, steuert dieser den Druckvorgang eines PrintDocument. Die PrintDocument.Print-Methode ruft die Methoden OnStartPrint, OnEndPrint, OnStartPage und OnEndPage des Druckercontrollers auf, die ihrerseits den Drucker anweisen, wie das Dokument gedruckt werden soll. Weitere Informationen zu Dialogfeldern für Druckvorgänge finden Sie unter PrintDialog und PageSetupDialog.
Für die Seitenansicht werden ein besonderer Druckercontroller, ein besonderes Dialogfeld und ein besonderes Steuerelement verwendet. Ein Beispiel für einen solchen Druckercontroller und ein solches Dialogfeld finden Sie unter PreviewPrintController, PrintPreviewDialog und PrintPreviewControl.
Warnung
Die Verwendung von Klassen im System.Drawing.Printing-Namespace mit einem Windows-Dienst, einer ASP.NET-Anwendung oder einem ASP.NET-Dienst wird nicht unterstützt. Wenn Sie diese Klassen in einem der genannten Anwendungstypen verwenden, kann dies unerwartete Probleme zur Folge haben, z. B. Leistungsbeeinträchtigungen und Laufzeitausnahmen.
Klassen
Klasse | Beschreibung | |
---|---|---|
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 geerbt 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. | |
PrintDocument | Definiert ein wiederverwendbares Objekt, das Ausgaben an einen Drucker sendet. | |
PrinterResolution | Stellt die von einem Drucker unterstützte Auflösung dar. | |
PrinterSettings | Gibt Informationen darüber an, wie ein Dokument gedruckt und welcher Drucker verwendet wird. | |
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 geerbt werden. | |
PrintEventArgs | Stellt Daten für das BeginPrint-Ereignis und das EndPrint-Ereignis bereit. | |
PrintingPermission | Steuert den Zugriff auf Drucker. Diese Klasse kann nicht geerbt 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. |
Delegaten
Delegat | Beschreibung | |
---|---|---|
PrintEventHandler | Stellt die Methode dar, die das BeginPrint-Ereignis oder das EndPrint-Ereignis eines PrintDocument behandelt. | |
PrintPageEventHandler | Stellt die Methode dar, die das PrintPage-Ereignis von PrintDocument behandelt. | |
QueryPageSettingsEventHandler | Stellt die Methode dar, die das QueryPageSettings-Ereignis der PrintDocument-Klasse behandelt. |
Enumerationen
Enumeration | Beschreibung | |
---|---|---|
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. |