PrintPageEventArgs Klas

Definitie

Biedt gegevens voor de PrintPage gebeurtenis.

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

Voorbeelden

In het volgende codevoorbeeld wordt ervan uitgegaan dat een Button benoemde printButton naam en een PrintDocument naam pd zijn gemaakt op een Form. Zorg ervoor dat de Click gebeurtenis voor de Button methode is gekoppeld printButton_Click en dat de PrintPage gebeurtenis van de PrintDocument gebeurtenis is gekoppeld aan de pd_PrintPage methode in het voorbeeld. Met printButton_Click de methode uit het voorbeeld wordt de methode aangeroepen waarmee de PrintPrintPage gebeurtenis wordt gegenereerd en wordt het .bmp-bestand afgedrukt dat is opgegeven in de pd_PrintPage methode. Als u dit voorbeeld wilt uitvoeren, wijzigt u het pad naar de bitmap die u wilt afdrukken.

Gebruik de System.Drawing, System.Drawing.Printing en System.Windows.Forms naamruimten voor dit voorbeeld.

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

Opmerkingen

Note

In .NET 6 en latere versies wordt het pakket System.Drawing.Common, dat dit type bevat, alleen ondersteund op Windows-besturingssystemen. Het gebruik van dit type in platformoverschrijdende apps veroorzaakt compileertijdwaarschuwingen en runtime-uitzonderingen. Zie System.Drawing.Common alleen ondersteund in Windows voor meer informatie.

Met MarginBounds de eigenschap wordt het rechthoekige gebied opgehaald dat het gedeelte van de pagina tussen de marges vertegenwoordigt. De PageBounds eigenschap haalt het rechthoekige gebied op dat het totale gebied van de pagina vertegenwoordigt. De Graphics eigenschap definieert het grafische object waarmee het schilderij moet worden gebruikt. De PageSettings eigenschap haalt de printerinstellingen voor de huidige pagina op. De resterende eigenschappen geven aan of een afdruktaak moet worden geannuleerd of dat een afdruktaak meer pagina's heeft.

Zie het overzicht System.Drawing.Printing naamruimte voor meer informatie over afdrukken met Windows Forms. Als u wilt afdrukken vanuit een Windows Presentation Foundation toepassing, raadpleegt u de System.Printing naamruimte.

Constructors

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

Initialiseert een nieuw exemplaar van de PrintPageEventArgs klasse.

Eigenschappen

Name Description
Cancel

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de afdruktaak moet worden geannuleerd.

Graphics

Hiermee wordt de Graphics opgegeven om de pagina te schilderen.

HasMorePages

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of een extra pagina moet worden afgedrukt.

MarginBounds

Hiermee haalt u het rechthoekige gebied op dat het gedeelte van de pagina in de marges vertegenwoordigt.

PageBounds

Hiermee haalt u het rechthoekige gebied op dat het totale gebied van de pagina vertegenwoordigt.

PageSettings

Hiermee haalt u de pagina-instellingen voor de huidige pagina op.

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook