Andy De George
c0ba284473
* Merge winforms framework content to working branch (#14) * Breadcrumb / TOC / Move net5 to net folder (#15) * change path from net5 to net * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Mess with bread/toc * Add .net 5 winforms placeholder article (#16) * added some metadata and adjusted net5 placeholder * corrections * corrections * corrections * Test1 * Swapping landing page vs concept * fix links * Fix links * Fix desc
2.7 KiB
title, ms.date, f1_keywords, helpviewer_keywords, ms.assetid
| title | ms.date | f1_keywords | helpviewer_keywords | ms.assetid | |||
|---|---|---|---|---|---|---|---|
| PrintDocument Component Overview | 03/30/2017 |
|
|
b59b4b60-dce5-42ca-8421-3a54a2f7bab0 |
PrintDocument Component Overview (Windows Forms)
The Windows Forms PrintDocument component is used to set the properties that describe what to print and the ability to print the document within Windows-based applications. It can be used in conjunction with the PrintDialog component to be in control of all aspects of document printing.
Working with the PrintDocument Component
Two of the main scenarios that involve the xref:System.Drawing.Printing.PrintDocument component are:
-
Simple print jobs, such as printing an individual text file. In such a case you would add the xref:System.Drawing.Printing.PrintDocument component to a Windows Form, then add programming logic that prints a file in the xref:System.Drawing.Printing.PrintDocument.PrintPage event handler. The programming logic should culminate with the xref:System.Drawing.Printing.PrintDocument.Print%2A method to print the document. This method sends a xref:System.Drawing.Graphics object, contained in the xref:System.Drawing.Printing.PrintPageEventArgs.Graphics%2A property of the xref:System.Drawing.Printing.PrintPageEventArgs class, to the printer. For an example that shows how to print a text document using the xref:System.Drawing.Printing.PrintDocument component, see How to: Print a Multi-Page Text File in Windows Forms.
-
More complex print jobs, such as a situation where you will want to reuse printing logic you have written. In such a case you would derive a new component from the xref:System.Drawing.Printing.PrintDocument component and override (see Overrides for Visual Basic or override for C#) the xref:System.Drawing.Printing.PrintDocument.PrintPage event.
When it is added to a form, the xref:System.Drawing.Printing.PrintDocument component appears in the tray at the bottom of the Windows Forms Designer in Visual Studio.