PrintPageEventArgs Klasse

Definition

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Assembly:

System.Drawing.dll

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 benannter Name und ein Button PrintDocument benannter printButton pd Name auf einer Form. Stellen Sie sicher, dass das Click Ereignis für Button die Methode zugeordnet ist und das PrintPage Ereignis PrintDocument der Methode im Beispiel zugeordnet pd_PrintPage istprintButton_Click. Die printButton_Click Methode aus dem Beispiel ruft die Methode auf, die das Ereignis auslöstPrintPage, und druckt die Print in der pd_PrintPage Methode angegebene .bmp Datei. Um dieses Beispiel auszuführen, ändern Sie den Pfad zur Bitmap, die Sie drucken möchten.

Verwenden Sie die Namespaces System.Drawing.Printingund System.Windows.Forms die System.DrawingNamespaces 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öher wird das System.Drawing.Common-Paket,das diesen Typ enthält, nur auf Windows Betriebssystemen unterstützt. Die Verwendung dieses Typs in plattformübergreifenden Apps verursacht Warnungen zur Kompilierzeit und Laufzeitausnahmen. Weitere Informationen finden Sie unter System.Drawing.Common wird nur für 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 Bild 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 aufweist.

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

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Initialisiert eine neue Instanz der PrintPageEventArgs-Klasse.

Eigenschaften

Cancel	Ruft einen Wert ab, der angibt, ob der Druckauftrag abgebrochen werden soll, oder legt diesen fest.
Graphics	Ruft das Graphics ab, das zum Zeichnen der Seite verwendet wird.
HasMorePages	Ruft einen Wert ab, der angibt, ob eine zusätzliche Seite gedruckt werden soll, oder legt diesen fest.
MarginBounds	Ruft den rechteckigen Bereich ab, der den innerhalb der Seitenränder liegenden Teil der Seite darstellt.
PageBounds	Ruft den rechteckigen Bereich ab, der die Gesamtfläche der Seite darstellt.
PageSettings	Ruft die Seiteneinstellungen für die aktuelle Seite ab.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Siehe auch

• Graphics
• Rectangle
• PrintEventArgs