PrintQueue Classe

Definição

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 ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre um diálogo Windows impressão comum e devolve um parâmetro ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

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 ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

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 ref (ByRef em Visual Basic) que representa informação sobre a área visualizável e as dimensões do suporte.

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)

Aplica-se a

Ver também