PrintPageEventArgs-Klasse

Stellt Daten für das PrintPage-Ereignis bereit.

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

Syntax

'Declaration
Public Class PrintPageEventArgs
    Inherits EventArgs
'Usage
Dim instance As PrintPageEventArgs

public class PrintPageEventArgs : EventArgs

public ref class PrintPageEventArgs : public EventArgs

public class PrintPageEventArgs extends EventArgs

public class PrintPageEventArgs extends EventArgs

Hinweise

Die MarginBounds-Eigenschaft ruft den rechteckigen Bereich ab, der den zwischen den Seitenrändern liegenden Teil der Seite darstellt. Die PageBounds-Eigenschaft ruft den rechteckigen Bereich ab, der die Gesamtfläche der Seite darstellt. Die Graphics-Eigenschaft definiert das Grafikobjekt, mit dem gezeichnet werden soll. Die PageSettings-Eigenschaft ruft die Druckereinstellungen für die aktuelle Seite ab. Die übrigen Eigenschaften geben an, ob ein Druckauftrag abgebrochen werden soll oder ob weitere Seiten für den Druckauftrag vorhanden sind.

Weitere Informationen über das Drucken finden Sie in der Übersicht über den System.Drawing.Printing-Namespace.

Beispiel

Im folgenden Codebeispiel wird davon ausgegangen, dass ein Button in einem Form erstellt wurde. Die printButton_Click-Methode aus dem Beispiel erstellt eine Instanz der PrintDocument-Klasse, ruft die pd_PrintPage-Methode auf und druckt die in der pd_PrintPage-Methode angegebene BMP-Datei. Um dieses Beispiel auszuführen, ändern Sie den Pfad der zu druckenden Bitmap.

Verwenden Sie für dieses Beispiel die Namespaces System.ComponentModel, System.Collections, System.Drawing, System.Drawing.Printing, System.Resources und System.Windows.Forms.

' Specifies what happens when the user clicks the Button.
Private Sub printButton_Click(sender As Object, e As EventArgs)
    Try
        ' Assumes the default printer.
        Dim pd As New PrintDocument()
        AddHandler pd.PrintPage, AddressOf Me.pd_PrintPage
        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)
    ' 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

// Specifies what happens when the user clicks the Button.
 private void printButton_Click(object sender, EventArgs e) 
 {
   try 
   {
     // Assumes the default printer.
     PrintDocument pd = new PrintDocument();
     pd.PrintPage += new PrintPageEventHandler(this.pd_PrintPage);
     pd.Print();
   }  
   catch(Exception ex) 
   {
     MessageBox.Show("An error occurred while printing", ex.ToString());
   }
 }
 
 // Specifies what happens when the PrintPage event is raised.
 private void pd_PrintPage(object sender, PrintPageEventArgs ev) 
 {      
   // 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;
 }
 

private:
   // Specifies what happens when the user clicks the Button.
   void printButton_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      try
      {
         // Assumes the default printer.
         PrintDocument^ pd = gcnew PrintDocument;
         pd->PrintPage += gcnew PrintPageEventHandler( this, &Form1::pd_PrintPage );
         pd->Print();
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( "An error occurred while printing", ex->ToString() );
      }
   }

   // Specifies what happens when the PrintPage event is raised.
   void pd_PrintPage( Object^ /*sender*/, PrintPageEventArgs^ ev )
   {
      // 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;
   }

// Specifies what happens when the user clicks the Button.
private void printButton_Click(Object sender, EventArgs e)
{
    try {
        // Assumes the default printer.
        PrintDocument pd = new PrintDocument();
        pd.add_PrintPage(new PrintPageEventHandler(this.pd_PrintPage));
        pd.Print();
    }
    catch (System.Exception ex) {
        MessageBox.Show("An error occurred while printing", ex.ToString());
    }
} //printButton_Click

// Specifies what happens when the PrintPage event is raised.
private void pd_PrintPage(Object sender, PrintPageEventArgs ev)
{
    // Draw a picture.
    ev.get_Graphics().DrawImage(Image.FromFile
        ("C:\\My Folder\\MyFile.bmp"),
        ev.get_Graphics().get_VisibleClipBounds());

    // Indicate that this is the last page to print.
    ev.set_HasMorePages(false);
} //pd_PrintPage

Vererbungshierarchie

System.Object
   System.EventArgs
    System.Drawing.Printing.PrintPageEventArgs

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

PrintPageEventArgs-Member
System.Drawing.Printing-Namespace
Graphics-Klasse
Rectangle-Struktur
PrintEventArgs-Klasse