PrintPageEventArgs Klasse

Definition

Stellt Daten für das PrintPage-Ereignis bereit.Provides data for the PrintPage event.

public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
    inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
Vererbung
PrintPageEventArgs

Beispiele

Im folgenden Codebeispiel wird davon Button ausgegangen, dass PrintDocument ein pd mit dem Namen printButton und ein Formbenanntes auf einem erstellt wurden.The following code example assumes a Button named printButton and a PrintDocument named pd have been created on a Form. Stellen Sie sicher Click , Button dass das-Ereignis für die printButton_Click der-Methode PrintPage zugeordnet ist und PrintDocument pd_PrintPage das-Ereignis von der-Methode im Beispiel zugeordnet ist.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. Die printButton_Click -Methode aus dem Beispiel ruft Print die-Methode PrintPage auf, die das-Ereignis aufhebt, und druckt pd_PrintPage die in der-Methode angegebene BMP-Datei.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. Um dieses Beispiel auszuführen, ändern Sie den Pfad zu der Bitmap, die Sie drucken möchten.To run this example, change the path to the bitmap you want to print.

Verwenden Sie System.Drawingfür System.Drawing.Printingdieses Beispiel System.Windows.Forms die Namespaces, und.Use the System.Drawing, System.Drawing.Printing, and System.Windows.Forms namespaces for this example.

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

Die MarginBounds -Eigenschaft ruft den rechteckigen Bereich ab, der den Teil der Seite zwischen den Rändern darstellt.The MarginBounds property retrieves the rectangular area that represents the portion of the page between the margins. Die PageBounds -Eigenschaft ruft den rechteckigen Bereich ab, der den Gesamtbereich der Seite darstellt.The PageBounds property retrieves the rectangular area that represents the total area of the page. Die Graphics -Eigenschaft definiert das Grafik Objekt, mit dem die Zeichnung durchzuführen ist.The Graphics property defines the graphics object with which to do the painting. Die PageSettings -Eigenschaft ruft die Druckereinstellungen für die aktuelle Seite ab.The PageSettings property retrieves the printer settings for the current page. Die restlichen Eigenschaften geben an, ob ein Druckauftrag abgebrochen werden soll oder ob ein Druckauftrag über mehr Seiten verfügt.The remaining properties indicate whether a print job should be canceled or whether a print job has more pages.

Weitere Informationen zum Drucken mit Windows Forms finden Sie in der System.Drawing.Printing Übersicht über den Namespace.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Wenn Sie aus einer Windows Presentation Foundation Anwendung drucken möchten, finden Sie weitere System.Printing Informationen unter dem-Namespace.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Konstruktoren

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Initialisiert eine neue Instanz der PrintPageEventArgs-Klasse.Initializes a new instance of the PrintPageEventArgs class.

Eigenschaften

Cancel

Ruft einen Wert ab, der angibt, ob der Druckauftrag abgebrochen werden soll, oder legt diesen fest.Gets or sets a value indicating whether the print job should be canceled.

Graphics

Ruft das Graphics ab, das zum Zeichnen der Seite verwendet wird.Gets the Graphics used to paint the page.

HasMorePages

Ruft einen Wert ab, der angibt, ob eine zusätzliche Seite gedruckt werden soll, oder legt diesen fest.Gets or sets a value indicating whether an additional page should be printed.

MarginBounds

Ruft den rechteckigen Bereich ab, der den innerhalb der Seitenränder liegenden Teil der Seite darstellt.Gets the rectangular area that represents the portion of the page inside the margins.

PageBounds

Ruft den rechteckigen Bereich ab, der die Gesamtfläche der Seite darstellt.Gets the rectangular area that represents the total area of the page.

PageSettings

Ruft die Seiteneinstellungen für die aktuelle Seite ab.Gets the page settings for the current page.

Methoden

Equals(Object)

Ermittelt, ob das angegebene Objekt und das aktuelle Objekt gleich sind.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)

Gilt für:

Siehe auch