PrintPageEventArgs Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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
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) |