PrintQueue Classe

Definição

Gerencia 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

Comentários

Algumas propriedades do PrintQueue objeto representam características do utilitário de fila de impressão que é executado no computador, mas outras representam recursos 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 ela precisa de atenção do usuário, precisam ser passadas, por meio do Refresh método , da própria impressora para o PrintQueue objeto . Isso deve ser feito antes que a propriedade correspondente (NeedUserIntervention) seja lida pelo programa. Da mesma forma, quando o programa altera os valores de uma ou mais propriedades de um PrintQueue objeto, a alteração deve ser gravada no utilitário de fila de impressão real no computador. Faça isso com o Commit método .

Cuidado

Não há suporte para classes no System.Printing namespace para uso em um serviço windows ou ASP.NET aplicativo ou serviço. Tentar usar essas classes de dentro de um desses tipos de aplicativo pode produzir problemas inesperados, como diminuição do desempenho do serviço e exceções em tempo de execução.

Se você quiser imprimir de um aplicativo Windows Forms, consulte o System.Drawing.Printing namespace .

Construtores

PrintQueue(PrintServer, String)

Inicializa uma nova instância da classe PrintQueue usando o PrintServer e nome na fila especificados.

PrintQueue(PrintServer, String, Int32)

Inicializa uma nova instância da classe PrintQueue usando o PrintServer, o nome da fila e a versão do esquema de impressão especificados.

PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)

Inicializa uma nova instância da classe PrintQueue usando o PrintServer, o nome da fila, a versão do esquema de impressão e o acesso desejado especificados.

PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])

Inicializa uma nova instância da classe PrintQueue usando o PrintServer, o nome da fila e a matriz de valores PrintQueueIndexedProperty a serem inicializados especificados.

PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)

Inicializa uma nova instância da classe PrintQueue com o PrintServer, o nome da fila, a matriz de valores PrintQueueIndexedProperty a serem inicializados e o acesso desejado especificados.

PrintQueue(PrintServer, String, PrintSystemDesiredAccess)

Inicializa uma nova instância da classe PrintQueue usando o PrintServer, o nome da fila e o acesso desejado especificados.

PrintQueue(PrintServer, String, String[])

Inicializa uma nova instância da classe PrintQueue usando o PrintServer, o nome da fila e a matriz de nomes de propriedade a serem inicializados especificados.

PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)

Inicializa uma nova instância da classe PrintQueue usando o PrintServer, o nome da fila, o filtro de propriedade e o acesso desejado especificados.

Propriedades

AveragePagesPerMinute

Obtém a velocidade da impressora medida em páginas por minuto.

ClientPrintSchemaVersion

Obtém a versão do Esquema de Impressão.

Comment

Obtém ou define um comentário sobre a impressora.

CurrentJobSettings

Obtém 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 essa PrintQueue.

DefaultPriority

Obtém ou define a prioridade padrão que é fornecida a cada novo trabalho de impressão adicionado à fila.

Description

Obtém uma descrição da fila de impressão.

FullName

Obtém o nome completo da fila.

HasPaperProblem

Obtém um valor que indica se a impressora está tendo um problema de papel não especificado.

HasToner

Obtém 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

Obtém ou define um valor que indica se a fila está operando em um modo parcialmente confiável, ou seja, um nível mais alto de confiança.

IsBidiEnabled

Obtém um valor que indica se a comunicação bidirecional com a impressora está habilitada.

IsBusy

Obtém um valor que indica se o dispositivo de impressão está ocupado.

IsDevQueryEnabled

Obtém um valor que indica se a fila mantém os documentos quando as configurações do documento e da impressora não correspondem.

IsDirect

Obtém um valor que indica se a fila imprime diretamente na impressora ou coloca primeiro os documentos em spools e, em seguida, os imprime.

IsDisposed

Obtém ou define um valor que indica se o objeto foi descartado.

(Herdado de PrintSystemObject)
IsDoorOpened

Obtém um valor que indica se uma porta está aberta na impressora.

IsHidden

Obtém um valor que indica se a fila de impressão está oculta na interface do usuário do seu aplicativo.

IsInError

Obtém um valor que indica se a impressora ou o dispositivo está em uma condição de erro.

IsInitializing

Obtém um valor que indica se a impressora está se inicializando.

IsIOActive

Obtém um valor que indica se a impressora está recebendo ou enviando dados ou sinais.

IsManualFeedRequired

Obtém um valor que indica se a impressora precisa ter o papel alimentado manualmente para o trabalho de impressão atual.

IsNotAvailable

Obtém um valor que indica se a impressora está disponível.

IsOffline

Obtém um valor que indica se a impressora está offline.

IsOutOfMemory

Obtém um valor que indica se a impressora está sem memória.

IsOutOfPaper

Obtém um valor que indica se a impressora precisa 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 transbordamento.

IsPaperJammed

Obtém um valor que indica se a folha de papel atual está presa na impressora.

IsPaused

Obtém um valor que indica se a fila de impressão está em pausa.

IsPendingDeletion

Obtém um valor que indica se a impressora está no processo de exclusão de um trabalho de impressão.

IsPowerSaveOn

Obtém um valor que indica se a impressora está no modo de economia de energia.

IsPrinting

Obtém um valor que indica se um trabalho está sendo impresso.

IsProcessing

Obtém um valor que indica se a impressora está processando um trabalho de impressão.

IsPublished

Obtém um valor que indica se a impressora está visível para outros usuários da rede.

IsQueued

Obtém um valor que indica se a impressora é compatível com uma fila com mais de um trabalho de impressão por vez.

IsRawOnlyEnabled

Obtém 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 um aplicativo de impressão para o spooler do Windows.

IsServerUnknown

Obtém um valor que indica se a impressora está em um estado de erro.

IsShared

Obtém um valor que indica se a impressora está disponível para uso por outros computadores na rede.

IsTonerLow

Obtém um valor que indica se a impressora está com o toner acabando.

IsWaiting

Obtém um valor que indica se a fila está aguardando um trabalho ser adicionado.

IsWarmingUp

Obtém um valor que indica se a impressora está aquecendo.

IsXpsDevice

Obtém um valor que indica se o driver da impressora é baseado no modelo XPSDrv, de modo que ele use XPS (XML Paper Specification) como sua linguagem de descrição de página.

KeepPrintedJobs

Obtém um valor que indica se a fila está salvando o arquivo de linguagem da impressora em vez de excluí-lo após a impressão.

Location

Obtém ou define o local físico 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

Obtém ou define o nome da fila de impressão.

NeedUserIntervention

Obtém um valor que indica se a impressora precisa de atenção de uma pessoa.

NumberOfJobs

Obtém o número total de trabalhos alinhados na fila de impressão.

PagePunt

Obtém um valor que indica se a impressora não é capaz de imprimir a página atual.

Parent

Obtém o pai do objeto.

(Herdado de PrintSystemObject)
PrintingIsCancelled

Obtém ou define um valor que indica se o trabalho de impressão atual está sendo 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 hospedadas pelo mesmo servidor de impressão e que usam a mesma impressora física.

PropertiesCollection

Obtém uma coleção de pares de atributo e valor.

(Herdado de PrintSystemObject)
QueueAttributes

Obtém as propriedades da fila de impressão.

QueueDriver

Obtém ou define o driver de 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 usa.

QueueStatus

Obtém um valor que representa o status da impressora. Esses incluem "aquecendo," "inicializando", "imprimindo" e outros.

ScheduleCompletedJobsFirst

Obtém um valor que indica se a impressora imprime trabalhos que concluíram o processo de spooling antes de trabalhos que não foram totalmente colocados em spool, mesmo que o último tenha entrado na fila primeiro ou tem uma prioridade mais alta.

SeparatorFile

Obtém ou define o caminho e o nome de arquivo que é inserido no início de cada trabalho de impressão.

ShareName

Obtém ou define um nome para a impressora que é visto pelos usuários da rede quando ele é compartilhado.

StartTimeOfDay

Obtém ou define a primeira hora do dia, expressa como o número de minutos após a meia-noite, de acordo com o UTC (Tempo Universal Coordenado), também chamado de GMT (Horário do Meridiano de Greenwich), em que a impressora imprimirá um trabalho.

UntilTimeOfDay

Obtém ou define a última hora, expressa como o número de minutos após a meia-noite, de acordo com o UTC (Tempo Universal Coordenado), também chamado de GMT (Horário do Meridiano de Greenwich), em que a impressora imprimirá um trabalho.

UserPrintTicket

Obtém ou define o objeto padrão PrintTicket do usuário atual, que contém informações detalhadas sobre o trabalho de impressão.

Métodos

AddJob()

Insere um novo trabalho de impressão (nomeado genericamente), cujo conteúdo é uma matriz Byte, na fila.

AddJob(String)

Insere um novo trabalho de impressão, cujo conteúdo é uma matriz Byte, na fila.

AddJob(String, PrintTicket)

Insere um novo trabalho de impressão para um documento XPS (Especificação de Papel XML) na fila e fornece o nome e as configurações especificados.

AddJob(String, String, Boolean)

Insere um novo trabalho de impressão para um documento XPS (Especificação de Papel XML) na fila, fornece o nome especificado e especifica se ele deve ou não ser validado.

AddJob(String, String, Boolean, PrintTicket)

Insere um novo trabalho de impressão para um documento XPS (Especificação de Papel XML) na fila, fornece o nome e as configurações especificados e especifica se ele deve ou não ser validado.

Commit()

Grava as propriedades atuais do objeto PrintQueue na fila de impressão real no servidor de impressão.

CreateXpsDocumentWriter(Double, Double)

Cria um objeto XpsDocumentWriter com as dimensões especificadas.

CreateXpsDocumentWriter(PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página e uma descrição do trabalho de impressão à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

CreateXpsDocumentWriter(PrintQueue)

Cria um objeto XpsDocumentWriter e o associa com a fila de impressão especificada.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Cria um objeto XpsDocumentWriter, abre uma caixa de diálogo de impressão comum do Windows (e fornece a ela uma descrição do trabalho) e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Cria um objeto XpsDocumentWriter, abre uma caixa diálogo de impressão comum do Windows, fornece um intervalo de página à caixa de diálogo e retorna um parâmetro ref (ByRef no Visual Basic) que representa informações sobre a área de imagem permitida e as dimensões da mídia.

Dispose()

Libera todos os recursos usados pelo PrintSystemObject.

(Herdado de PrintSystemObject)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo PrintSystemObject e opcionalmente libera os recursos gerenciados.

(Herdado de PrintSystemObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetJob(Int32)

Obtém o trabalho de impressão com o número de ID especificado.

GetPrintCapabilities()

Obtém um objeto PrintCapabilities que identifica os recursos da impressora.

GetPrintCapabilities(PrintTicket)

Obtém um objeto PrintCapabilities que identifica os recursos da impressora.

GetPrintCapabilitiesAsXml()

Obtém um objeto MemoryStream que especifica os recursos da impressora como um fluxo XML que esteja em conformidade com o Esquema de Impressão.

GetPrintCapabilitiesAsXml(PrintTicket)

Obtém um objeto MemoryStream que especifica os recursos da impressora em um formato XML que esteja em conformidade com o Esquema de Impressão.

GetPrintJobInfoCollection()

Cria uma coleção que contém um objeto PrintSystemJobInfo 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)

Libera os recursos não gerenciados usados pelo PrintQueue e opcionalmente libera os recursos gerenciados.

MemberwiseClone()

Cria uma cópia superficial do Object atual.

(Herdado de Object)
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)

Mescla dois PrintTickets e garante que o PrintTicket resultante seja válido e não solicita qualquer funcionalidade de impressão à qual impressora não dá suporte.

MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)

Mescla dois PrintTickets e garante que o PrintTicket resultante seja válido, não solicita qualquer funcionalidade de impressão que não seja compatível com a impressora e é limitada ao escopo especificado.

Pause()

Pausa a fila de impressão. Permanece em pausa até a execução de Resume().

Purge()

Remove todos os trabalhos na fila de impressão.

Refresh()

Atualiza as propriedades do objeto PrintQueue com valores da impressora e do utilitário de fila de impressão executado no computador.

Resume()

Reinicia uma fila de impressão que estava em pausa.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Confira também