StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Méthode

Définition

Espace de noms:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

DefaultPrintController.cs

Démarre la séquence de contrôle qui détermine quand et comment imprimer une page d'un document.

public:
 override System::Drawing::Graphics ^ OnStartPage(System::Drawing::Printing::PrintDocument ^ document, System::Drawing::Printing::PrintPageEventArgs ^ e);

public override System.Drawing.Graphics OnStartPage (System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintPageEventArgs e);

override this.OnStartPage : System.Drawing.Printing.PrintDocument * System.Drawing.Printing.PrintPageEventArgs -> System.Drawing.Graphics

Public Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As Graphics

Paramètres

document

PrintDocument

PrintDocument représentant le document imprimé.

e

PrintPageEventArgs

Objet PrintPageEventArgs qui contient les paramètres d'impression d'une page d'un document. Initialement, la propriété Graphics de ce paramètre est null. La valeur retournée par la méthode OnStartPage(PrintDocument, PrintPageEventArgs) est utilisée pour définir cette propriété.

Retours

Graphics

Objet Graphics représentant une page de PrintDocument.

Exceptions

Win32Exception

L'interface de programmation d'applications (API) Win32 native n'a pas pu préparer le pilote d'impression à recevoir des données.

- ou -

L'API Windows native n'a pas pu mettre à jour le contexte de périphérique spécifié de l’imprimante ou du traceur.

Remarques

OnStartPage est appelé immédiatement avant PrintDocument que l’événement PrintPage ne déclenche.

OnStartPrint crée l’objet Graphics utilisé dans l’impression. Une fois OnStartPrint appelée, la OnStartPage méthode définit l’objet Graphics sur un graphique d’une seule page. La OnEndPage méthode efface l’objet Graphics , tandis que la OnEndPrint méthode libère l’objet.

Voir aussi

• OnEndPage(PrintDocument, PrintPageEventArgs)
• OnEndPrint(PrintDocument, PrintEventArgs)
• OnStartPrint(PrintDocument, PrintEventArgs)
• PrintPageEventArgs