PrintPageEventArgs Klass

Definition

Innehåller data för PrintPage händelsen.

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

Exempel

I följande kodexempel förutsätts att ett Button namngivet printButton och ett PrintDocument namngivet pd har skapats på en Form. Kontrollera att Click händelsen för Button är associerad med printButton_Click metoden och PrintPage att händelsen PrintDocument är associerad med pd_PrintPage metoden i exemplet. Metoden printButton_Click i exemplet anropar metoden Print som höjer PrintPage händelsen och skriver ut den .bmp fil som anges i pd_PrintPage metoden. Om du vill köra det här exemplet ändrar du sökvägen till den bitmapp som du vill skriva ut.

Använd namnrymderna System.Drawing, System.Drawing.Printing och System.Windows.Forms för det här exemplet.

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

Kommentarer

Note

I .NET 6 och senare versioner stöds endast System.Drawing.Common-paketet, som innehåller den här typen, på Windows-operativsystem. Användning av den här typen i plattformsoberoende appar orsakar kompileringstidsvarningar och körningsfel. Mer information finns i System.Drawing.Common som endast stöds i Windows.

Egenskapen MarginBounds hämtar det rektangulära området som representerar delen av sidan mellan marginalerna. Egenskapen PageBounds hämtar det rektangulära området som representerar sidans totala yta. Egenskapen Graphics definierar det grafikobjekt som målningen ska utföras med. Egenskapen PageSettings hämtar skrivarinställningarna för den aktuella sidan. De återstående egenskaperna anger om ett utskriftsjobb ska avbrytas eller om ett utskriftsjobb har fler sidor.

Mer information om hur du skriver ut med Windows Forms finns i översikten System.Drawing.Printing namnområde. Om du vill skriva ut från ett Windows Presentation Foundation program läser du namnområdet System.Printing.

Konstruktorer

Name Description
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Initierar en ny instans av PrintPageEventArgs klassen.

Egenskaper

Name Description
Cancel

Hämtar eller anger ett värde som anger om utskriftsjobbet ska avbrytas.

Graphics

Hämtar den Graphics som används för att måla sidan.

HasMorePages

Hämtar eller anger ett värde som anger om en ytterligare sida ska skrivas ut.

MarginBounds

Hämtar det rektangulära området som representerar delen av sidan inuti marginalerna.

PageBounds

Hämtar det rektangulära området som representerar den totala ytan på sidan.

PageSettings

Hämtar sidinställningarna för den aktuella sidan.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även