PrintDocument.Print Method
Starts the document's printing process.
[Visual Basic] Public Sub Print() [C#] public void Print(); [C++] public: void Print(); [JScript] public function Print();
Exceptions
| Exception Type | Condition |
|---|---|
| InvalidPrinterException | The printer named in the PrinterSettings.PrinterName property does not exist. |
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.
Example
[Visual Basic, C#, C++] The following example prints the file that is specified through the command line to the default printer.
[Visual Basic, C#, C++] Note The example assumes that each line fits within the page width.
[Visual Basic, C#, C++] Use the System.ComponentModel, System.Drawing, System.Drawing.Printing, System.IO, and System.Windows.Forms namespaces for this example.
[Visual Basic] 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 Not (line Is 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 'Printing ' 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 [C#] 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(); } } [C++] public __gc class PrintingExample { private: Font* printFont; 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 = (float)ev->MarginBounds.Left; float topMargin = (float)ev->MarginBounds.Top; String* line=0; // 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()) != 0)) { 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 != 0) ev->HasMorePages = true; else ev->HasMorePages = false; } // Print the file. public: void Printing() { try { streamToPrint = new StreamReader (filePath); try { printFont = new Font(S"Arial", 10); PrintDocument* pd = new PrintDocument(); pd->PrintPage += new PrintPageEventHandler(this, &PrintingExample::pd_PrintPage); // Print the document. pd->Print(); } __finally { streamToPrint->Close() ; } } catch(Exception* ex) { MessageBox::Show(ex->Message); } } static void Main() { String* args[] = Environment::GetCommandLineArgs(); String* sampleName = args[0]; if(args->Length != 2) { Console::WriteLine(S"Usage: {0} <file path>", sampleName); return; } filePath = args[1]; new PrintingExample(); } }; int main() { PrintingExample::Main(); }
[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button
in the upper-left corner of the page.
Requirements
Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family
.NET Framework Security:
- PrintingPermission for safe printing from a restricted dialog box. Associated enumeration: PrintingPermissionLevel.SafePrinting
See Also
PrintDocument Class | PrintDocument Members | System.Drawing.Printing Namespace