PrintQueue Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Administra impresoras e 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, por medio del Refresh método , de la 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 .
Caution
No se admiten clases dentro del System.Printing espacio de nombres para su uso dentro de un servicio de Windows ni ASP.NET aplicación o servicio. 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
| Nombre | Description |
|---|---|
| PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess) |
Inicializa una nueva instancia de clase con el nombre de PrintQueue cola, la versión de esquema de impresión y el acceso deseado especificados PrintServer. |
| PrintQueue(PrintServer, String, Int32) |
Inicializa una nueva instancia de clase con la versión de PrintServeresquema de impresión especificada, el nombre de PrintQueue la cola y la versión de esquema de impresión. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess) |
Inicializa una nueva instancia de clase con el , nombre de PrintQueue cola, matriz de PrintQueueIndexedProperty valores para inicializar y el acceso deseado especificadosPrintServer. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[]) |
Inicializa una nueva instancia de PrintQueue clase mediante el especificado , el nombre de la cola y la PrintServermatriz de PrintQueueIndexedProperty valores que se van a inicializar. |
| PrintQueue(PrintServer, String, PrintSystemDesiredAccess) |
Inicializa una nueva instancia de clase con el nombre de PrintQueue cola especificado PrintServery el acceso deseado. |
| PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess) |
Inicializa una nueva instancia de clase mediante el nombre de PrintQueue cola, el filtro de propiedades y el acceso deseado especificados PrintServer. |
| PrintQueue(PrintServer, String, String[]) |
Inicializa una nueva instancia de clase utilizando el nombre de PrintQueue cola especificado PrintServery la matriz de nombres de propiedad que se van a inicializar. |
| PrintQueue(PrintServer, String) |
Inicializa una nueva instancia de PrintQueue clase con el nombre de cola y especificados PrintServer . |
Propiedades
| Nombre | Description |
|---|---|
| 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 los valores de configuración del trabajo de impresión actual. |
| DefaultPrintTicket |
Obtiene o establece las opciones de impresora predeterminadas asociadas a este 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 de 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 de confianza superior. |
| 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 se imprime directamente en los documentos de impresora o cola y, a continuación, las 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 una puerta está 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 recibe o envía datos o señales. |
| IsManualFeedRequired |
Obtiene un valor que indica si la impresora debe alimentar manualmente el 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 no tiene memoria. |
| IsOutOfPaper |
Obtiene un valor que indica si la impresora debe volver a cargarse con papel del tamaño necesario para el trabajo actual. |
| IsOutputBinFull |
Obtiene un valor que indica si el área de salida de la impresora está en peligro de desbordamiento. |
| IsPaperJammed |
Obtiene un valor que indica si la hoja de papel actual está bloqueada en la impresora. |
| IsPaused |
Obtiene un valor que indica si la cola de impresión se ha pausado. |
| 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 un trabajo está imprimiendo. |
| 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 está visible para otros usuarios de red. |
| IsQueued |
Obtiene un valor que indica si la impresora puede admitir 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 (archivo meta mejorado) que permite un flujo de datos más rápido desde una aplicación de impresión hasta el colador de Windows. |
| IsServerUnknown |
Obtiene un valor que indica si la impresora está en estado de error. |
| IsShared |
Obtiene un valor que indica si la impresora está disponible para su uso por parte de otros equipos de la red. |
| IsTonerLow |
Obtiene un valor que indica si la impresora se está ejecutando poco tóner. |
| IsWaiting |
Obtiene un valor que indica si la cola está esperando a que se agregue un trabajo. |
| IsWarmingUp |
Obtiene un valor que indica si la impresora se está calentando. |
| IsXpsDevice |
Obtiene un valor que indica si el controlador de la impresora se basa en el modelo XPSDrv para que use xml Paper Specification (XPS) como lenguaje de descripción de página. |
| KeepPrintedJobs |
Obtiene un valor que indica si la cola guarda el archivo de idioma de la impresora en lugar de eliminarlo después de imprimirlo. |
| Location |
Obtiene o establece la ubicación física de la impresora. |
| MaxPrintSchemaVersion |
Obtiene el número de versión más reciente posible del esquema de impresión que puede usar la cola. |
| Name |
Obtiene o establece el nombre de la cola de impresión. |
| NeedUserIntervention |
Obtiene un valor que indica si la impresora necesita la atención de un ser humano. |
| NumberOfJobs |
Obtiene el número total de trabajos alineados en la cola de impresión. |
| PagePunt |
Obtiene un valor que indica si la impresora no puede imprimir la página actual. |
| Parent |
Obtiene al objeto primario del objeto. (Heredado de PrintSystemObject) |
| PrintingIsCancelled |
Obtiene o establece un valor que indica si se cancela el trabajo de impresión actual. |
| Priority |
Obtiene o establece la prioridad de la cola de impresión en relación con otras colas de impresión hospedadas por 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 de la cola. |
| QueuePort |
Obtiene o establece el puerto que usa la cola. |
| QueuePrintProcessor |
Obtiene o establece el procesador de impresión que usa la cola. |
| QueueStatus |
Obtiene un valor que representa el estado de la impresora. Estos incluyen "calentamiento", "inicialización", "impresión" y otros. |
| ScheduleCompletedJobsFirst |
Obtiene un valor que indica si la impresora imprime los trabajos que han completado el proceso de puesta en cola antes de los trabajos que no se han puesto en cola por completo, incluso si este último entró primero en la cola o tiene una prioridad mayor. |
| SeparatorFile |
Obtiene o establece la ruta de acceso y el nombre de archivo 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 hora universal coordinada (UTC) (también denominada Hora media de Greenwich [GMT]), que la impresora imprimirá un trabajo. |
| UntilTimeOfDay |
Obtiene o establece la hora más reciente, expresada como el número de minutos después de la medianoche hora universal coordinada (UTC) (también denominada Hora media de Greenwich [GMT]), 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
| Nombre | Description |
|---|---|
| AddJob() |
Inserta un nuevo trabajo de impresión (con nombre genérico), cuyo contenido es una Byte matriz, 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, 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. |
| 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) |
Inserta un nuevo trabajo de impresión, cuyo contenido es una Byte matriz, en la cola. |
| Commit() |
Escribe las propiedades actuales del PrintQueue objeto en la cola de impresión real en el servidor de impresión. |
| CreateXpsDocumentWriter(Double, Double) |
Crea un XpsDocumentWriter objeto con las dimensiones especificadas. |
| CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Crea un XpsDocumentWriter objeto, abre un cuadro de diálogo de impresión común de Windows, proporciona el cuadro de diálogo con un intervalo de páginas y una descripción del trabajo de impresión, y devuelve un |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
Crea un XpsDocumentWriter objeto, abre un cuadro de diálogo de impresión común de Windows y devuelve un |
| CreateXpsDocumentWriter(PrintQueue) |
Crea un XpsDocumentWriter objeto y lo asocia a la cola de impresión especificada. |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Crea un XpsDocumentWriter objeto, abre un cuadro de diálogo de impresión común de Windows, proporciona el diálogo con un intervalo de páginas y devuelve un |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea) |
Crea un XpsDocumentWriter objeto , abre un cuadro de diálogo de impresión común de Windows (y lo proporciona una descripción del trabajo) y devuelve un |
| Dispose() |
Libera todos los recursos usados por .PrintSystemObject (Heredado de PrintSystemObject) |
| Dispose(Boolean) |
Libera los recursos no administrados utilizados por PrintSystemObject y, opcionalmente, libera los recursos administrados. (Heredado de PrintSystemObject) |
| Equals(Object) |
Determina si el objeto especificado es igual al objeto actual. (Heredado de Object) |
| GetHashCode() |
Actúa como función hash predeterminada. (Heredado de Object) |
| GetJob(Int32) |
Obtiene el trabajo de impresión con el número de identificador especificado. |
| GetPrintCapabilities() |
Obtiene un PrintCapabilities objeto que identifica las funciones de la impresora. |
| GetPrintCapabilities(PrintTicket) |
Obtiene un PrintCapabilities objeto que identifica las funciones de la impresora. |
| GetPrintCapabilitiesAsXml() |
Obtiene un MemoryStream objeto que especifica las funciones de la impresora como un flujo XML que cumple con el esquema de impresión. |
| GetPrintCapabilitiesAsXml(PrintTicket) |
Obtiene un MemoryStream objeto que especifica las funciones de la impresora en un formato XML que cumple con el esquema de impresión. |
| GetPrintJobInfoCollection() |
Crea una colección que contiene un PrintSystemJobInfo objeto para cada trabajo de la cola. |
| GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
| Initialize() |
Inicializa las propiedades de .PrintSystemObject (Heredado de PrintSystemObject) |
| InternalDispose(Boolean) |
Libera los recursos no administrados utilizados por PrintQueue y, opcionalmente, libera los recursos administrados. |
| MemberwiseClone() |
Crea una copia superficial del Objectactual. (Heredado de Object) |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope) |
Combina dos PrintTickets y garantiza que el resultado PrintTicket es válido, no solicita ninguna funcionalidad de impresión que la impresora no admita y se limita al ámbito especificado. |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket) |
Combina dos PrintTickets y garantiza que el resultado PrintTicket es válido y no solicita ninguna funcionalidad de impresión que la impresora no admita. |
| Pause() |
Pausa la cola de impresión. Permanece en pausa hasta Resume() que se ejecuta. |
| Purge() |
Quita todos los trabajos de la cola de impresión. |
| Refresh() |
Actualiza las propiedades del PrintQueue objeto 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 que se ha pausado. |
| ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |