System.Drawing.Printing Namespace

O namespace System.Drawing.Printing fornece serviços relacionados à impressão para aplicativos Windows Forms. The System.Drawing.Printing namespace provides print-related services for Windows Forms applications.

Classes

InvalidPrinterException

Representa a exceção lançada quando você tenta acessar uma impressora usando configurações de impressora que não são válidas.Represents the exception that is thrown when you try to access a printer using printer settings that are not valid.

Margins

Especifica as dimensões das margens de uma página impressa.Specifies the dimensions of the margins of a printed page.

MarginsConverter

Fornece um MarginsConverter para o Margins.Provides a MarginsConverter for Margins.

PageSettings

Especifica as configurações que se aplicam a uma única página impressa.Specifies settings that apply to a single, printed page.

PaperSize

Especifica o tamanho de um pedaço de papel.Specifies the size of a piece of paper.

PaperSource

Especifica a bandeja de papel da qual a impressora obtém papel.Specifies the paper tray from which the printer gets paper.

PreviewPageInfo

Especifica informações de visualização de impressão de uma única página.Specifies print preview information for a single page. Essa classe não pode ser herdada.This class cannot be inherited.

PreviewPrintController

Especifica um controlador de impressão que exibe um documento em uma tela como uma série de imagens.Specifies a print controller that displays a document on a screen as a series of images.

PrintController

Controla como o documento é impresso, durante a impressão por meio de um aplicativo do Windows Forms.Controls how a document is printed, when printing from a Windows Forms application.

PrintDocument

Define um objeto reutilizável que envia a saída para uma impressora ao imprimir usando um aplicativo do Windows Forms.Defines a reusable object that sends output to a printer, when printing from a Windows Forms application.

PrinterResolution

Representa a resolução com suporte em uma impressora.Represents the resolution supported by a printer.

PrinterSettings

Especifica informações sobre como um documento é impresso, incluindo a impressora que o imprime, ao imprimir com base em um aplicativo Windows Forms.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

PrinterSettings.PaperSizeCollection

Contém uma coleção de objetos PaperSize .Contains a collection of PaperSize objects.

PrinterSettings.PaperSourceCollection

Contém uma coleção de objetos PaperSource .Contains a collection of PaperSource objects.

PrinterSettings.PrinterResolutionCollection

Contém uma coleção de objetos PrinterResolution .Contains a collection of PrinterResolution objects.

PrinterSettings.StringCollection

Contém uma coleção de objetos String .Contains a collection of String objects.

PrinterUnitConvert

Especifica uma série de métodos de conversão que são úteis ao interoperacionar com a API de impressão do Win32 API.Specifies a series of conversion methods that are useful when interoperating with the Win32 printing API. Essa classe não pode ser herdada.This class cannot be inherited.

PrintEventArgs

Fornece dados para os eventos de BeginPrint e de EndPrint .Provides data for the BeginPrint and EndPrint events.

PrintingPermission

Controla o acesso às impressoras.Controls access to printers. Essa classe não pode ser herdada.This class cannot be inherited.

PrintingPermissionAttribute

Permite verificações de permissão de impressão declarativa.Allows declarative printing permission checks.

PrintPageEventArgs

Fornece dados para o evento de PrintPage .Provides data for the PrintPage event.

QueryPageSettingsEventArgs

Fornece dados para o evento de QueryPageSettings .Provides data for the QueryPageSettings event.

StandardPrintController

Especifica um controlador de impressão que envia informações a uma impressora.Specifies a print controller that sends information to a printer.

Enumerações

Duplex

Especifica a configuração duplex da impressora.Specifies the printer's duplex setting.

PaperKind

Especifica os tamanhos de papel padrão.Specifies the standard paper sizes.

PaperSourceKind

Fontes de papel padrão.Standard paper sources.

PrintAction

Especifica o tipo de operação de impressão que está ocorrendo.Specifies the type of print operation occurring.

PrinterResolutionKind

Especifica uma resolução de impressora.Specifies a printer resolution.

PrinterUnit

Especifica várias unidades de medida usadas para impressão.Specifies several of the units of measure used for printing.

PrintingPermissionLevel

Especifica o tipo de impressão que o código tem permissão para fazer.Specifies the type of printing that code is allowed to do.

PrintRange

Especifica a parte do documento para impressão.Specifies the part of the document to print.

Delegados

PrintEventHandler

Representa o método que manipulará o evento BeginPrint ou EndPrint de um PrintDocument.Represents the method that will handle the BeginPrint or EndPrint event of a PrintDocument.

PrintPageEventHandler

Representa o método que manipulará o evento de PrintPage de PrintDocument.Represents the method that will handle the PrintPage event of a PrintDocument.

QueryPageSettingsEventHandler

Representa o método que manipula o evento QueryPageSettings de um PrintDocument.Represents the method that handles the QueryPageSettings event of a PrintDocument.

Comentários

Normalmente, quando você imprimir de um aplicativo Windows Forms, você cria uma nova instância da PrintDocument classe, definir propriedades, tais como DefaultPageSettings e PrinterSettings, que descrevem como imprimir e, em seguida, chamar o Print método para efetivamente imprimir o documento.Typically, when you print from a Windows Forms application, you create a new instance of the PrintDocument class, set properties, such as DefaultPageSettings and PrinterSettings, that describe how to print, and call the Print method to actually print the document. Chamar o PrintDocument.Print método aciona o PrintDocument.PrintPage evento, que deve ser tratado para executar o layout do documento para impressão.Calling the PrintDocument.Print method raises the PrintDocument.PrintPage event, which should be handled to perform the document layout for printing.

Use o Graphics propriedade do PrintPageEventArgs obtido do objeto a PrintDocument.PrintPage eventos para especificar a saída de impressão.Use the Graphics property of the PrintPageEventArgs object obtained from the PrintDocument.PrintPage event to specify the output to print. Se você estiver imprimindo um arquivo de texto, use StreamReader para ler uma linha por vez do fluxo e chama o DrawString método para desenhar a linha no objeto de elementos gráficos.If you are printing a text file, use StreamReader to read one line at a time from the stream and call the DrawString method to draw the line in the graphics object. Para obter mais informações sobre esse processo, consulte o Graphics e StreamReader classes.For more information about this process, see the Graphics and StreamReader classes. Você pode exibir um exemplo de impressão de um documento de texto no PrintDocument tópico de visão geral da classe.You can view an example of printing a text document in the PrintDocument class overview topic.

Observação

O DrawText métodos do TextRenderer classe não dá suporte para impressão.The DrawText methods of the TextRenderer class are not supported for printing. Em vez disso, use o DrawString métodos do Graphics classe.Instead, use the DrawString methods of the Graphics class.

Quando implementado em uma classe derivada, o PrintController controles como um PrintDocument é impresso.When implemented in a derived class, the PrintController controls how a PrintDocument is printed. O PrintDocument.Print método invoca o controlador de impressão OnStartPrint, OnEndPrint, OnStartPage, e OnEndPage métodos, que por sua vez informam a impressora como imprimir o documento.The PrintDocument.Print method invokes the print controller's OnStartPrint, OnEndPrint, OnStartPage, and OnEndPage methods, which in turn tell the printer how to print the document. Para obter mais informações sobre caixas de diálogo de impressão, consulte PrintDialog e PageSetupDialog.For more information about printing dialog boxes, see PrintDialog and PageSetupDialog.

O processo de visualização de impressão usa um controlador de impressão especializado, caixa de diálogo e controle.The print-preview process uses a specialized print controller, dialog box, and control. Para obter um exemplo de um controlador de impressão e caixa de diálogo, consulte PreviewPrintController, PrintPreviewDialog, e PrintPreviewControl.For an example of such a print controller and dialog box, see PreviewPrintController, PrintPreviewDialog, and PrintPreviewControl.

Cuidado

Classes dentro do System.Drawing.Printing namespace não têm suporte para uso dentro de um serviço do Windows ou o aplicativo ASP.NET ou serviço.Classes within the System.Drawing.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Tentativa de usar essas classes de dentro de um desses tipos de aplicativo pode produzir problemas inesperados, como diminuído exceções de desempenho e tempo de execução de serviço.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Se você quiser imprimir em um aplicativo Windows Presentation Foundation (WPF), consulte o System.Printing namespace.If you want to print from a Windows Presentation Foundation (WPF) application, see the System.Printing namespace.