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.