PreviewPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Método

Definição

Inicia a sequência de controles que determina quando e como visualizar uma página em um documento de impressão.Begins the control sequence that determines when and how to preview a page in a print document.

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 visualizado.A PrintDocument that represents the document being previewed.

e
PrintPageEventArgs

Um PrintPageEventArgs que contém dados sobre como visualizar uma página no documento de impressão.A PrintPageEventArgs that contains data about how to preview a page in the print document. Inicialmente, a propriedade Graphics deste parâmetro será null.Initially, the Graphics property of this parameter will be null. O valor retornado desse método será usado para definir este propriedade.The value returned from this method will be used to set this property.

Retornos

Graphics

Um Graphics que representa uma página de um PrintDocument.A Graphics that represents a page from a PrintDocument.

Comentários

OnStartPage é chamado imediatamente antes PrintDocument de gerar o PrintPage evento.OnStartPage is called immediately before PrintDocument raises the PrintPage event.

OnStartPrint cria o Graphics que é exibido durante a visualização de impressão.OnStartPrint creates the Graphics that is displayed during the print preview. Depois que OnStartPrint é chamado, o OnStartPage método define o Graphics como um gráfico de uma única página.After OnStartPrint is called, the OnStartPage method sets the Graphics to a graphic of a single page. O OnEndPage método limpa o Graphics , enquanto o OnEndPrint método Desaloca o objeto.The OnEndPage method clears the Graphics, while the OnEndPrint method deallocates the object.

Observação

A suavização de serrilhado, também conhecida como escala de cinza, faz com que a visualização da impressão fique melhor.Anti-aliasing, also known as gray scaling, makes the print preview look better. No entanto, o uso de suavização de serrilhado pode retardar a velocidade de renderização.However, the use of anti-aliasing can slow down the rendering speed. Para obter mais informações sobre a suavização de serrilhado, consulte a UseAntiAlias propriedade.For more information about anti-aliasing, see the UseAntiAlias property.

Aplica-se a

Confira também