System.Drawing.Printing Namespace
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.
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 .
