Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

PrintDocument::Print Method ()

 

Starts the document's printing process.

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

public:
void Print()

Exception Condition
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.

System_CAPS_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.

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

PrintingPermission

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

.NET Framework
Available since 1.1
Return to top
Show:
© 2017 Microsoft