Note

Access to this page requires authorization. You can try signing in or .

Access to this page requires authorization. You can try .

PrintDocument.Print Method

Definition

Namespace:
System.Drawing.Printing
Assembly:
System.Drawing.Common.dll
Assembly:
System.Drawing.dll
Package:
System.Drawing.Common v11.0.0-preview.5.26302.115
Source:
PrintDocument.cs
Source:
PrintDocument.cs
Source:
PrintDocument.cs
Source:
PrintDocument.cs
Source:
PrintDocument.cs
Source:
PrintDocument.cs
Source:
PrintDocument.cs
Source:
PrintDocument.cs
Source:
PrintDocument.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Starts the document's printing process.

public:
 void Print();
public void Print();
member this.Print : unit -> unit
Public Sub Print ()

Exceptions

The printer named in the PrinterName property does not exist.

Examples

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

Note

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();
}
using System;
using System.IO;
using System.Drawing;
using System.Drawing.Printing;
using System.Windows.Forms;

 public class PrintingExample 
 {
 private Font printFont;
 private StreamReader streamToPrint;
 static string filePath;

 public PrintingExample() 
 {
 Printing();
 }
 
 // The PrintPage event is raised for each page to be printed.
 private void pd_PrintPage(object sender, PrintPageEventArgs ev) 
 {
 float linesPerPage = 0;
 float yPos = 0;
 int count = 0;
 float leftMargin = ev.MarginBounds.Left;
 float topMargin = ev.MarginBounds.Top;
 String line=null;
 
 // 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()) != null)) 
 {
 yPos = topMargin + (count * printFont.GetHeight(ev.Graphics));
 ev.Graphics.DrawString (line, printFont, Brushes.Black, 
 leftMargin, yPos, new StringFormat());
 count++;
 }
 
 // If more lines exist, print another page.
 if (line != null) 
 ev.HasMorePages = true;
 else 
 ev.HasMorePages = false;
 }
 
 // Print the file.
 public void Printing()
 {
 try 
 {
 streamToPrint = new StreamReader (filePath);
 try 
 {
 printFont = new Font("Arial", 10);
 PrintDocument pd = new PrintDocument(); 
 pd.PrintPage += new PrintPageEventHandler(pd_PrintPage);
 // Print the document.
 pd.Print();
 } 
 finally 
 {
 streamToPrint.Close() ;
 }
 } 
 catch(Exception ex) 
 { 
 MessageBox.Show(ex.Message);
 }
 }
 
 // This is the main entry point for the application.
 public static void Main(string[] args) 
 {
 string sampleName = Environment.GetCommandLineArgs()[0];
 if(args.Length != 1)
 {
 Console.WriteLine("Usage: " + sampleName +" <file path>");
 return;
 }
 filePath = args[0];
 new PrintingExample();
 }
 }
Imports System.IO
Imports System.Drawing
Imports System.Drawing.Printing
Imports System.Windows.Forms


Public Class PrintingExample
 Private printFont As Font
 Private streamToPrint As StreamReader
 Private Shared filePath As String
 
 Public Sub New()
 Printing()
 End Sub 
 
 ' The PrintPage event is raised for each page to be printed.
 Private Sub pd_PrintPage(sender As Object, ev As PrintPageEventArgs)
 Dim linesPerPage As Single = 0
 Dim yPos As Single = 0
 Dim count As Integer = 0
 Dim leftMargin As Single = ev.MarginBounds.Left
 Dim topMargin As Single = ev.MarginBounds.Top
 Dim line As String = Nothing
 
 ' 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()
 If line Is Nothing Then
 Exit While
 End If
 yPos = topMargin + count * printFont.GetHeight(ev.Graphics)
 ev.Graphics.DrawString(line, printFont, Brushes.Black, leftMargin, _
 yPos, New StringFormat())
 count += 1
 End While
 
 ' If more lines exist, print another page.
 If (line IsNot Nothing) Then
 ev.HasMorePages = True
 Else
 ev.HasMorePages = False
 End If
 End Sub
 
 ' Print the file.
 Public Sub Printing()
 Try
 streamToPrint = New StreamReader(filePath)
 Try
 printFont = New Font("Arial", 10)
 Dim pd As New PrintDocument()
 AddHandler pd.PrintPage, AddressOf pd_PrintPage
 ' Print the document.
 pd.Print()
 Finally
 streamToPrint.Close()
 End Try
 Catch ex As Exception
 MessageBox.Show(ex.Message)
 End Try
 End Sub
 
 ' This is the main entry point for the application.
 Public Shared Sub Main()
 Dim args() As String = System.Environment.GetCommandLineArgs()
 Dim sampleName As String = args(0)
 If args.Length <> 1 Then
 Console.WriteLine("Usage: " & sampleName & " <file path>")
 Return
 End If
 filePath = args(0)
 End Sub
End Class

Remarks

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.

Note

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

Applies to


Feedback

Was this page helpful?