PrintPageEventArgs Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit des données pour l'événement PrintPage.
public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
- Héritage
Exemples
L’exemple de code suivant suppose qu’un Button nommé printButton
et un PrintDocument nommé pd
ont été créés sur un Form. Vérifiez que l’événement Click pour le Button est associé à la printButton_Click
méthode et que l’événement PrintPage du PrintDocument est associé à la pd_PrintPage
méthode dans l’exemple. La printButton_Click
méthode de l’exemple appelle la Print méthode qui déclenche l’événement PrintPage et imprime le fichier .bmp spécifié dans la pd_PrintPage
méthode . Pour exécuter cet exemple, modifiez le chemin d’accès à la bitmap que vous souhaitez imprimer.
Utilisez les System.Drawingespaces de noms , System.Drawing.Printinget System.Windows.Forms pour cet exemple.
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
Notes
Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est pris en charge uniquement sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes provoque des avertissements au moment de la compilation et des exceptions d’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.
La MarginBounds propriété récupère la zone rectangulaire qui représente la partie de la page entre les marges. La PageBounds propriété récupère la zone rectangulaire qui représente la zone totale de la page. La Graphics propriété définit l’objet graphics avec lequel effectuer la peinture. La PageSettings propriété récupère les paramètres de l’imprimante pour la page active. Les propriétés restantes indiquent si un travail d’impression doit être annulé ou si un travail d’impression comporte plus de pages.
Pour plus d’informations sur l’impression avec Windows Forms, consultez la vue d’ensemble de l’espace System.Drawing.Printing de noms. Si vous souhaitez imprimer à partir d’une application Windows Presentation Foundation, consultez l’espace de System.Printing noms .
Constructeurs
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) |
Initialise une nouvelle instance de la classe PrintPageEventArgs. |
Propriétés
Cancel |
Obtient ou définit une valeur indiquant si le travail d'impression doit être annulé. |
Graphics |
Obtient l'objet Graphics utilisé pour peindre la page. |
HasMorePages |
Obtient ou définit une valeur indiquant si une autre page doit être imprimée. |
MarginBounds |
Obtient la zone rectangulaire qui représente la partie de la page à l'intérieur des marges. |
PageBounds |
Obtient la zone rectangulaire qui représente la zone totale de la page. |
PageSettings |
Obtient les paramètres de page correspondant à la page en cours. |
Méthodes
Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |