This documentation is archived and is not being maintained.

PrintDocument::Print Method

Starts the document's printing process.

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

public:
void Print()

ExceptionCondition
InvalidPrinterException

The printer named in the PrinterSettings::PrinterName property does not exist.

Specify the output to print by handling the PrintPage event and by using the Graphics included in the PrintPageEventArgs.

Use the PrinterSettings::PrinterName property to specify which printer should print the document.

The Print method prints the document without using a print dialog. Use a PrintDialog when you want to offer the user the ability to choose print settings.

NoteNote

If an exception that is not handled by the Print method is thrown during printing, the printing of the document is aborted.

The following code example prints the file that is specified through the command line to the default printer.

NoteNote

The example requires that each line fits within the page width.

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



#using <System.dll>
#using <System.Windows.Forms.dll>
#using <System.Drawing.dll>

using namespace System;
using namespace System::IO;
using namespace System::Drawing;
using namespace System::Drawing::Printing;
using namespace System::Windows::Forms;


public ref class PrintingExample
{
private:
   Font^ printFont;
   StreamReader^ streamToPrint;
   static String^ filePath;

public:
   PrintingExample()
   {
      Printing();
   }


private:

   // The PrintPage event is raised for each page to be printed.
   void pd_PrintPage( Object^ /*sender*/, PrintPageEventArgs^ ev )
   {
      float linesPerPage = 0;
      float yPos = 0;
      int count = 0;
      float leftMargin = (float)ev->MarginBounds.Left;
      float topMargin = (float)ev->MarginBounds.Top;
      String^ line = nullptr;

      // Calculate the number of lines per page.
      linesPerPage = ev->MarginBounds.Height / printFont->GetHeight( ev->Graphics );

      // Iterate over the file, printing each line.
      while ( count < linesPerPage && ((line = streamToPrint->ReadLine()) != nullptr) )
      {
         yPos = topMargin + (count * printFont->GetHeight( ev->Graphics ));
         ev->Graphics->DrawString( line, printFont, Brushes::Black, leftMargin, yPos, gcnew StringFormat );
         count++;
      }


      // If more lines exist, print another page.
      if ( line != nullptr )
            ev->HasMorePages = true;
      else
            ev->HasMorePages = false;
   }


public:

   // Print the file.
   void Printing()
   {
      try
      {
         streamToPrint = gcnew StreamReader( filePath );
         try
         {
            printFont = gcnew Font( "Arial",10 );
            PrintDocument^ pd = gcnew PrintDocument;
            pd->PrintPage += gcnew PrintPageEventHandler( this, &PrintingExample::pd_PrintPage );

            // Print the document.
            pd->Print();
         }
         finally
         {
            streamToPrint->Close();
         }

      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( ex->Message );
      }

   }

   static void Main()
   {
      array<String^>^args = Environment::GetCommandLineArgs();
      String^ sampleName = args[ 0 ];
      if ( args->Length != 2 )
      {
         Console::WriteLine( "Usage: {0} <file path>", sampleName );
         return;
      }

      filePath = args[ 1 ];
      gcnew PrintingExample;
   }

};

int main()
{
   PrintingExample::Main();
}



.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: