PrintQueue Classe

Definição

Gerencia impressoras e trabalhos de impressão.Manages printers and print jobs.

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 objeto PrintQueue representam características do utilitário fila de impressão executado no computador, mas outras representam recursos ou Estados da própria impressora.Some properties of the PrintQueue object represent characteristics of the print queue utility that runs on the computer, but others represent features or states of the printer itself. Por exemplo, NumberOfJobs é uma característica da fila de impressão, mas Location é uma propriedade da impressora.For example, NumberOfJobs is a characteristic of the print queue, but Location is a property of the printer. Muitas das propriedades da impressora, como, por exemplo, se precisam de atenção do usuário, precisam ser passadas, por meio do método Refresh, da própria impressora ao objeto PrintQueue.Many of the properties of the printer, such as whether it needs user attention, need to be passed, by means of the Refresh method, from the printer itself to the PrintQueue object. Isso deve ser feito antes que a propriedade correspondente (NeedUserIntervention) seja lida pelo seu programa.This should be done before the corresponding property (NeedUserIntervention) is read by your program. Da mesma forma, quando o programa altera os valores de uma ou mais propriedades de um objeto PrintQueue, a alteração deve ser gravada no utilitário real da fila de impressão no computador.Similarly, when your program changes the values of one or more properties of a PrintQueue object, the change must be written to the actual print queue utility on the computer. Faça isso com o método Commit.Do this with the Commit method.

Cuidado

Não há suporte para classes dentro do namespace System.Printing para uso em um serviço do Windows ou aplicativo ou serviço ASP.NET.Classes within the System.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. 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.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Se você quiser imprimir a partir de um aplicativo Windows Forms, consulte o namespace System.Drawing.Printing.If you want to print from a Windows Forms application, see the System.Drawing.Printing namespace.

Construtores

PrintQueue(PrintServer, String)

Inicializa uma nova instância da classe PrintQueue usando o PrintServer e nome na fila especificados.Initializes a new instance of PrintQueue class using the specified PrintServer and queue name.

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.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and print schema version.

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.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, print schema version, and desired access.

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.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and array of PrintQueueIndexedProperty values to initialize.

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.Initializes a new instance of PrintQueue class with the specified PrintServer, queue name, array of PrintQueueIndexedProperty values to initialize, and desired access.

PrintQueue(PrintServer, String, PrintSystemDesiredAccess)

Inicializa uma nova instância da classe PrintQueue usando o PrintServer, o nome da fila e o acesso desejado especificados.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and desired access.

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.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, and array of property names to initialize.

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.Initializes a new instance of PrintQueue class using the specified PrintServer, queue name, property filter, and desired access.

Propriedades

AveragePagesPerMinute

Obtém a velocidade da impressora medida em páginas por minuto.Gets the speed of the printer measured in pages per minute.

ClientPrintSchemaVersion

Obtém a versão do Esquema de Impressão.Gets the version of the Print Schema.

Comment

Obtém ou define um comentário sobre a impressora.Gets or sets a comment about the printer.

CurrentJobSettings

Obtém um objeto que contém as definições de configuração para o trabalho de impressão atual.Gets an object that contains the configuration settings for the current print job.

DefaultPrintTicket

Obtém ou define as opções de impressora padrão associadas a essa PrintQueue.Gets or sets the default printer options associated with this PrintQueue.

DefaultPriority

Obtém ou define a prioridade padrão que é fornecida a cada novo trabalho de impressão adicionado à fila.Gets or sets the default priority that is given to each new print job added to the queue.

Description

Obtém uma descrição da fila de impressão.Gets a description of the print queue.

FullName

Obtém o nome completo da fila.Gets the complete name of the queue.

HasPaperProblem

Obtém um valor que indica se a impressora está tendo um problema de papel não especificado.Gets a value that indicates if the printer is having an unspecified paper problem.

HasToner

Obtém um valor que indica se a impressora tem toner.Gets a value that indicates if the printer has toner.

HostingPrintServer

Obtém ou define (protegido) o servidor de impressão que controla a fila de impressão.Gets or sets (protected) the print server that controls the print queue.

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.Gets or sets a value that indicates whether the queue is operating in a partially trusted mode, a higher level of trust.

IsBidiEnabled

Obtém um valor que indica se a comunicação bidirecional com a impressora está habilitada.Gets a value that indicates whether bidirectional communication with the printer is enabled.

IsBusy

Obtém um valor que indica se o dispositivo de impressão está ocupado.Gets a value that indicates whether the printing device is busy.

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.Gets a value that indicates whether the queue holds documents when document and printer configurations do not match.

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.Gets a value that indicates whether the queue prints directly to the printer or spools documents first and then prints them.

IsDisposed

Obtém ou define um valor que indica se o objeto foi descartado.Gets or sets a value that indicates whether the object has been disposed.

(Herdado de PrintSystemObject)
IsDoorOpened

Obtém um valor que indica se uma porta está aberta na impressora.Gets a value that indicates whether a door is open on the printer.

IsHidden

Obtém um valor que indica se a fila de impressão está oculta na interface do usuário do seu aplicativo.Gets a value that indicates whether the print queue is hidden in your application's user interface.

IsInError

Obtém um valor que indica se a impressora ou o dispositivo está em uma condição de erro.Gets a value that indicates whether the printer or device is in an error condition.

IsInitializing

Obtém um valor que indica se a impressora está se inicializando.Gets a value that indicates whether the printer is initializing itself.

IsIOActive

Obtém um valor que indica se a impressora está recebendo ou enviando dados ou sinais.Gets a value that indicates whether the printer is receiving or sending data or signals.

IsManualFeedRequired

Obtém um valor que indica se a impressora precisa ter o papel alimentado manualmente para o trabalho de impressão atual.Gets a value that indicates whether the printer needs to be manually fed paper for the current print job.

IsNotAvailable

Obtém um valor que indica se a impressora está disponível.Gets a value that indicates whether the printer is available.

IsOffline

Obtém um valor que indica se a impressora está offline.Gets a value that indicates whether the printer is offline.

IsOutOfMemory

Obtém um valor que indica se a impressora está sem memória.Gets a value that indicates whether the printer is out of memory.

IsOutOfPaper

Obtém um valor que indica se a impressora precisa ser recarregada com papel do tamanho necessário para o trabalho atual.Gets a value that indicates whether the printer needs to be reloaded with paper of the size required for the current job.

IsOutputBinFull

Obtém um valor que indica se a área de saída da impressora está em risco de transbordamento.Gets a value that indicates whether the output area of the printer is in danger of overflowing.

IsPaperJammed

Obtém um valor que indica se a folha de papel atual está presa na impressora.Gets a value that indicates whether the current sheet of paper is stuck in the printer.

IsPaused

Obtém um valor que indica se a fila de impressão está em pausa.Gets a value that indicates whether the print queue has been paused.

IsPendingDeletion

Obtém um valor que indica se a impressora está no processo de exclusão de um trabalho de impressão.Gets a value that indicates whether the printer is in the process of deleting a print job.

IsPowerSaveOn

Obtém um valor que indica se a impressora está no modo de economia de energia.Gets a value that indicates whether the printer is in power save mode.

IsPrinting

Obtém um valor que indica se um trabalho está sendo impresso.Gets a value that indicates whether a job is printing.

IsProcessing

Obtém um valor que indica se a impressora está processando um trabalho de impressão.Gets a value that indicates whether the printer is processing a print job.

IsPublished

Obtém um valor que indica se a impressora está visível para outros usuários da rede.Gets a value that indicates whether the printer is visible to other network users.

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.Gets a value that indicates whether the printer can support a queue with more than one print job in it at a time.

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.Gets a value that indicates whether the print queue can use EMF (Enhanced Meta File) that enables faster data flow from a printing application to the Windows spooler.

IsServerUnknown

Obtém um valor que indica se a impressora está em um estado de erro.Gets a value that indicates whether the printer is in an error state.

IsShared

Obtém um valor que indica se a impressora está disponível para uso por outros computadores na rede.Gets a value that indicates whether the printer is available for use by other computers on the network.

IsTonerLow

Obtém um valor que indica se a impressora está com o toner acabando.Gets a value that indicates whether the printer is running short of toner.

IsWaiting

Obtém um valor que indica se a fila está aguardando um trabalho ser adicionado.Gets a value that indicates whether the queue is waiting for a job to be added.

IsWarmingUp

Obtém um valor que indica se a impressora está aquecendo.Gets a value that indicates whether the printer is warming up.

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.Gets a value that indicates whether the printer's driver is built on the XPSDrv model so it uses XML Paper Specification (XPS) as its page description language.

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.Gets a value that indicates whether the queue is saving the printer language file instead of deleting it following printing.

Location

Obtém ou define o local físico da impressora.Gets or sets the printer's physical location.

MaxPrintSchemaVersion

Obtém o número de versão mais recente possível do Esquema de Impressão que a fila pode usar.Gets the most recent possible version number of the Print Schema that the queue can use.

Name

Obtém ou define o nome da fila de impressão.Gets or sets the print queue's name.

NeedUserIntervention

Obtém um valor que indica se a impressora precisa de atenção de uma pessoa.Gets a value that indicates whether the printer needs the attention of a human being.

NumberOfJobs

Obtém o número total de trabalhos alinhados na fila de impressão.Gets the total number of jobs lined up in the print queue.

PagePunt

Obtém um valor que indica se a impressora não é capaz de imprimir a página atual.Gets a value that indicates whether the printer is unable to print the current page.

Parent

Obtém o pai do objeto.Gets the parent of the object.

(Herdado de PrintSystemObject)
PrintingIsCancelled

Obtém ou define um valor que indica se o trabalho de impressão atual está sendo cancelado.Gets or sets a value that indicates whether the current print job is being cancelled.

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.Gets or sets the priority of the print queue relative to other print queues that are hosted by the same print server and that use the same physical printer.

PropertiesCollection

Obtém uma coleção de pares de atributo e valor.Gets a collection of attribute and value pairs.

(Herdado de PrintSystemObject)
QueueAttributes

Obtém as propriedades da fila de impressão.Gets the properties of the print queue.

QueueDriver

Obtém ou define o driver de impressora para a fila.Gets or sets the printer driver for the queue.

QueuePort

Obtém ou define a porta que a fila usa.Gets or sets the port that the queue uses.

QueuePrintProcessor

Obtém ou define o processador de impressão que a fila usa.Gets or sets the print processor that the queue uses.

QueueStatus

Obtém um valor que representa o status da impressora.Gets a value that represents the status of the printer. Esses incluem "aquecendo," "inicializando", "imprimindo" e outros.These include "warming up," "initializing," "printing," and others.

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.Gets a value that indicates whether the printer prints jobs that have completed the spooling process before jobs that have not fully spooled even if the latter entered the queue first or have a higher priority.

SeparatorFile

Obtém ou define o caminho e o nome de arquivo que é inserido no início de cada trabalho de impressão.Gets or sets the path and file name of a file that is inserted at the beginning of each print job.

ShareName

Obtém ou define um nome para a impressora que é visto pelos usuários da rede quando ele é compartilhado.Gets or sets a name for the printer that is seen by users on the network when it is shared.

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.Gets or sets the earliest time of day, expressed as the number of minutes after midnight Coordinated Universal Time (UTC) (also called Greenwich Mean Time [GMT]), that the printer will print a job.

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.Gets or sets the latest time, expressed as the number of minutes after midnight Coordinated Universal Time (UTC) (also called Greenwich Mean Time [GMT]), that the printer will print a job.

UserPrintTicket

Obtém ou define o objeto padrão PrintTicket atual do usuário que contém informações detalhadas sobre o trabalho de impressão.Gets or sets the current user's default PrintTicket object which contains detailed information about the print job.

Métodos

AddJob()

Insere um novo trabalho de impressão (nomeado genericamente), cujo conteúdo é uma matriz Byte, na fila.Inserts a new (generically named) print job, whose content is a Byte array, into the queue.

AddJob(String)

Insere um novo trabalho de impressão, cujo conteúdo é uma matriz Byte, na fila.Inserts a new print job, whose content is a Byte array, into the queue.

AddJob(String, PrintTicket)

Insere na fila um novo trabalho de impressão para um documento XPS (XML Paper Specification)XML Paper Specification (XPS) e concede a ele o nome e as configurações especificadas.Inserts a new print job for an XPS (XML Paper Specification)XML Paper Specification (XPS) Document into the queue, and gives it the specified name and settings.

AddJob(String, String, Boolean)

Insere um novo trabalho de impressão para um documento XPS (XML Paper Specification)XML Paper Specification (XPS) na fila, fornece o nome especificado a ele e especifica se ele deve ser validado ou não.Inserts a new print job for an XPS (XML Paper Specification)XML Paper Specification (XPS) Document into the queue, gives it the specified name, and specifies whether or not it should be validated.

AddJob(String, String, Boolean, PrintTicket)

Insere um novo trabalho de impressão para um Documento XPS (XML Paper Specification)XML Paper Specification (XPS) na fila, fornece a ele o nome e as configurações especificadas e especifica se ele deve ser validado ou não.Inserts a new print job for an XPS (XML Paper Specification)XML Paper Specification (XPS) Document into the queue, gives it the specified name and settings, and specifies whether or not it should be validated.

Commit()

Grava as propriedades atuais do objeto PrintQueue na fila de impressão real no servidor de impressão.Writes the current properties of the PrintQueue object to the actual print queue on the print server.

CreateXpsDocumentWriter(Double, Double)

Cria um objeto XpsDocumentWriter com as dimensões especificadas.Creates an XpsDocumentWriter object with the specified dimensions.

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.Creates an XpsDocumentWriter object, opens a Windows common print dialog and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

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.Creates an XpsDocumentWriter object, opens a Windows common print dialog, provides the dialog with a page range and a description of the print job, and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

CreateXpsDocumentWriter(PrintQueue)

Cria um objeto XpsDocumentWriter e o associa com a fila de impressão especificada.Creates an XpsDocumentWriter object and associates it with the specified print queue.

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.Creates an XpsDocumentWriter object, opens a Windows common print dialog (and provides it a job description) and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

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.Creates an XpsDocumentWriter object, opens a Windows common print dialog, provides the dialog with a page range, and returns a ref (ByRef in Visual Basic) parameter that represents information about the imageable area and the dimensions of the media.

Dispose()

Libera todos os recursos usados pelo PrintSystemObject.Releases all resources used by the PrintSystemObject.

(Herdado de PrintSystemObject)
Dispose(Boolean)

Libera os recursos não gerenciados usados pelo PrintSystemObject e opcionalmente libera os recursos gerenciados.Releases the unmanaged resources used by the PrintSystemObject and optionally releases the managed resources.

(Herdado de PrintSystemObject)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetJob(Int32)

Obtém o trabalho de impressão com o número de ID especificado.Gets the print job with the specified ID number.

GetPrintCapabilities()

Obtém um objeto PrintCapabilities que identifica os recursos da impressora.Gets a PrintCapabilities object that identifies the capabilities of the printer.

GetPrintCapabilities(PrintTicket)

Obtém um objeto PrintCapabilities que identifica os recursos da impressora.Gets a PrintCapabilities object that identifies the capabilities of the printer.

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.Gets a MemoryStream object that specifies the printer's capabilities as an XML stream that complies with the Print Schema.

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.Gets a MemoryStream object that specifies the printer's capabilities in an XML format that complies with the Print Schema.

GetPrintJobInfoCollection()

Cria uma coleção que contém um objeto PrintSystemJobInfo para cada trabalho na fila.Creates a collection that contains a PrintSystemJobInfo object for each job in the queue.

GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
Initialize()

Inicializa as propriedades do PrintSystemObject.Initializes the properties of the PrintSystemObject.

(Herdado de PrintSystemObject)
InternalDispose(Boolean)

Libera os recursos não gerenciados usados pelo PrintQueue e, opcionalmente, libera os recursos gerenciados.Releases the unmanaged resources used by the PrintQueue and optionally releases the managed resources.

MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(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.Merges two PrintTickets and guarantees that the resulting PrintTicket is valid and does not ask for any printing functionality that the printer does not support.

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.Merges two PrintTickets and guarantees that the resulting PrintTicket is valid, does not ask for any printing functionality that the printer does not support, and is limited to the specified scope.

Pause()

Pausa a fila de impressão.Pauses the print queue. Permanece em pausa até a execução de Resume().It remains paused until Resume() is executed.

Purge()

Remove todos os trabalhos na fila de impressão.Removes all the jobs in the print queue.

Refresh()

Atualiza as propriedades do objeto PrintQueue com valores da impressora e do utilitário de fila de impressão executado no computador.Updates the properties of the PrintQueue object with values from the printer and the print queue utility that runs on the computer.

Resume()

Reinicia uma fila de impressão que estava em pausa.Restarts a print queue that was paused.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também