PrintPageEventArgs Classe

Definizione

Spazio dei nomi:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

PrintPageEventArgs.cs

Fornisce i dati per l'evento PrintPage.

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

Ereditarietà

Object

EventArgs

PrintPageEventArgs

Esempio

Nell'esempio di codice seguente si presuppone che un Button denominato e un PrintDocument denominato printButtonpd siano stati creati in un Formoggetto . Assicurarsi che l'evento Click per l'oggetto Button sia associato printButton_Click al metodo e che l'evento PrintPage dell'oggetto PrintDocument sia associato al pd_PrintPage metodo nell'esempio. Il printButton_Click metodo dell'esempio chiama il metodo che genera l'evento PrintPage e stampa il Print file .bmp specificato nel pd_PrintPage metodo . Per eseguire questo esempio, modificare il percorso della bitmap da stampare.

Usare gli System.Drawingspazi dei nomi , System.Drawing.Printinge System.Windows.Forms per questo esempio.

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

Commenti

Nota

In .NET 6 e versioni successive il pacchetto System.Drawing.Common, che include questo tipo, è supportato solo nei sistemi operativi Windows. L'uso di questo tipo nelle app multipiattaforma causa avvisi in fase di compilazione e eccezioni in fase di esecuzione. Per altre informazioni, vedere System.Drawing.Common supportato solo in Windows.

La MarginBounds proprietà recupera l'area rettangolare che rappresenta la parte della pagina tra i margini. La PageBounds proprietà recupera l'area rettangolare che rappresenta l'area totale della pagina. La Graphics proprietà definisce l'oggetto grafico con cui eseguire il disegno. La PageSettings proprietà recupera le impostazioni della stampante per la pagina corrente. Le proprietà rimanenti indicano se un processo di stampa deve essere annullato o se un processo di stampa ha più pagine.

Per altre informazioni sulla stampa con Windows Forms, vedere panoramica dello System.Drawing.Printing spazio dei nomi. Se si desidera stampare da un'applicazione Windows Presentation Foundation, vedere lo System.Printing spazio dei nomi.

Costruttori

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Inizializza una nuova istanza della classe PrintPageEventArgs.

Proprietà

Cancel	Ottiene o imposta un valore che indica se il processo di stampa deve essere annullato.
Graphics	Ottiene l’oggetto Graphics utilizzato per disegnare la pagina.
HasMorePages	Ottiene o imposta un valore che indica se deve essere stampata una pagina aggiuntiva.
MarginBounds	Ottiene l'area rettangolare che rappresenta la parte della pagina all'interno dei margini.
PageBounds	Ottiene l'area rettangolare che rappresenta l'area totale della pagina.
PageSettings	Ottiene le impostazioni di pagina per la pagina corrente.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Graphics
• Rectangle
• PrintEventArgs