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.
Commence la séquence de contrôle qui détermine quand et comment imprimer une page dans 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
Qui PrintDocument représente le document en cours d’impression.
Qui PrintPageEventArgs contient des données sur l’impression d’une page dans le document. Initialement, la Graphics propriété de ce paramètre sera null. La valeur retournée par la OnStartPage(PrintDocument, PrintPageEventArgs) méthode sera utilisée pour définir cette propriété.
Retours
Objet Graphics qui représente une page d’un PrintDocument.
Exceptions
L’interface de programmation d’applications Win32 native n’a pas pu préparer le pilote d’imprimante à accepter des données.
- ou -
L’API Windows native n’a pas pu mettre à jour l’imprimante spécifiée ou le contexte de périphérique de traçage (DC) à l’aide des informations spécifiées.
Remarques
OnStartPage est appelé immédiatement avant PrintDocument de déclencher l’événement PrintPage .
OnStartPrint crée l’objet utilisé dans l’impression Graphics . 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 désalloue l’objet.