PrintPageEventArgs.Graphics 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 the Graphics used to paint the page.

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

Public ReadOnly Property Graphics As Graphics

Property Value

Type: System.Drawing.Graphics

The Graphics used to paint the page.

The following code example assumes a Button named printButton and a PrintDocument named pd have been created on a Form. Make sure the Click event for the Button is associated with the printButton_Click method and the PrintPage event of the PrintDocument is associated with the pd_PrintPage method in the example. The printButton_Click method from the example calls the Print method raising the PrintPage event, and prints the .bmp file specified in the pd_PrintPage method. To run this example, change the path to the bitmap you want to print.

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

   ' Specifies what happens when the user clicks the Button.
   Private Sub printButton_Click(sender As Object, e As EventArgs) _
Handles printButton.Click
       Try
          pd.Print()
       Catch ex As Exception
           MessageBox.Show("An error occurred while printing", _
               ex.ToString())
       End Try
   End Sub    

   ' Specifies what happens when the PrintPage event is raised.
   Private Sub pd_PrintPage(sender As Object, ev As PrintPageEventArgs) _
Handles pd.PrintPage

       ' Draw a picture.
       ev.Graphics.DrawImage(Image.FromFile("C:\My Folder\MyFile.bmp"), _
           ev.Graphics.VisibleClipBounds)

       ' Indicate that this is the last page to print.
       ev.HasMorePages = False
   End Sub

.NET Framework
Available since 1.1
Return to top
Show: