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.

e
PrintPageEventArgs

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

Aplica-se a

Confira também