System.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 classes que permitem que você automatize o gerenciamento de servidores de impressão, filas de impressão e trabalhos de impressão.
Classes
| LocalPrintServer |
Representa o servidor de impressão local (o computador no qual o aplicativo está em execução) e permite o gerenciamento de suas filas de impressão. |
| PageImageableArea |
Representa a área de uma página que pode ser impressa. |
| PageMediaSize |
Descreve o tamanho da página para papel ou outras mídias. |
| PageResolution |
Define a resolução de página da saída impressa como um valor qualitativo ou pontos por polegada ou ambos. |
| PageScalingFactorRange |
Especifica um intervalo de porcentagens pelo qual uma impressora pode ampliar ou reduzir a imagem de impressão em uma página. |
| PrintCapabilities |
Define as funcionalidades de uma impressora. |
| PrintCommitAttributesException |
A exceção que é gerada quando uma condição de erro impede que os atributos sejam confirmados por um PrintSystemObject no computador, na impressora ou no dispositivo real que o objeto representa. |
| PrintDocumentImageableArea |
Especifica o tamanho do papel (ou de outra mídia), o tamanho da área de imagem permitida e o local da área de imagem permitida. |
| PrintDriver |
Representa um driver de impressão. |
| PrintFilter |
Define o comportamento de descarte comum às classes PrintDriver e PrintProcessor. PrintFilter dá suporte à infraestrutura do WPF (Windows Presentation Foundation) e não se destina a ser usado diretamente do código. |
| PrintingCanceledException |
A exceção que ocorre quando o código tenta acessar um trabalho de impressão cancelado. |
| PrintingNotSupportedException |
A exceção que é lançada quando uma operação de impressão não é compatível. |
| PrintJobException |
A exceção que ocorre quando o trabalho de impressão não é executado corretamente. |
| PrintJobInfoCollection |
Representa um ou mais objetos PrintSystemJobInfo. |
| PrintJobSettings |
Descreve um trabalho de impressão. |
| PrintPort |
Representa uma porta de impressora em um servidor de impressão. Cada fila de impressão tem uma porta de impressa atribuída a ela. |
| PrintProcessor |
Representa um processador de impressão em um servidor de impressão. |
| PrintQueue |
Gerencia impressoras e trabalhos de impressão. |
| PrintQueueCollection |
Representa uma coleção de objetos PrintQueue . |
| PrintQueueException |
A exceção que é lançada quando uma condição de erro impede o acesso ou a criação de uma PrintQueue. |
| PrintQueueStream |
Um fluxo que representa um trabalho de impressão em spool em uma fila de impressão. |
| PrintQueueStringProperty |
Representa uma, e somente uma, das três propriedades possíveis de uma fila de impressão: Location, Comment ou ShareName. |
| PrintServer |
Gerencia as filas de impressão em um servidor de impressão, que normalmente é um computador, mas pode ser um dispositivo de servidor de impressão de hardware dedicado. |
| PrintServerException |
A exceção que ocorre quando uma condição de erro impede o acesso ou a criação de um PrintServer. |
| PrintSystemException |
A exceção que ocorre quando uma condição de erro impede o acesso ou a criação de um PrintSystemObject. |
| PrintSystemJobInfo |
Define um trabalho de impressão em detalhes. |
| PrintSystemObject |
Define as propriedades básicas e os métodos comuns aos objetos do sistema de impressão. As classes que derivam dessa classe representam objetos como filas de impressão, servidores de impressão e trabalhos de impressão. |
| PrintSystemObjectPropertiesChangedEventArgs |
Fornece dados para um evento PropertiesChanged, que você deve criar. |
| PrintSystemObjectPropertyChangedEventArgs |
Fornece dados para um evento PropertyChanged, que você deve criar. |
| PrintSystemObjects |
Representa uma coleção de objetos de sistema de impressão. |
| PrintTicket |
Define as configurações de um trabalho de impressão. |
Estruturas
| ValidationResult |
Representa um PrintTicket mesclado que tem a garantia de ser viável, com um relatório de todas as configurações que foram alteradas para torná-lo viável. |
Enumerações
| Collation |
Especifica se uma impressora agrupa a saída ao imprimir várias cópias de um trabalho de impressão de várias página. |
| ConflictStatus |
Especifica se foram feitas alterações em um PrintTicket mesclado para garantir um PrintTicket viável. |
| DeviceFontSubstitution |
Especifica se a substituição de fontes do dispositivo está habilitada em uma impressora. |
| Duplexing |
Especifica se uma impressora usa a impressão em um lado ou algum tipo de impressão em dois lados (duplex). |
| EnumeratedPrintQueueTypes |
Especifica atributos de filas de impressão. |
| InputBin |
Especifica a bandeja de entrada que é usada como a fonte do papel em branco ou outra mídia de impressão. |
| LocalPrintServerIndexedProperty |
Especifica as propriedades de um objeto LocalPrintServer inicializadas quando ele é construído. |
| OutputColor |
Especifica como imprimir o conteúdo que contém cores ou tons de cinza. |
| OutputQuality |
Especifica os tipos de qualidade de saída para um dispositivo de impressão. |
| PageBorderless |
Especifica se um dispositivo de impressão imprime até a borda da mídia ou fornece uma margem não impressa em torno da borda. |
| PageMediaSizeName |
Especifica o tamanho da página ou a largura do rolo do papel ou outra mídia de impressão. |
| PageMediaType |
Especifica os tipos de papel de impressão ou outras mídias. |
| PageOrder |
Especifica se um dispositivo de impressão imprime documentos de várias páginas de frente para trás ou de trás para a frente. |
| PageOrientation |
Especifica como páginas de conteúdo são orientadas para mídia de impressão. |
| PageQualitativeResolution |
Especifica a resolução de página como um valor não numérico qualitativo. |
| PagesPerSheetDirection |
Especifica a organização das páginas quando mais de uma página de conteúdo é exibida em um único lado da mídia de impressão. |
| PhotoPrintingIntent |
Especifica a qualidade da saída quando uma fotografia é impressa. O driver da impressora converte o PhotoPrintingIntent em valores quantitativos para resolução e outros fatores de qualidade. |
| PrintJobPriority |
Especifica a prioridade não numérica para um trabalho de impressão relacionado aos outros trabalhos de impressão na fila de impressão. |
| PrintJobStatus |
Especifica o status atual de um trabalho de impressão em uma fila de impressão. |
| PrintJobType |
Especifica se o trabalho de impressão usa XPS (XML Paper Specification). |
| PrintQueueAttributes |
Especifica os atributos de uma fila de impressão ou sua impressora. |
| PrintQueueIndexedProperty |
Especifica as propriedades inicializadas quando um objeto PrintQueue é construído. |
| PrintQueueStatus |
Especifica o status de uma fila de impressão ou da impressora. |
| PrintQueueStringPropertyType |
Especifica o significado desejado de um PrintQueueStringProperty. |
| PrintServerEventLoggingTypes |
Especifica os tipos de eventos que podem ser registrados em log por um PrintServer. |
| PrintServerIndexedProperty |
Especifica as propriedades de um objeto PrintServer inicializadas quando ele é construído. |
| PrintSystemDesiredAccess |
Especifica os direitos de acesso diferentes (ou níveis de acesso) para objetos de impressão. |
| PrintSystemObjectLoadMode |
Especifica se as propriedades de um objeto são inicializadas quando o objeto é carregado. |
| PrintTicketScope |
Especifica se um PrintTicket aplica-se a um trabalho de impressão inteiro, a um documento do trabalho de impressão ou a apenas uma página no trabalho de impressão. |
| Stapling |
Especifica se, e quando, uma impressora grampeia um documento de várias páginas. |
| TrueTypeFontMode |
Especifica como uma impressora manipula texto formatado com uma fonte TrueType. |
Comentários
Esse namespace contém as seguintes classes principais:
A PrintSystemObject classe, que é a classe base para as outras classes de impressão de núcleo.
A PrintServer classe, que representa um servidor de impressão real, geralmente um computador.
A PrintQueue classe, que representa uma fila de impressão real e sua impressora.
A PrintSystemJobInfo classe, que representa um trabalho de impressão específico.
A PrintTicket classe, que instrui a impressora a processar um trabalho de impressão.
Classes derivadas da PrintSystemObject classe têm um Commit método e um Refresh . Você deve usar esses métodos para garantir que as instâncias das classes sejam sincronizadas com os componentes de hardware ou software que eles representam.
O System.Printing namespace também inclui muitas enumerações que descrevem os recursos da impressora, como se uma impressora pode produzir saída agrupada e especificar instruções para impressoras, como o tamanho do papel a ser usado para um trabalho de impressão.
Esse namespace faz parte dos serviços de impressão avançados fornecidos com o Windows Presentation Foundation. Os desenvolvedores de código gerenciado usando Windows Forms devem usar as APIs no System.Drawing.Printing namespace.
Cuidado
As classes no System.Printing namespace não têm suporte para uso em um serviço do Windows ou aplicativo ou serviço ASP.net. A tentativa de usar essas classes de dentro de um desses tipos de aplicativos pode gerar problemas inesperados, como desempenho de serviço reduzido e exceções de tempo de execução.