PrintQueue Clase

Definición

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

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 proporciona 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)

Se aplica a

Consulte también