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 do Windows Forms.
Classes
| Nome | Description |
|---|---|
| InvalidPrinterException |
Representa a exceção gerada 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 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 para 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 um documento é impresso ao imprimir de um aplicativo do Windows Forms. |
| PrintDocument |
Define um objeto reutilizável que envia a saída para uma impressora ao imprimir de um aplicativo do Windows Forms. |
| PrinterResolution |
Representa a resolução com suporte de uma impressora. |
| PrinterSettings |
Especifica informações sobre como um documento é impresso, incluindo a impressora que o imprime ao imprimir de um aplicativo do Windows Forms. |
| PrinterSettings.PaperSizeCollection |
Contém uma coleção de PaperSize objetos. |
| PrinterSettings.PaperSourceCollection |
Contém uma coleção de PaperSource objetos. |
| PrinterSettings.PrinterResolutionCollection |
Contém uma coleção de PrinterResolution objetos. |
| PrinterSettings.StringCollection |
Contém uma coleção de String objetos. |
| PrinterUnitConvert |
Especifica uma série de métodos de conversão que são úteis ao interoperar com a API de impressão Win32. Essa classe não pode ser herdada. |
| PrintEventArgs |
Fornece dados para os eventos BeginPrint e EndPrint. |
| PrintingPermission |
Controla o acesso a impressoras. Essa classe não pode ser herdada. |
| PrintingPermissionAttribute |
Permite verificações declarativas de permissão de impressão. |
| PrintPageEventArgs |
Fornece dados para o evento PrintPage. |
| QueryPageSettingsEventArgs |
Fornece dados para o evento QueryPageSettings. |
| StandardPrintController |
Especifica um controlador de impressão que envia informações para uma impressora. |
Enumerações
| Nome | Description |
|---|---|
| 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 ocorre. |
| PrinterResolutionKind |
Especifica uma resolução de impressora. |
| PrinterUnit |
Especifica várias das 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 a ser impressa. |
Delegados
| Nome | Description |
|---|---|
| PrintEventHandler |
Representa o método que manipulará o evento ou EndPrint o BeginPrint evento de um PrintDocument. |
| PrintPageEventHandler |
Representa o método que manipulará o PrintPage evento de um PrintDocument. |
| QueryPageSettingsEventHandler |
Representa o método que manipula o QueryPageSettings evento de um PrintDocument. |
Comentários
Normalmente, quando você imprime de um aplicativo do 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 imprimir o documento. Chamar o PrintDocument.Print método gera o PrintDocument.PrintPage evento, que deve ser tratado 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 classes e StreamReader o Graphics processo. 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, os PrintController controles de como um PrintDocument é impresso. O PrintDocument.Print método invoca os métodos, OnEndPrintOnStartPagee OnEndPage do controlador de OnStartPrintimpressão, que, por sua vez, informam à impressora como imprimir o documento. Para obter mais informações sobre caixas de diálogo de impressão, 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
Classes dentro do System.Drawing.Printing namespace não têm suporte para uso em um serviço do Windows ou ASP.NET aplicativo ou serviço. A tentativa de 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 WPF (Windows Presentation Foundation), consulte o System.Printing namespace.
