PrintDocument::PrintController Property

.NET Framework (current version)

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

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

Syntax

public:
[BrowsableAttribute(false)]
property PrintController^ PrintController {
	PrintController^ get();
	void set(PrintController^ value);
}

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.

Examples

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.

C++

public:
   void myPrint()
   {
      if ( useMyPrintController == true )
      {
         myPrintDocument->PrintController =
            gcnew myControllerImplementation;
         if ( wantsStatusDialog == true )
         {
            myPrintDocument->PrintController =
               gcnew PrintControllerWithStatusDialog(
                  myPrintDocument->PrintController );
         }
      }
      myPrintDocument->Print();
   }