StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Método

Definição

Namespace:

System.Drawing.Printing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

DefaultPrintController.cs

Inicia a sequência de controle que determina quando e como uma página de um documento será impressa.

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

Parâmetros

document

PrintDocument

Um PrintDocument que representa o documento que está sendo impresso.

e

PrintPageEventArgs

Um PrintPageEventArgs que contém dados sobre como imprimir uma página no documento. Inicialmente, a propriedade Graphics deste parâmetro será null. O valor retornado do método OnStartPage(PrintDocument, PrintPageEventArgs) será usado para definir este propriedade.

Retornos

Graphics

Um objeto Graphics que representa uma página de um PrintDocument.

Exceções

Win32Exception

A API (Interface de Programação de Aplicativo) nativa do Win32 não pôde preparar o driver da impressora para aceitar dados.

- ou -

A API nativa do Windows não pôde atualizar o DC (contexto do dispositivo) da plotadora ou impressora especificada, usando as informações especificadas.

Comentários

OnStartPage é chamado imediatamente antes PrintDocument de gerar o PrintPage evento.

OnStartPrint cria o Graphics objeto usado na impressão. Depois OnStartPrint de ser chamado, o OnStartPage método define o Graphics objeto como um gráfico de uma única página. O OnEndPage método limpa o Graphics objeto, enquanto o OnEndPrint método desaloca o objeto.

Confira também

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