Home Library Learn Downloads Support Community
Sign in | United States - English | |
1 out of 13 rated this helpful - Rate this topic

System.Drawing.Printing Namespace

.NET Framework 2.0
The System.Drawing.Printing namespace provides print-related services for Windows Forms applications.

Typically, when printing from a Windows Forms application, you create a new instance of the PrintDocument class, set the properties that describe what to print, and call the Print method to actually print the document.

NoteNote:

The classes that are contained in this namespace should be used when printing from a Windows Forms application. If you are printing from a Windows Presentation Foundation application, see the System.Printing namespace or Printing Overview

Use the Graphics property to specify the output to print. If you are printing a text file, use StreamReader in the following manner: read one line at a time from the stream and call the DrawString method to draw the line in the graphics object. For more information about this process, see the Graphics and StreamReader classes.

NoteNote:

The DrawText methods of the TextRenderer class are not supported for printing. Instead, use the DrawString methods of the Graphics class.

When implemented in a derived class, the PrintController controls how a PrintDocument is printed. The PrintDocument.Print method invokes the print controller's OnStartPrint, OnEndPrint, OnStartPage, and OnEndPage methods, which in turn tell the printer how to print the document. For more information about printing dialog boxes, see PrintDialog and PageSetupDialog.

The print-preview process uses a specialized print controller, dialog box, and control. For an example of such a print controller and dialog box, see PreviewPrintController, PrintPreviewDialog, and PrintPreviewControl.

Caution noteCaution:

Classes within the System.Drawing.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

  Class Description
Public class InvalidPrinterException Represents the exception that is thrown when you try to access a printer using printer settings that are not valid.
Public class Margins Specifies the dimensions of the margins of a printed page.
Public class MarginsConverter Provides a MarginsConverter for Margins.
Public class PageSettings Specifies settings that apply to a single, printed page.
Public class PaperSize Specifies the size of a piece of paper.
Public class PaperSource Specifies the paper tray from which the printer gets paper.
Public class PreviewPageInfo Specifies print preview information for a single page. This class cannot be inherited.
Public class PreviewPrintController Specifies a print controller that displays a document on a screen as a series of images.
Public class PrintController Controls how a document is printed, when printing from a Windows Forms application.
Public class PrintDocument Defines a reusable object that sends output to a printer, when printing from a Windows Forms application.
Public class PrinterResolution Represents the resolution supported by a printer.
Public class PrinterSettings Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.
Public class PrinterSettings.PaperSizeCollection Contains a collection of PaperSize objects.
Public class PrinterSettings.PaperSourceCollection Contains a collection of PaperSource objects.
Public class PrinterSettings.PrinterResolutionCollection Contains a collection of PrinterResolution objects.
Public class PrinterSettings.StringCollection Contains a collection of String objects.
Public class PrinterUnitConvert Specifies a series of conversion methods that are useful when interoperating with the Win32 printing API. This class cannot be inherited.
Public class PrintEventArgs Provides data for the BeginPrint and EndPrint events.
Public class PrintingPermission Controls access to printers. This class cannot be inherited.
Public class PrintingPermissionAttribute Allows declarative printing permission checks.
Public class PrintPageEventArgs Provides data for the PrintPage event.
Public class QueryPageSettingsEventArgs Provides data for the QueryPageSettings event.
Public class StandardPrintController Specifies a print controller that sends information to a printer.
  Delegate Description
Public delegate PrintEventHandler Represents the method that will handle the BeginPrint or EndPrint event of a PrintDocument.
Public delegate PrintPageEventHandler Represents the method that will handle the PrintPage event of a PrintDocument.
Public delegate QueryPageSettingsEventHandler Represents the method that handles the QueryPageSettings event of a PrintDocument.
  Enumeration Description
Public enumeration Duplex Specifies the printer's duplex setting.
Public enumeration PaperKind Specifies the standard paper sizes.
Public enumeration PaperSourceKind Standard paper sources.
Public enumeration PrintAction Specifies the type of print operation occurring.
Public enumeration PrinterResolutionKind Specifies a printer resolution.
Public enumeration PrinterUnit Specifies several of the units of measure used for printing.
Public enumeration PrintingPermissionLevel Specifies the type of printing that code is allowed to do.
Public enumeration PrintRange Specifies the part of the document to print.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
RE. Printing from a Windows service or ASP.NET application or service.
Presumably the newer System.Printing classes (introduced with WFP) are supoprted on the server side. At least, I have not seen anything to the contrary. Can anyone confirm whether they really are supported server side?
History
Printing from a Windows service or ASP.NET application or service.
The article says that the namespace is not supported for use within a Windows service or ASP.NET application or service. So what are the possible options ?
History
Printing in Visual Basic 2005

I am trying to print a page with a combination of fonts, bold, regular , underline etc. Listbox, textbox and richtextbox does not seem to want to accept what I want to do. 

A form will accept my request, then I use Printforma to print the page. The following happens:

(1) It prnts the form with the various fonts, bold, regular, underline etc.

(2) However, it does not print the bottom2 inch of page, I have made certion that data is

 there by using location x,y.  How can I solve that.

(3) The resolution seems to be draft. How can I change it to either medium or high?

 

Thanking you

Douglas Chin

History