Export (0) Print
Expand All

PrintController Class

Controls how a document is printed, when printing from a Windows Forms application.

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

public abstract class PrintController

The PrintController type exposes the following members.

  NameDescription
Protected methodPrintControllerInitializes a new instance of the PrintController class.
Top

  NameDescription
Public propertyIsPreviewGets a value indicating whether the PrintController is used for print preview.
Top

  NameDescription
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodOnEndPageWhen overridden in a derived class, completes the control sequence that determines when and how to print a page of a document.
Public methodOnEndPrintWhen overridden in a derived class, completes the control sequence that determines when and how to print a document.
Public methodOnStartPageWhen overridden in a derived class, begins the control sequence that determines when and how to print a page of a document.
Public methodOnStartPrintWhen overridden in a derived class, begins the control sequence that determines when and how to print a document.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

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 PrintControllerWithStatusDialog provides a printing status dialog during the printing process.

For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

.NET Framework

Supported in: 4.5.3, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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