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();
}

PrintingPermission

for safe printing from a restricted dialog box. Associated enumeration: PrintingPermissionLevel.SafePrinting

.NET Framework
Available since 1.1
Return to top
Show: