PrintPageEventArgs Klasse

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Quelle:

PrintPageEventArgs.cs

Stellt Daten für das PrintPage-Ereignis bereit.

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Vererbung

Object

EventArgs

PrintPageEventArgs

Beispiele

Im folgenden Codebeispiel wird davon ausgegangen, dass ein Button Benannter printButton und ein PrintDocument Benannter pd in einem Form. Stellen Sie sicher, dass das Click Ereignis für die Button Methode zugeordnet printButton_Click ist und das PrintPage Ereignis der PrintDocument Methode im Beispiel zugeordnet pd_PrintPage ist. Die printButton_Click Methode aus dem Beispiel ruft die Print Methode auf, die das PrintPage Ereignis auslöst, und druckt die in der pd_PrintPage Methode angegebene .bmp Datei. Wenn Sie dieses Beispiel ausführen möchten, ändern Sie den Pfad zur Bitmap, die Sie drucken möchten.

Verwenden Sie die System.DrawingNamespaces System.Drawing.Printingund System.Windows.Forms die Namespaces für dieses Beispiel.

private:
   // Specifies what happens when the user clicks the Button.
   void printButton_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      try
      {
         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.
     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;
 }

' 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

Hinweise

Hinweis

In .NET 6 und höheren Versionen wird das System.Drawing.Common-Paket, das diesen Typ enthält, nur unter Windows-Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps führt zu Kompilierungszeitwarnungen und Laufzeit-Ausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur unter Windows unterstützt.

Die MarginBounds Eigenschaft ruft den rechteckigen Bereich ab, der den Teil der Seite zwischen den Seitenrändern darstellt. Die PageBounds Eigenschaft ruft den rechteckigen Bereich ab, der den Gesamtbereich der Seite darstellt. Die Graphics Eigenschaft definiert das Grafikobjekt, mit dem das Gemälde erstellt werden soll. Die PageSettings Eigenschaft ruft die Druckereinstellungen für die aktuelle Seite ab. Die verbleibenden Eigenschaften geben an, ob ein Druckauftrag abgebrochen werden soll oder ob ein Druckauftrag mehr Seiten enthält.

Weitere Informationen zum Drucken mit Windows Forms finden Sie in der System.Drawing.Printing Namespaceübersicht. Wenn Sie aus einer Windows Presentation Foundation-Anwendung drucken möchten, lesen Sie den System.Printing Namespace.

Konstruktoren

Name	Beschreibung
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)	Initialisiert eine neue Instanz der PrintPageEventArgs-Klasse.

Eigenschaften

Name	Beschreibung
Cancel	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Druckauftrag abgebrochen werden soll.
Graphics	Ruft die Graphics zum Zeichnen des Zeichenblatts verwendete Ab.
HasMorePages	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob eine zusätzliche Seite gedruckt werden soll.
MarginBounds	Ruft den rechteckigen Bereich ab, der den Teil der Seite innerhalb der Seitenränder darstellt.
PageBounds	Ruft den rechteckigen Bereich ab, der den Gesamtbereich der Seite darstellt.
PageSettings	Ruft die Seiteneinstellungen für die aktuelle Seite ab.

Weitere Informationen

• Graphics
• Rectangle
• PrintEventArgs