StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Inicia a sequência de controlo que determina quando e como imprimir uma página num 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
A PrintDocument que representa o documento a ser impresso.
A PrintPageEventArgs que contém dados sobre como imprimir uma página no documento. Inicialmente, a Graphics propriedade deste parâmetro será null. O valor devolvido pelo OnStartPage(PrintDocument, PrintPageEventArgs) método será usado para definir esta propriedade.
Devoluções
Um Graphics objeto que representa uma página de um PrintDocument.
Exceções
A Interface de Programação de Aplicações (API) nativa do Win32 não conseguia preparar o controlador da impressora para aceitar dados.
-ou-
A API nativa do Windows não conseguia atualizar o contexto (DC) especificado da impressora ou do dispositivo plotter usando a informação especificada.
Observações
OnStartPage é chamado imediatamente antes PrintDocument de levantar o PrintPage evento.
OnStartPrint cria o Graphics objeto usado na impressão. Depois de OnStartPrint ser chamado, o OnStartPage método define o Graphics objeto para um gráfico de uma única página. O OnEndPage método limpa o Graphics objeto, enquanto o OnEndPrint método desaloca o objeto.
