System.Drawing.Printing Espaço de Nomes
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece serviços relacionados com impressão para aplicações Windows Forms.
Classes
| Name | Description |
|---|---|
| InvalidPrinterException |
Representa a exceção que é lançada quando tentas aceder a uma impressora usando definiçõ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 definições que se aplicam a uma única página impressa. |
| PaperSize |
Especifica o tamanho de uma folha de papel. |
| PaperSource |
Especifica a bandeja de papel de onde a impressora obtém papel. |
| PreviewPageInfo |
Especifica informação de pré-visualização de impressão para uma única página. Esta classe não pode ser herdada. |
| PreviewPrintController |
Especifica um controlador de impressão que exibe um documento num ecrã como uma série de imagens. |
| PrintController |
Controla como um documento é impresso, ao imprimir a partir de uma aplicação Windows Forms. |
| PrintDocument |
Define um objeto reutilizável que envia saída para uma impressora, ao imprimir a partir de uma aplicação Windows Forms. |
| PrinterResolution |
Representa a resolução suportada por uma impressora. |
| PrinterSettings |
Especifica informações sobre como um documento é impresso, incluindo a impressora que o imprime, ao imprimir a partir de uma aplicação 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 do Win32. Esta classe não pode ser herdada. |
| PrintEventArgs |
Fornece dados para os eventos BeginPrint e EndPrint. |
| PrintingPermission |
Controla o acesso às impressoras. Esta classe não pode ser herdada. |
| PrintingPermissionAttribute |
Permite verificações declarativas de permissões de impressão. |
| PrintPageEventArgs |
Fornece dados para o PrintPage evento. |
| QueryPageSettingsEventArgs |
Fornece dados para o QueryPageSettings evento. |
| StandardPrintController |
Especifica um controlador de impressão que envia informação para uma impressora. |
Enumerações
| Name | Description |
|---|---|
| Duplex |
Especifica a configuração duplex da impressora. |
| PaperKind |
Especifica os tamanhos padrão dos papéis. |
| PaperSourceKind |
Fontes padrão em papel. |
| PrintAction |
Especifica o tipo de operação de impressão que está a ocorrer. |
| PrinterResolutionKind |
Especifica a resolução da impressora. |
| PrinterUnit |
Especifica várias das unidades de medida usadas para impressão. |
| PrintingPermissionLevel |
Especifica o tipo de impressão que esse código pode fazer. |
| PrintRange |
Especifica a parte do documento a imprimir. |
Delegados
| Name | Description |
|---|---|
| PrintEventHandler |
Representa o método que irá tratar o BeginPrint ou EndPrint evento de um PrintDocument. |
| PrintPageEventHandler |
Representa o método que irá lidar com o PrintPage evento de um PrintDocument. |
| QueryPageSettingsEventHandler |
Representa o método que gere o QueryPageSettings evento de um PrintDocument. |
Observações
Normalmente, quando imprime a partir de uma aplicação Windows Forms, cria uma nova instância da classe PrintDocument, conjunta propriedades, como DefaultPageSettings e PrinterSettings, que descrevem como imprimir, e chama o método Print para imprimir o documento. Chamar o PrintDocument.Print método levanta o PrintDocument.PrintPage evento, que deve ser tratado para executar o layout do documento para impressão.
Use a Graphics propriedade do PrintPageEventArgs objeto obtida do PrintDocument.PrintPage evento para especificar a saída a imprimir. Se estiveres a imprimir um ficheiro de texto, usa StreamReader para ler uma linha de cada vez do stream e chama o DrawString método para desenhar a linha no objeto gráfico. Para mais informações sobre este processo, consulte as Graphics classes e StreamReader . Pode ver um exemplo de impressão de um documento de texto no PrintDocument tópico de visão geral da aula.
Note
Os DrawText métodos da TextRenderer classe não são suportados para impressão. Em vez disso, usa os DrawString métodos da Graphics aula.
Quando implementado numa classe derivada, controla PrintController como a PrintDocument é impressa. O PrintDocument.Print método invoca os métodos , OnStartPrint, , OnEndPrinte OnStartPage do OnEndPagecontrolador de impressão, que por sua vez indicam à impressora como imprimir o documento. Para mais informações sobre a impressão de caixas de diálogo, veja PrintDialog e PageSetupDialog.
O processo de pré-visualização de impressão utiliza um controlador de impressão especializado, uma caixa de diálogo e controlo. Para um exemplo de tal controlador de impressão e caixa de diálogo, veja PreviewPrintController, PrintPreviewDialog, e PrintPreviewControl.
Atenção
As classes dentro do espaço de nomes System.Drawing.Printing não são suportadas para uso dentro de um serviço Windows ou ASP.NET aplicação ou serviço. Tentar usar estas classes dentro de um destes tipos de aplicação pode produzir problemas inesperados, como desempenho de serviço diminuído e exceções em tempo de execução.
Se quiseres imprimir a partir de uma aplicação Windows Presentation Foundation (WPF), vê o espaço de nomes System.Printing.
