Export (0) Print
Expand All

PrintDocument.PrintController Property

Gets or sets the print controller that guides the printing process.

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

[BrowsableAttribute(false)]
public PrintController PrintController { get; set; }

Property Value

Type: System.Drawing.Printing.PrintController
The PrintController that guides the printing process. The default is a new instance of the PrintControllerWithStatusDialog class.

A print controller guides the printing process in several ways. For example, to print a document, you need to convert it to a Graphics object. A PrintController specifies where to draw the graphic in an image for a print preview or on a printer to actually print the document. A print controller can also specify whether to print a document immediately, or wait a specified interval.

The following code example requires that you have created an instance of the PrintDocument class that is named myPrintDocument. The example creates a new instance of the PrintController class, assigns it to the PrintController property of myPrintDocument, and prints the document.

Use the System.Drawing.Printing and System.Windows.Forms namespaces for this example.

public void myPrint()
{
   if (useMyPrintController == true)
   {
      myPrintDocument.PrintController = 
         new myControllerImplementation();     
      if (wantsStatusDialog == true)
      {
         myPrintDocument.PrintController = 
            new PrintControllerWithStatusDialog
            (myPrintDocument.PrintController);
      }
   }
   myPrintDocument.Print();
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft