PrintDocument::PrinterSettings Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets the printer that prints the document.

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

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

Property Value

Type: System.Drawing.Printing::PrinterSettings^

A PrinterSettings that specifies where and how the document is printed. The default is a PrinterSettings with its properties set to their default values.

You can specify several printer settings through the PrinterSettings property. For example, use the PrinterSettings::Copies property to specify the number of copies you want to print, the PrinterSettings::PrinterName property to specify the printer to use, and the PrinterSettings::PrintRange property to specify the range of pages you want to print.

The following code example prints a document on the specified printer. The example makes three assumptions: that a variable names filePath has been set to the path of the file to print; that a method named pd_PrintPage, which handles the PrintPage event, has been defined; and that a variable named printer has been set to the printer's name.

Use the System.Drawing, System.Drawing.Printing, and System.IO namespaces for this example.

public:
   void Printing()
   {
      try
      {
         streamToPrint = gcnew StreamReader( filePath );
         try
         {
            printFont = gcnew System::Drawing::Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler(
               this, &Form1::pd_PrintPage );
            // Specify the printer to use.
            pd->PrinterSettings->PrinterName = printer;
            pd->Print();
         }
         finally
         {
            streamToPrint->Close();
         }
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }
   }

.NET Framework
Available since 1.1
Return to top
Show: