This documentation is archived and is not being maintained.

PrintController Class

Controls how a document is printed.

For a list of all members of this type, see PrintController Members.

System.Object
   System.Drawing.Printing.PrintController
      System.Drawing.Printing.PreviewPrintController
      System.Drawing.Printing.StandardPrintController
      System.Windows.Forms.PrintControllerWithStatusDialog

[Visual Basic]
MustInherit Public Class PrintController
[C#]
public abstract class PrintController
[C++]
public __gc __abstract class PrintController
[JScript]
public abstract class PrintController

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Remarks

When implemented in a derived class, PrintController controls how a PrintDocument is printed. PrintDocument.Print invokes the print controller's OnStartPrint, OnEndPrint, OnStartPage, and OnEndPage methods, which in turn tell the printer how to print the document. Print preview uses a specialized PrintController. For an example of a print controller that is specialized for print preview, see the PreviewPrintController.

PrintController is used by PrintDocument, and not typically used directly.

The .NET Framework includes three print controllers that are derived from PrintController, that help accomplish common tasks. The StandardPrintController prints a document to a printer. The PreviewPrintController generates a preview of what the document will look like when printed and is used by the PrintPreviewControl and PrintPreviewDialog classes. The System.Windows.Forms.PrintControllerWithStatusDialog provides a printing status dialog during the printing process.

For more information on printing, see the System.Drawing.Printing namespace overview.

Requirements

Namespace: System.Drawing.Printing

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

Assembly: System.Drawing (in System.Drawing.dll)

See Also

PrintController Members | System.Drawing.Printing Namespace | PrintDocument | StandardPrintController

Show: