StandardPrintController.OnEndPage(PrintDocument, PrintPageEventArgs) Método
Definição
Conclui a sequência de controle que determina quando e como uma página de um documento será impressa.Completes the control sequence that determines when and how to print a page of a document.
public:
override void OnEndPage(System::Drawing::Printing::PrintDocument ^ document, System::Drawing::Printing::PrintPageEventArgs ^ e);
public override void OnEndPage (System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintPageEventArgs e);
override this.OnEndPage : System.Drawing.Printing.PrintDocument * System.Drawing.Printing.PrintPageEventArgs -> unit
Public Overrides Sub OnEndPage (document As PrintDocument, e As PrintPageEventArgs)
Parâmetros
- document
- PrintDocument
Um PrintDocument que representa o documento que está sendo impresso.A PrintDocument that represents the document being printed.
Um PrintPageEventArgs que contém dados sobre como imprimir uma página no documento.A PrintPageEventArgs that contains data about how to print a page in the document.
Exceções
A API (Interface de Programação de Aplicativo) nativa do Win32 não pôde concluir a gravação em uma página.The native Win32 Application Programming Interface (API) could not finish writing to a page.
Comentários
OnEndPage é chamado imediatamente depois que o PrintDocument gera o PrintPage evento.OnEndPage is called immediately after the PrintDocument raises the PrintPage event. Se uma exceção for lançada dentro de um PrintPage evento de a PrintDocument , OnEndPage não será chamada.If an exception is thrown inside a PrintPage event of a PrintDocument, OnEndPage is not called.
OnStartPrint cria o Graphics objeto que é enviado para a impressora.OnStartPrint creates the Graphics object that is sent to the printer. Depois que OnStartPrint é chamado, o OnStartPage método define o Graphics objeto como um gráfico de uma única página.After OnStartPrint is called, the OnStartPage method sets the Graphics object to a graphic of a single page. O OnEndPage método limpa o Graphics objeto, enquanto o OnEndPrint método Desaloca o objeto.The OnEndPage method clears the Graphics object, while the OnEndPrint method deallocates the object.
Quando OnEndPage é chamado a partir de um contexto de impressão de um PrintDialog PrintingPermission de um de SafePrinting é necessário.When OnEndPage is called from a printing context of a PrintDialog a PrintingPermission of SafePrinting is required. A impressão na impressora padrão requer um PrintingPermission de DefaultPrinting .Printing to the default printer requires a PrintingPermission of DefaultPrinting. Todas as outras chamadas esse método requer um PrintingPermission de AllPrintingAll other calls this method requires a PrintingPermission of AllPrinting