StandardPrintController.OnStartPrint(PrintDocument, PrintEventArgs) Método

Referência

Definição

Namespace:: System.Drawing.Printing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Pacote:: System.Drawing.Common v6.0.0

Pacote:: System.Drawing.Common v7.0.0

Pacote:: System.Drawing.Common v8.0.0

Pacote:: System.Drawing.Common v9.0.0-preview.2.24128.3

Origem:: DefaultPrintController.cs

Origem:: DefaultPrintController.cs

Origem:: DefaultPrintController.cs

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 um documento será impresso.

public:
 override void OnStartPrint(System::Drawing::Printing::PrintDocument ^ document, System::Drawing::Printing::PrintEventArgs ^ e);

public override void OnStartPrint (System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintEventArgs e);

override this.OnStartPrint : System.Drawing.Printing.PrintDocument * System.Drawing.Printing.PrintEventArgs -> unit

Public Overrides Sub OnStartPrint (document As PrintDocument, e As PrintEventArgs)

Parâmetros

document: PrintDocument

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

e: PrintEventArgs

Um PrintEventArgs que contém dados sobre como imprimir o documento.

Exceções

InvalidPrinterException

As configurações da impressora não são válidas.

Win32Exception

A API (Interface de Programação de Aplicativo) nativa do Win32 não pode iniciar um trabalho de impressão.

Comentários

OnStartPrint é chamado imediatamente após PrintDocument gerar o BeginPrint 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.

OnStartPrint verifica se as configurações da impressora são válidas.

Aplica-se a

Partilhar via