PrintPageEventArgs Classe

Définition

Fournit des données pour l'événement PrintPage.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
Héritage
PrintPageEventArgs

Exemples

L’exemple de code suivant suppose qu’un Button nommé printButton et un PrintDocument nommé pd ont été créés sur un Form .The following code example assumes a Button named printButton and a PrintDocument named pd have been created on a Form. Assurez-vous que l' Click événement pour Button est associé à la printButton_Click méthode et que l' PrintPage événement du PrintDocument est associé à la pd_PrintPage méthode dans l’exemple.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. La printButton_Click méthode de l’exemple appelle la Print méthode déclenchant l' PrintPage événement et imprime le fichier. bmp spécifié dans la pd_PrintPage méthode.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. Pour exécuter cet exemple, modifiez le chemin d’accès à l’image bitmap que vous souhaitez imprimer.To run this example, change the path to the bitmap you want to print.

Utilisez les System.Drawing System.Drawing.Printing System.Windows.Forms espaces de noms, et pour cet exemple.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

Remarques

La MarginBounds propriété récupère la zone rectangulaire qui représente la partie de la page entre les marges.The MarginBounds property retrieves the rectangular area that represents the portion of the page between the margins. La PageBounds propriété récupère la zone rectangulaire qui représente la zone totale de la page.The PageBounds property retrieves the rectangular area that represents the total area of the page. La Graphics propriété définit l’objet Graphics avec lequel effectuer la peinture.The Graphics property defines the graphics object with which to do the painting. La PageSettings propriété récupère les paramètres de l’imprimante pour la page actuelle.The PageSettings property retrieves the printer settings for the current page. Les propriétés restantes indiquent si un travail d’impression doit être annulé ou si un travail d’impression contient plus de pages.The remaining properties indicate whether a print job should be canceled or whether a print job has more pages.

Pour plus d’informations sur l’impression avec Windows Forms, consultez System.Drawing.Printing vue d’ensemble de l’espace de noms.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Si vous souhaitez imprimer à partir d’une application Windows Presentation Foundation, consultez l' System.Printing espace de noms.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Constructeurs

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Initialise une nouvelle instance de la classe PrintPageEventArgs.Initializes a new instance of the PrintPageEventArgs class.

Propriétés

Cancel

Obtient ou définit une valeur indiquant si le travail d'impression doit être annulé.Gets or sets a value indicating whether the print job should be canceled.

Graphics

Obtient l'objet Graphics utilisé pour peindre la page.Gets the Graphics used to paint the page.

HasMorePages

Obtient ou définit une valeur indiquant si une autre page doit être imprimée.Gets or sets a value indicating whether an additional page should be printed.

MarginBounds

Obtient la zone rectangulaire qui représente la partie de la page à l'intérieur des marges.Gets the rectangular area that represents the portion of the page inside the margins.

PageBounds

Obtient la zone rectangulaire qui représente la zone totale de la page.Gets the rectangular area that represents the total area of the page.

PageSettings

Obtient les paramètres de page correspondant à la page en cours.Gets the page settings for the current page.

Méthodes

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

S’applique à

Voir aussi