PrintDocument.PrintController Property

Definition

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

public:
 property System::Drawing::Printing::PrintController ^ PrintController { System::Drawing::Printing::PrintController ^ get(); void set(System::Drawing::Printing::PrintController ^ value); };
[System.ComponentModel.Browsable(false)]
public System.Drawing.Printing.PrintController PrintController { get; set; }
member this.PrintController : System.Drawing.Printing.PrintController with get, set
Public Property PrintController As PrintController

Property Value

The PrintController that guides the printing process. The default is a new instance of the PrintControllerWithStatusDialog class.

Attributes

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.

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

Public Sub myPrint()
    If useMyPrintController = True Then
        myPrintDocument.PrintController = New myControllerImplementation()
        If wantsStatusDialog = True Then
            myPrintDocument.PrintController = _
               New PrintControllerWithStatusDialog( _
               myPrintDocument.PrintController)
        End If
    End If
    myPrintDocument.Print()
End Sub

Remarks

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.

Security

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

Applies to

See also