StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Inicia a sequência de controle que determina quando e como imprimir uma página em um documento.
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 GraphicsParâmetros
- document
- PrintDocument
Um PrintDocument que representa o documento que está sendo impresso.
Um PrintPageEventArgs que contém dados sobre como imprimir uma página no documento. Inicialmente, a Graphics propriedade desse parâmetro será null. O valor retornado do OnStartPage(PrintDocument, PrintPageEventArgs) método será usado para definir essa propriedade.
Retornos
Um Graphics objeto que representa uma página de um PrintDocument.
Exceções
A API (Interface de Programação de Aplicativo) win32 nativa não pôde preparar o driver de impressora para aceitar dados.
- ou -
A API de Windows nativa não pôde atualizar o DC (contexto de dispositivo de plotador ou impressora) especificado 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 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.
