StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Méthode
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.
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.GraphicsPublic Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As GraphicsParamètres
- document
- PrintDocument
PrintDocument représentant le document imprimé.
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
Objet Graphics représentant une page de PrintDocument.
Exceptions
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.
