Compartilhar via


System.Drawing.Printing Namespace

Fornece serviços relacionados à impressão para aplicativos Windows Forms.

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.

Margins

Especifica as dimensões das margens de uma página impressa.

MarginsConverter

Fornece um MarginsConverter para o Margins.

PageSettings

Especifica as configurações que se aplicam a uma única página impressa.

PaperSize

Especifica o tamanho de um pedaço de papel.

PaperSource

Especifica a bandeja de papel da qual a impressora obtém papel.

PreviewPageInfo

Especifica informações de visualização de impressão de uma única página. Essa classe não pode ser herdada.

PreviewPrintController

Especifica um controlador de impressão que exibe um documento em uma tela como uma série de imagens.

PrintController

Controla como o documento é impresso, durante a impressão por meio de um aplicativo do Windows Forms.

PrintDocument

Define um objeto reutilizável que envia a saída para uma impressora ao imprimir usando um aplicativo do Windows Forms.

PrinterResolution

Representa a resolução com suporte em uma impressora.

PrinterSettings

Especifica informações sobre como um documento é impresso, incluindo a impressora que o imprime, ao imprimir com base em um aplicativo Windows Forms.

PrinterSettings.PaperSizeCollection

Contém uma coleção de objetos PaperSize .

PrinterSettings.PaperSourceCollection

Contém uma coleção de objetos PaperSource .

PrinterSettings.PrinterResolutionCollection

Contém uma coleção de objetos PrinterResolution .

PrinterSettings.StringCollection

Contém uma coleção de objetos String .

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. Essa classe não pode ser herdada.

PrintEventArgs

Fornece dados para os eventos de BeginPrint e de EndPrint .

PrintingPermission

Controla o acesso às impressoras. Essa classe não pode ser herdada.

PrintingPermissionAttribute

Permite verificações de permissão de impressão declarativa.

PrintPageEventArgs

Fornece dados para o evento de PrintPage .

QueryPageSettingsEventArgs

Fornece dados para o evento de QueryPageSettings .

StandardPrintController

Especifica um controlador de impressão que envia informações a uma impressora.

Enumerações

Duplex

Especifica a configuração duplex da impressora.

PaperKind

Especifica os tamanhos de papel padrão.

PaperSourceKind

Fontes de papel padrão.

PrintAction

Especifica o tipo de operação de impressão que está ocorrendo.

PrinterResolutionKind

Especifica uma resolução de impressora.

PrinterUnit

Especifica várias unidades de medida usadas para impressão.

PrintingPermissionLevel

Especifica o tipo de impressão que o código tem permissão para fazer.

PrintRange

Especifica a parte do documento para impressão.

Delegados

PrintEventHandler

Representa o método que manipulará o evento BeginPrint ou EndPrint de um PrintDocument.

PrintPageEventHandler

Representa o método que manipulará o evento de PrintPage de PrintDocument.

QueryPageSettingsEventHandler

Representa o método que manipula o evento QueryPageSettings de um PrintDocument.

Comentários

Normalmente, quando você imprime de um aplicativo Windows Forms, cria uma nova instância da PrintDocument classe , define propriedades, como DefaultPageSettings e PrinterSettings, que descrevem como imprimir e chamam o Print método para realmente imprimir o documento. Chamar o PrintDocument.Print método aciona o PrintDocument.PrintPage evento , que deve ser manipulado para executar o layout do documento para impressão.

Use a Graphics propriedade do PrintPageEventArgs objeto obtido do PrintDocument.PrintPage evento para especificar a saída a ser impressa. Se você estiver imprimindo um arquivo de texto, use StreamReader para ler uma linha de cada vez do fluxo e chamar o DrawString método para desenhar a linha no objeto gráfico. Para obter mais informações sobre esse processo, consulte as Graphics classes e StreamReader . Você pode exibir um exemplo de impressão de um documento de texto no tópico de visão geral da PrintDocument classe.

Observação

Não DrawText há suporte para os métodos da TextRenderer classe para impressão. Em vez disso, use os DrawString métodos da Graphics classe .

Quando implementado em uma classe derivada, o PrintController controla como um PrintDocument é impresso. O PrintDocument.Print método invoca os métodos , OnEndPrint, OnStartPagee OnEndPage do OnStartPrintcontrolador de impressão, que, por sua vez, informam à impressora como imprimir o documento. Para obter mais informações sobre como imprimir caixas de diálogo, consulte PrintDialog e PageSetupDialog.

O processo de visualização de impressão usa um controlador de impressão especializado, uma caixa de diálogo e um controle. Para obter um exemplo desse controlador de impressão e caixa de diálogo, consulte PreviewPrintController, PrintPreviewDialoge PrintPreviewControl.

Cuidado

Não há suporte para classes no System.Drawing.Printing namespace para uso em um serviço Windows ou ASP.NET aplicativo ou serviço. Tentar usar essas classes de dentro de um desses tipos de aplicativo pode produzir problemas inesperados, como redução do desempenho do serviço e exceções em tempo de execução.

Se você quiser imprimir de um aplicativo de Windows Presentation Foundation (WPF), consulte o System.Printing namespace .

Confira também