Übersicht über die PrintDocument-Komponente (Windows Forms)
Aktualisiert: November 2007
Die PrintDocument-Komponente in Windows Forms wird verwendet, um die Eigenschaften der zu druckenden Elemente festzulegen und das Dokument anschließend innerhalb von Windows-Anwendungen zu drucken. Sie kann in Verbindung mit der PrintDialog-Komponente verwendet werden, um alle Aspekte zu steuern, die mit dem Drucken von Dokumenten zusammenhängen.
Arbeiten mit der PrintDocument-Komponente
Die beiden Hauptszenarien für die PrintDocument-Komponente sind folgende:
Einfache Druckaufträge, z. B. das Drucken einer einzelnen Textdatei. In einem solchen Fall würden Sie die PrintDocument-Komponente in ein Windows Form einfügen und dann eine Programmierlogik hinzufügen, die eine Datei im PrintPage-Ereignishandler ausgibt. Die Programmierlogik muss zum Drucken des Dokuments mit der Print-Methode zusammenwirken. Diese Methode sendet ein Graphics-Objekt an den Drucker, das in der Graphics-Eigenschaft der PrintPageEventArgs-Klasse enthalten ist. Ein Beispiel, das veranschaulicht, wie ein Textdokument mit der PrintDocument-Komponente gedruckt wird, finden Sie unter Gewusst wie: Drucken einer mehrseitigen Textdatei in Windows Forms.
Komplexere Druckaufträge, wenn Sie z. B. die geschriebene Drucklogik wiederverwenden möchten. In einem solchen Fall würden Sie eine neue Komponente von der PrintDocument-Komponente ableiten und das PrintPage-Ereignis überschreiben (siehe Overrides für Visual Basic oder override für C#).
Nachdem die PrintDocument-Komponente einem Formular hinzugefügt wurde, wird sie im Komponentenfach am unteren Rand des Windows Forms-Designers angezeigt.