PrintQueue Clase

Definición

Espacio de nombres:

System.Printing

Ensamblado:

System.Printing.dll

Administra impresoras y trabajos de impresión.

public ref class PrintQueue : System::Printing::PrintSystemObject

public class PrintQueue : System.Printing.PrintSystemObject

type PrintQueue = class
    inherit PrintSystemObject

Public Class PrintQueue
Inherits PrintSystemObject

Herencia

Object

PrintSystemObject

PrintQueue

Comentarios

Algunas propiedades del PrintQueue objeto representan características de la utilidad de cola de impresión que se ejecuta en el equipo, pero otras representan características o estados de la propia impresora. Por ejemplo, NumberOfJobs es una característica de la cola de impresión, pero Location es una propiedad de la impresora. Muchas de las propiedades de la impresora, como si necesita atención del usuario, deben pasarse, mediante el método , desde la Refresh propia impresora al PrintQueue objeto . Esto debe hacerse antes de que el programa lea la propiedad correspondiente (NeedUserIntervention). Del mismo modo, cuando el programa cambia los valores de una o varias propiedades de un PrintQueue objeto, el cambio debe escribirse en la utilidad de cola de impresión real del equipo. Haga esto con el Commit método .

Precaución

Las clases dentro del System.Printing espacio de nombres no se admiten para su uso en un servicio de Windows o en una aplicación o servicio de ASP.NET. Intentar usar estas clases desde uno de estos tipos de aplicación puede producir problemas inesperados, como reducir el rendimiento del servicio y las excepciones en tiempo de ejecución.

Si desea imprimir desde una aplicación de Windows Forms, consulte el System.Drawing.Printing espacio de nombres .

Constructores

PrintQueue(PrintServer, String)	Inicializa una nueva instancia de la clase PrintQueue usando el objeto PrintServer y el nombre de cola especificados.
PrintQueue(PrintServer, String, Int32)	Inicializa una nueva instancia de la clase PrintQueue usando el objeto PrintServer, el nombre de la cola y la versión del esquema de impresión especificados.
PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintQueue usando el objeto PrintServer, el nombre de la cola, la versión del esquema de impresión y el acceso deseado especificados.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[])	Inicializa una nueva instancia de la clase PrintQueue usando el PrintServer, el nombre de cola y la matriz de valores PrintQueueIndexedProperty que se van a inicializar.
PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintQueue con el objeto PrintServer, el nombre de la cola, la matriz de valores PrintQueueIndexedProperty que se van a inicializar y el acceso deseado.
PrintQueue(PrintServer, String, PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintQueue usando el objeto PrintServer, el nombre de la cola y el acceso deseado especificados.
PrintQueue(PrintServer, String, String[])	Inicializa una nueva instancia de la clase PrintQueue usando el objeto PrintServer, el nombre de la cola y la matriz de los nombres de las propiedades que se van a inicializar.
PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess)	Inicializa una nueva instancia de la clase PrintQueue usando el objeto PrintServer, el nombre de la cola, el filtro de propiedad y el acceso deseado especificados.

Propiedades

AveragePagesPerMinute	Obtiene la velocidad de la impresora medida en páginas por minuto.
ClientPrintSchemaVersion	Obtiene la versión del Esquema de impresión.
Comment	Obtiene o establece un comentario sobre la impresora.
CurrentJobSettings	Obtiene un objeto que contiene la configuración del trabajo de impresión actual.
DefaultPrintTicket	Obtiene o establece las opciones de impresora predeterminadas asociadas a PrintQueue.
DefaultPriority	Obtiene o establece la prioridad predeterminada que se asigna a cada nuevo trabajo de impresión agregado a la cola.
Description	Obtiene una descripción de la cola de impresión.
FullName	Obtiene el nombre completo de la cola.
HasPaperProblem	Obtiene un valor que indica si la impresora tiene un problema con el papel no especificado.
HasToner	Obtiene un valor que indica si la impresora tiene tóner.
HostingPrintServer	Obtiene o establece (protegido) el servidor de impresión que controla la cola de impresión.
InPartialTrust	Obtiene o establece un valor que indica si la cola funciona en un modo de confianza parcial, un nivel mayor de confianza.
IsBidiEnabled	Obtiene un valor que indica si la comunicación bidireccional con la impresora está habilitada.
IsBusy	Obtiene un valor que indica si el dispositivo de impresión está ocupado.
IsDevQueryEnabled	Obtiene un valor que indica si la cola contiene documentos cuando las configuraciones de documento e impresora no coinciden.
IsDirect	Obtiene un valor que indica si la cola imprime directamente en la impresora o si primero pone en cola los documentos y después los imprime.
IsDisposed	Obtiene o establece un valor que indica si el objeto se ha eliminado. (Heredado de PrintSystemObject)
IsDoorOpened	Obtiene un valor que indica si hay una puerta abierta en la impresora.
IsHidden	Obtiene un valor que indica si la cola de impresión está oculta en la interfaz de usuario de la aplicación.
IsInError	Obtiene un valor que indica si la impresora o el dispositivo se encuentra en una condición de error.
IsInitializing	Obtiene un valor que indica si la impresora se está inicializando.
IsIOActive	Obtiene un valor que indica si la impresora está recibiendo o enviando datos o señales.
IsManualFeedRequired	Obtiene un valor que indica si la impresora necesita alimentación manual del papel para el trabajo de impresión actual.
IsNotAvailable	Obtiene un valor que indica si la impresora está disponible.
IsOffline	Obtiene un valor que indica si la impresora está sin conexión.
IsOutOfMemory	Obtiene un valor que indica si la impresora tiene memoria insuficiente.
IsOutOfPaper	Obtiene un valor que indica si es necesario recargar la impresora con papel del tamaño necesario para el trabajo actual.
IsOutputBinFull	Obtiene un valor que indica si el área de salida de la impresora puede sufrir un desbordamiento.
IsPaperJammed	Obtiene un valor que indica si la hoja actual de papel está bloqueada en la impresora.
IsPaused	Obtiene un valor que indica si se ha puesto en pausa la cola de impresión.
IsPendingDeletion	Obtiene un valor que indica si la impresora está en proceso de eliminar un trabajo de impresión.
IsPowerSaveOn	Obtiene un valor que indica si la impresora está en modo de ahorro de energía.
IsPrinting	Obtiene un valor que indica si se está imprimiendo un trabajo.
IsProcessing	Obtiene un valor que indica si la impresora está procesando un trabajo de impresión.
IsPublished	Obtiene un valor que indica si la impresora es visible para otros usuarios de la red.
IsQueued	Obtiene un valor que indica si la impresora admite una cola con más de un trabajo de impresión a la vez.
IsRawOnlyEnabled	Obtiene un valor que indica si la cola de impresión puede usar EMF (Metarchivo mejorado) que permite un flujo de datos más rápido de una aplicación de impresión al administrador de trabajos de impresión de Windows.
IsServerUnknown	Obtiene un valor que indica si la impresora está en un estado de error.
IsShared	Obtiene un valor que indica si la impresora está disponible para que otros equipos de la red la usen.
IsTonerLow	Obtiene un valor que indica si la impresora se está quedando sin tóner.
IsWaiting	Obtiene un valor que indica si la cola está a la espera de que se agregue un trabajo.
IsWarmingUp	Obtiene un valor que indica si la impresora se está preparando.
IsXpsDevice	Obtiene un valor que indica si el controlador de la impresora se basa en el modelo XPSDrv, por lo que usa XML Paper Specification (XPS) como lenguaje de descripción de páginas.
KeepPrintedJobs	Obtiene un valor que indica si la cola guarda el archivo de lenguaje de impresión en lugar de eliminarlo después de imprimir.
Location	Obtiene o establece la ubicación física de la impresora.
MaxPrintSchemaVersion	Obtiene el número de versiones posibles más recientes del Esquema de impresión que puede utilizar la cola.
Name	Obtiene o establece el nombre de la cola de impresión.
NeedUserIntervention	Obtiene un valor que indica si la impresora necesita algún tipo de intervención humana.
NumberOfJobs	Obtiene el número total de trabajos que están en la cola de impresión.
PagePunt	Obtiene un valor que indica si la impresora no puede imprimir la página actual.
Parent	Obtiene el elemento primario del objeto. (Heredado de PrintSystemObject)
PrintingIsCancelled	Obtiene o establece un valor que indica si se está cancelando el trabajo de impresión actual.
Priority	Obtiene o establece la prioridad de la cola de impresión respecto a otras colas que se hospedan en el mismo servidor de impresión y que usan la misma impresora física.
PropertiesCollection	Obtiene una colección de pares de atributo y valor. (Heredado de PrintSystemObject)
QueueAttributes	Obtiene las propiedades de la cola de impresión.
QueueDriver	Obtiene o establece el controlador de impresora para la cola.
QueuePort	Obtiene o establece el puerto que la cola usa.
QueuePrintProcessor	Obtiene o establece el procesador de impresión que la cola usa.
QueueStatus	Obtiene un valor que representa el estado de la impresora. Entre los valores se incluyen "preparando", "inicializando", "imprimiendo", etc.
ScheduleCompletedJobsFirst	Obtiene un valor que indica si la impresora imprime los trabajos que han completado el proceso de puesta en cola antes que los trabajos que no lo han finalizado, aunque estos últimos hayan entrado en cola primero o tengan mayor prioridad.
SeparatorFile	Obtiene o establece la ruta de acceso y nombre de un archivo que se inserta al principio de cada trabajo de impresión.
ShareName	Obtiene o establece un nombre para la impresora que ven los usuarios de la red cuando se comparte.
StartTimeOfDay	Obtiene o establece la hora más temprana del día, expresada como el número de minutos después de la medianoche de la hora universal coordinada (UTC) (también denominada hora del meridiano de Greenwich [GMT]), a la que la impresora imprimirá un trabajo.
UntilTimeOfDay	Obtiene o establece la última hora del día, expresada como el número de minutos después de la medianoche de la hora universal coordinada (UTC) (también denominada hora del meridiano de Greenwich [GMT]), a la que la impresora imprimirá un trabajo.
UserPrintTicket	Obtiene o establece el objeto predeterminado PrintTicket del usuario actual, que contiene información detallada sobre el trabajo de impresión.

Métodos

AddJob()	Inserta un nuevo (denominado de forma genérica) trabajo de impresión, cuyo contenido es una matriz Byte, en la cola.
AddJob(String)	Inserta un nuevo trabajo de impresión, cuyo contenido es una matriz Byte, en la cola.
AddJob(String, PrintTicket)	Inserta un nuevo trabajo de impresión para un documento de especificación de papel XML (XPS) en la cola y le proporciona el nombre y la configuración especificados.
AddJob(String, String, Boolean)	Inserta un nuevo trabajo de impresión para un documento de especificación de papel XML (XPS) en la cola, le da el nombre especificado y especifica si se debe validar o no.
AddJob(String, String, Boolean, PrintTicket)	Inserta un nuevo trabajo de impresión para un documento de especificación de papel XML (XPS) en la cola, le proporciona el nombre y la configuración especificados y especifica si se debe validar o no.
Commit()	Escribe las propiedades actuales del objeto PrintQueue en la cola de impresión real del servidor de impresión.
CreateXpsDocumentWriter(Double, Double)	Crea un objeto XpsDocumentWriter con las dimensiones especificadas.
CreateXpsDocumentWriter(PrintDocumentImageableArea)	Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los soportes.
CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows, proporciona un intervalo de páginas y una descripción del trabajo de impresión al cuadro de diálogo y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los medios.
CreateXpsDocumentWriter(PrintQueue)	Crea un objeto XpsDocumentWriter y lo asocia a la cola de impresión especificada.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea)	Crea un objeto XpsDocumentWriter, abre un cuadro de diálogo de impresión común de Windows (y le proporciona una descripción de trabajo) y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los soportes.
CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)	Crea un objeto XpsDocumentWriter, abre un diálogo de impresión común de Windows, proporciona un intervalo de páginas al cuadro de diálogo y devuelve un parámetro ref (ByRef en Visual Basic) que representa información sobre el área de impresión y las dimensiones de los medios.
Dispose()	Libera todos los recursos que usa PrintSystemObject. (Heredado de PrintSystemObject)
Dispose(Boolean)	Libera los recursos no administrados que usa PrintSystemObject y, de forma opcional, libera los recursos administrados. (Heredado de PrintSystemObject)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetJob(Int32)	Obtiene el trabajo de impresión con el número de id. especificado.
GetPrintCapabilities()	Obtiene un objeto PrintCapabilities que identifica las capacidades de la impresora.
GetPrintCapabilities(PrintTicket)	Obtiene un objeto PrintCapabilities que identifica las capacidades de la impresora.
GetPrintCapabilitiesAsXml()	Obtiene un objeto MemoryStream que especifica las capacidades de la impresora como una secuencia XML que cumple con el Esquema de impresión.
GetPrintCapabilitiesAsXml(PrintTicket)	Obtiene un objeto MemoryStream que especifica las capacidades de la impresora en formato XML que cumple con el Esquema de impresión.
GetPrintJobInfoCollection()	Crea una colección que contiene un objeto PrintSystemJobInfo para cada trabajo de la cola.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Initialize()	Inicializa las propiedades de la clase PrintSystemObject. (Heredado de PrintSystemObject)
InternalDispose(Boolean)	Libera los recursos no administrados que usa PrintQueue y, de forma opcional, libera los recursos administrados.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MergeAndValidatePrintTicket(PrintTicket, PrintTicket)	Combina dos PrintTicket y garantiza que el objeto PrintTicket resultante sea válido, y no pregunta si hay alguna funcionalidad de impresión que la impresora no admita.
MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope)	Combina dos objetos PrintTicket y garantiza que el objeto PrintTicket resultante sea válido, no pregunta si hay alguna funcionalidad de impresión que la impresora no admita y se limita al ámbito especificado.
Pause()	Pone en pausa la cola de impresión. Permanece en pausa hasta que se ejecuta Resume().
Purge()	Quita todos los trabajos de la cola de impresión.
Refresh()	Actualiza las propiedades del objeto PrintQueue con valores de la impresora y la utilidad de cola de impresión que se ejecuta en el equipo.
Resume()	Reinicia una cola de impresión puesta en pausa.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• PrintServer