PrintQueue Classe
Definição
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.
Gerir impressoras e trabalhos de impressão.
public ref class PrintQueue : System::Printing::PrintSystemObject
public class PrintQueue : System.Printing.PrintSystemObject
type PrintQueue = class
inherit PrintSystemObject
Public Class PrintQueue
Inherits PrintSystemObject
- Herança
Observações
Algumas propriedades do PrintQueue objeto representam características da utilidade da fila de impressão que corre no computador, mas outras representam características ou estados da própria impressora. Por exemplo, NumberOfJobs é uma característica da fila de impressão, mas Location é uma propriedade da impressora. Muitas das propriedades da impressora, como se necessita de atenção do utilizador, precisam de ser transmitidas, através do Refresh método, da própria impressora para o PrintQueue objeto. Isto deve ser feito antes de a propriedade correspondente (NeedUserIntervention) ser lida pelo seu programa. De forma semelhante, quando o seu programa altera os valores de uma ou mais propriedades de um PrintQueue objeto, a alteração tem de ser escrita na utilidade real da fila de impressão no computador. Faz isto com o Commit método.
Atenção
As classes dentro do espaço de nomes System.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 Forms, vê o espaço de nomes System.Drawing.Printing.
Construtores
| Name | Description |
|---|---|
| PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess) |
Inicializa uma nova instância da PrintQueue classe usando o especificado PrintServer, nome da fila, versão do esquema de impressão e acesso desejado. |
| PrintQueue(PrintServer, String, Int32) |
Inicializa uma nova instância de PrintQueue classe usando a versão especificada PrintServer, nome da fila e esquema de impressão. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess) |
Inicializa uma nova instância da PrintQueue classe com o nome da fila especificado PrintServer, array de PrintQueueIndexedProperty valores a inicializar e acesso desejado. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[]) |
Inicializa uma nova instância da PrintQueue classe usando o especificado PrintServer, nome da fila e array de PrintQueueIndexedProperty valores a inicializar. |
| PrintQueue(PrintServer, String, PrintSystemDesiredAccess) |
Inicializa uma nova instância da PrintQueue classe usando o especificado PrintServer, o nome da fila e o acesso desejado. |
| PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess) |
Inicializa uma nova instância da PrintQueue classe usando o especificado PrintServer, nome da fila, filtro de propriedades e acesso desejado. |
| PrintQueue(PrintServer, String, String[]) |
Inicializa uma nova instância de PrintQueue classe usando o especificado PrintServer, nome da fila e array de nomes de propriedades para inicializar. |
| PrintQueue(PrintServer, String) |
Inicializa uma nova instância da PrintQueue classe usando o nome especificado PrintServer e da fila. |
Propriedades
| Name | Description |
|---|---|
| AveragePagesPerMinute |
Obtém a velocidade da impressora medida em páginas por minuto. |
| ClientPrintSchemaVersion |
Recebe a versão do Esquema de Impressão. |
| Comment |
Recebe ou define um comentário sobre a impressora. |
| CurrentJobSettings |
Recebe um objeto que contém as definições de configuração para o trabalho de impressão atual. |
| DefaultPrintTicket |
Obtém ou define as opções de impressora padrão associadas a isto PrintQueue. |
| DefaultPriority |
Recebe ou define a prioridade padrão atribuída a cada novo trabalho de impressão adicionado à fila. |
| Description |
Recebe uma descrição da fila de impressão. |
| FullName |
Obtém o nome completo da fila. |
| HasPaperProblem |
Recebe um valor que indica se a impressora está a ter um problema de papel não especificado. |
| HasToner |
Recebe um valor que indica se a impressora tem toner. |
| HostingPrintServer |
Obtém ou define (protegido) o servidor de impressão que controla a fila de impressão. |
| InPartialTrust |
Recebe ou define um valor que indica se a fila está a operar num modo parcialmente confiável, um nível de confiança mais elevado. |
| IsBidiEnabled |
Recebe um valor que indica se a comunicação bidirecional com a impressora está ativada. |
| IsBusy |
Recebe um valor que indica se o dispositivo de impressão está ocupado. |
| IsDevQueryEnabled |
Recebe um valor que indica se a fila contém documentos quando as configurações do documento e da impressora não coincidem. |
| IsDirect |
Recebe um valor que indica se a fila imprime diretamente na impressora ou se imprime documentos primeiro e depois imprime-os. |
| IsDisposed |
Recebe ou define um valor que indica se o objeto foi descartado. (Herdado de PrintSystemObject) |
| IsDoorOpened |
Recebe um valor que indica se uma porta está aberta na impressora. |
| IsHidden |
Recebe um valor que indica se a fila de impressão está oculta na interface da sua aplicação. |
| IsInError |
Recebe um valor que indica se a impressora ou o dispositivo estão em condição de erro. |
| IsInitializing |
Recebe um valor que indica se a impressora está a inicializar-se. |
| IsIOActive |
Recebe um valor que indica se a impressora está a receber ou a enviar dados ou sinais. |
| IsManualFeedRequired |
Recebe um valor que indica se a impressora precisa de ser alimentada manualmente com papel para o trabalho de impressão atual. |
| IsNotAvailable |
Recebe um valor que indica se a impressora está disponível. |
| IsOffline |
Recebe um valor que indica se a impressora está offline. |
| IsOutOfMemory |
Recebe um valor que indica se a impressora está sem memória. |
| IsOutOfPaper |
Recebe um valor que indica se a impressora precisa de ser recarregada com papel do tamanho necessário para o trabalho atual. |
| IsOutputBinFull |
Obtém um valor que indica se a área de saída da impressora está em risco de transbordar. |
| IsPaperJammed |
Recebe um valor que indica se a folha de papel atual está presa na impressora. |
| IsPaused |
Recebe um valor que indica se a fila de impressão foi pausada. |
| IsPendingDeletion |
Recebe um valor que indica se a impressora está a eliminar um trabalho de impressão. |
| IsPowerSaveOn |
Recebe um valor que indica se a impressora está em modo de poupança de energia. |
| IsPrinting |
Recebe um valor que indica se um trabalho está a ser impresso. |
| IsProcessing |
Recebe um valor que indica se a impressora está a processar um trabalho de impressão. |
| IsPublished |
Recebe um valor que indica se a impressora é visível para outros utilizadores da rede. |
| IsQueued |
Recebe um valor que indica se a impressora consegue suportar uma fila com mais do que um trabalho de impressão ao mesmo tempo. |
| IsRawOnlyEnabled |
Recebe um valor que indica se a fila de impressão pode usar EMF (Enhanced Meta File) que permite um fluxo de dados mais rápido de uma aplicação de impressão para o spooler do Windows. |
| IsServerUnknown |
Recebe um valor que indica se a impressora está em estado de erro. |
| IsShared |
Recebe um valor que indica se a impressora está disponível para uso por outros computadores na rede. |
| IsTonerLow |
Recebe um valor que indica se a impressora está a ficar sem toner. |
| IsWaiting |
Recebe um valor que indica se a fila está à espera de que um trabalho seja adicionado. |
| IsWarmingUp |
Recebe um valor que indica se a impressora está a aquecer. |
| IsXpsDevice |
Obtém um valor que indica se o driver da impressora está baseado no modelo XPSDrv , pelo que usa a Especificação XML Paper (XPS) como linguagem de descrição de página. |
| KeepPrintedJobs |
Recebe um valor que indica se a fila está a guardar o ficheiro de linguagem da impressora em vez de o apagar após a impressão. |
| Location |
Obtém ou define a localização física da impressora. |
| MaxPrintSchemaVersion |
Obtém o número de versão mais recente possível do Esquema de Impressão que a fila pode usar. |
| Name |
Recebe ou define o nome da fila de impressão. |
| NeedUserIntervention |
Recebe um valor que indica se a impressora precisa da atenção de um ser humano. |
| NumberOfJobs |
Obtém o número total de trabalhos alinhados na fila de impressão. |
| PagePunt |
Recebe um valor que indica se a impressora não consegue imprimir a página atual. |
| Parent |
Fica com o pai do objeto. (Herdado de PrintSystemObject) |
| PrintingIsCancelled |
Recebe ou define um valor que indica se o trabalho de impressão atual está a ser cancelado. |
| Priority |
Obtém ou define a prioridade da fila de impressão em relação a outras filas de impressão que são alojadas pelo mesmo servidor de impressão e que usam a mesma impressora física. |
| PropertiesCollection |
Obtém uma coleção de pares de atributos e valores. (Herdado de PrintSystemObject) |
| QueueAttributes |
Obtém as propriedades da fila de impressão. |
| QueueDriver |
Recebe ou define o driver da impressora para a fila. |
| QueuePort |
Obtém ou define a porta que a fila usa. |
| QueuePrintProcessor |
Obtém ou define o processador de impressão que a fila utiliza. |
| QueueStatus |
Recebe um valor que representa o estado da impressora. Estas incluem "aquecimento", "inicialização", "impressão" e outras. |
| ScheduleCompletedJobsFirst |
Recebe um valor que indica se a impressora imprime trabalhos que concluíram o processo de spooling antes de trabalhos que ainda não foram totalmente desenrolados, mesmo que estes tenham entrado primeiro na fila ou tenham prioridade superior. |
| SeparatorFile |
Obtém ou define o caminho e o nome do ficheiro de um ficheiro que é inserido no início de cada trabalho de impressão. |
| ShareName |
Recebe ou define um nome para a impressora que é visto pelos utilizadores na rede quando é partilhada. |
| StartTimeOfDay |
Obtém ou define a hora mais cedo do dia, expressa como o número de minutos após a meia-noite do Tempo Universal Coordenado (UTC) (também chamado de Hora Média de Greenwich [GMT]), em que a impressora irá imprimir um trabalho. |
| UntilTimeOfDay |
Recebe ou define a hora mais tardia, expressa como o número de minutos após a meia-noite do Tempo Universal Coordenado (UTC) (também chamado de Hora Média de Greenwich [GMT]), que a impressora irá imprimir um trabalho. |
| UserPrintTicket |
Obtém ou define o objeto padrão PrintTicket do utilizador atual, que contém informações detalhadas sobre o trabalho de impressão. |
Métodos
| Name | Description |
|---|---|
| AddJob() |
Insere um novo trabalho de impressão (genericamente nomeado), cujo conteúdo é um Byte array, na fila. |
| AddJob(String, PrintTicket) |
Insere um novo trabalho de impressão para um Documento de Especificação XML em Papel (XPS) na fila e atribui-lhe o nome e as definições especificadas. |
| AddJob(String, String, Boolean, PrintTicket) |
Insere um novo trabalho de impressão para um Documento XML Paper Specification (XPS) na fila, atribui-lhe o nome e as definições especificados, e especifica se deve ou não ser validado. |
| AddJob(String, String, Boolean) |
Insere um novo trabalho de impressão para um Documento de Especificação XML em Papel (XPS) na fila, atribui-lhe o nome especificado e especifica se deve ou não ser validado. |
| AddJob(String) |
Insere um novo trabalho de impressão, cujo conteúdo é um Byte array, na fila. |
| Commit() |
Escreve as propriedades atuais do PrintQueue objeto na fila de impressão real no servidor de impressão. |
| CreateXpsDocumentWriter(Double, Double) |
Cria um XpsDocumentWriter objeto com as dimensões especificadas. |
| CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Cria um objeto XpsDocumentWriter, abre um diálogo de impressão Windows comum, fornece ao diálogo um intervalo de páginas e uma descrição do trabalho de impressão, e retorna um parâmetro |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
Cria um objeto XpsDocumentWriter, abre um diálogo Windows impressão comum e devolve um parâmetro |
| CreateXpsDocumentWriter(PrintQueue) |
Cria um XpsDocumentWriter objeto e associa-o à fila de impressão especificada. |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Cria um objeto XpsDocumentWriter, abre um diálogo de impressão Windows comum, fornece ao diálogo um intervalo de páginas e devolve um parâmetro |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea) |
Cria um objeto XpsDocumentWriter, abre uma Windows caixa de diálogo comum de impressão (e fornece-lhe uma descrição do trabalho) e devolve um parâmetro |
| Dispose() |
Liberta todos os recursos utilizados pelo PrintSystemObject. (Herdado de PrintSystemObject) |
| Dispose(Boolean) |
Liberta os recursos não geridos usados pelo PrintSystemObject e opcionalmente liberta os recursos geridos. (Herdado de PrintSystemObject) |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetJob(Int32) |
Recebe o trabalho de impressão com o número de identificação especificado. |
| GetPrintCapabilities() |
Obtém um PrintCapabilities objeto que identifica as capacidades da impressora. |
| GetPrintCapabilities(PrintTicket) |
Obtém um PrintCapabilities objeto que identifica as capacidades da impressora. |
| GetPrintCapabilitiesAsXml() |
Obtém um MemoryStream objeto que especifica as capacidades da impressora como um fluxo XML que cumpre o Esquema de Impressão. |
| GetPrintCapabilitiesAsXml(PrintTicket) |
Obtém um MemoryStream objeto que especifica as capacidades da impressora num formato XML que cumpre o Esquema de Impressão. |
| GetPrintJobInfoCollection() |
Cria uma coleção que contém um PrintSystemJobInfo objeto para cada trabalho na fila. |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| Initialize() |
Inicializa as propriedades do PrintSystemObject. (Herdado de PrintSystemObject) |
| InternalDispose(Boolean) |
Liberta os recursos não geridos usados pelo PrintQueue e opcionalmente liberta os recursos geridos. |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope) |
Funde dois PrintTickets e garante que o resultado PrintTicket é válido, não pede qualquer funcionalidade de impressão que a impressora não suporte, e está limitada ao âmbito especificado. |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket) |
Funde dois PrintTickets e garante que o resultado PrintTicket é válido e não pede qualquer funcionalidade de impressão que a impressora não suporte. |
| Pause() |
Pausa a fila de impressão. Permanece pausado até Resume() ser executado. |
| Purge() |
Remove todos os trabalhos na fila de impressão. |
| Refresh() |
Atualiza as propriedades do PrintQueue objeto com valores da impressora e da utilidade de fila de impressão que corre no computador. |
| Resume() |
Reinicia uma fila de impressão que estava pausada. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |