PrintQueue Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет принтерами и заданиями печати.
public ref class PrintQueue : System::Printing::PrintSystemObject
public class PrintQueue : System.Printing.PrintSystemObject
type PrintQueue = class
inherit PrintSystemObject
Public Class PrintQueue
Inherits PrintSystemObject
- Наследование
Комментарии
Некоторые свойства PrintQueue объекта представляют характеристики служебной программы очереди печати, которая выполняется на компьютере, но другие представляют функции или состояния самого принтера. Например, NumberOfJobs является характеристикой очереди печати, но Location является свойством принтера. Многие свойства принтера, такие как необходимость внимания пользователей, должны быть переданы с помощью Refresh метода из самого принтера в PrintQueue объект. Это необходимо сделать, прежде чем соответствующее свойство (NeedUserIntervention) считывается программой. Аналогичным образом, когда программа изменяет значения одного или нескольких PrintQueue свойств объекта, это изменение должно быть записано в фактическую служебную программу очереди печати на компьютере. Сделайте это с Commit помощью метода.
Caution
Классы в System.Printing пространстве имен не поддерживаются для использования в службе Windows или ASP.NET приложения или службы. При попытке использовать эти классы из одного из этих типов приложений могут возникнуть непредвиденные проблемы, такие как снижение производительности службы и исключения во время выполнения.
Если вы хотите распечатать из приложения Windows Forms, просмотрите System.Drawing.Printing пространство имен.
Конструкторы
| Имя | Описание |
|---|---|
| PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса с помощью указанного PrintQueuePrintServerимени очереди, версии схемы печати и требуемого доступа. |
| PrintQueue(PrintServer, String, Int32) |
Инициализирует новый экземпляр класса с помощью указанного PrintQueuePrintServerимени очереди и версии схемы печати. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр PrintQueue класса с указанным PrintServerименем очереди, массивом значений для инициализации PrintQueueIndexedProperty и требуемого доступа. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[]) |
Инициализирует новый экземпляр класса с помощью указанного PrintQueuePrintServer, имени очереди и массива значений для инициализации PrintQueueIndexedProperty . |
| PrintQueue(PrintServer, String, PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса с помощью указанного PrintQueue , имени PrintServerочереди и требуемого доступа. |
| PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса с помощью указанного PrintQueuePrintServer, имени очереди, фильтра свойств и требуемого доступа. |
| PrintQueue(PrintServer, String, String[]) |
Инициализирует новый экземпляр класса с помощью указанного PrintQueuePrintServer, имени очереди и массива имен свойств для инициализации. |
| PrintQueue(PrintServer, String) |
Инициализирует новый экземпляр класса с помощью указанного PrintQueuePrintServer и имени очереди. |
Свойства
| Имя | Описание |
|---|---|
| AveragePagesPerMinute |
Получает скорость принтера, измеряемого на страницах в минуту. |
| ClientPrintSchemaVersion |
Возвращает версию схемы печати. |
| Comment |
Возвращает или задает комментарий о принтере. |
| CurrentJobSettings |
Возвращает объект, содержащий параметры конфигурации для текущего задания печати. |
| DefaultPrintTicket |
Возвращает или задает параметры принтера по умолчанию, связанные с этим PrintQueue. |
| DefaultPriority |
Возвращает или задает приоритет по умолчанию, предоставленный каждому новому заданию печати, добавленным в очередь. |
| Description |
Возвращает описание очереди печати. |
| FullName |
Возвращает полное имя очереди. |
| HasPaperProblem |
Возвращает значение, указывающее, имеет ли принтер проблему с неопределенной бумагой. |
| HasToner |
Возвращает значение, указывающее, имеет ли принтер тонер. |
| HostingPrintServer |
Возвращает или задает (защищено) сервер печати, который управляет очередью печати. |
| InPartialTrust |
Возвращает или задает значение, указывающее, работает ли очередь в частично доверенном режиме, более высокий уровень доверия. |
| IsBidiEnabled |
Возвращает значение, указывающее, включена ли двунаправленная связь с принтером. |
| IsBusy |
Возвращает значение, указывающее, занято ли устройство печати. |
| IsDevQueryEnabled |
Возвращает значение, указывающее, содержит ли очередь документы, когда конфигурации документа и принтера не совпадают. |
| IsDirect |
Возвращает значение, указывающее, печатается ли очередь непосредственно на принтере или впуле документов, а затем печатает их. |
| IsDisposed |
Возвращает или задает значение, указывающее, был ли удален объект. (Унаследовано от PrintSystemObject) |
| IsDoorOpened |
Возвращает значение, указывающее, открыта ли дверь на принтере. |
| IsHidden |
Возвращает значение, указывающее, скрыта ли очередь печати в пользовательском интерфейсе приложения. |
| IsInError |
Возвращает значение, указывающее, находится ли принтер или устройство в состоянии ошибки. |
| IsInitializing |
Возвращает значение, указывающее, инициализируется ли принтер сам. |
| IsIOActive |
Возвращает значение, указывающее, получает ли принтер или отправляет данные или сигналы. |
| IsManualFeedRequired |
Возвращает значение, указывающее, требуется ли принтер вручную питать бумагу для текущего задания печати. |
| IsNotAvailable |
Возвращает значение, указывающее, доступен ли принтер. |
| IsOffline |
Возвращает значение, указывающее, находится ли принтер в автономном режиме. |
| IsOutOfMemory |
Возвращает значение, указывающее, выходит ли принтер из памяти. |
| IsOutOfPaper |
Возвращает значение, указывающее, нужно ли перезагрузить принтер с бумагой размера, необходимого для текущего задания. |
| IsOutputBinFull |
Возвращает значение, указывающее, находится ли выходная область принтера в опасности переполнения. |
| IsPaperJammed |
Возвращает значение, указывающее, зависает ли текущий лист бумаги на принтере. |
| IsPaused |
Возвращает значение, указывающее, приостановлена ли очередь печати. |
| IsPendingDeletion |
Возвращает значение, указывающее, находится ли принтер в процессе удаления задания печати. |
| IsPowerSaveOn |
Возвращает значение, указывающее, находится ли принтер в режиме экономии питания. |
| IsPrinting |
Возвращает значение, указывающее, печатается ли задание. |
| IsProcessing |
Возвращает значение, указывающее, обрабатывает ли принтер задание печати. |
| IsPublished |
Возвращает значение, указывающее, отображается ли принтер другим пользователям сети. |
| IsQueued |
Получает значение, указывающее, может ли принтер поддерживать очередь с несколькими заданиями печати в нем одновременно. |
| IsRawOnlyEnabled |
Возвращает значение, указывающее, может ли очередь печати использовать EMF (расширенный метафайл), которая позволяет ускорить поток данных из приложения печати в spooler Windows. |
| IsServerUnknown |
Возвращает значение, указывающее, находится ли принтер в состоянии ошибки. |
| IsShared |
Возвращает значение, указывающее, доступен ли принтер для использования другими компьютерами в сети. |
| IsTonerLow |
Возвращает значение, указывающее, работает ли принтер без тонера. |
| IsWaiting |
Возвращает значение, указывающее, ожидает ли очередь добавления задания. |
| IsWarmingUp |
Возвращает значение, указывающее, разогревается ли принтер. |
| IsXpsDevice |
Возвращает значение, указывающее, создан ли драйвер принтера на основе модели XPSDrv , поэтому он использует xml Paper Specification (XPS) в качестве языка описания страницы. |
| KeepPrintedJobs |
Возвращает значение, указывающее, сохраняет ли очередь языковой файл принтера, а не удаляет его после печати. |
| Location |
Возвращает или задает физическое расположение принтера. |
| MaxPrintSchemaVersion |
Возвращает последний возможный номер версии схемы печати , которую может использовать очередь. |
| Name |
Возвращает или задает имя очереди печати. |
| NeedUserIntervention |
Возвращает значение, указывающее, требуется ли принтеру внимание человека. |
| NumberOfJobs |
Возвращает общее количество заданий, которые выстроили в очереди печати. |
| PagePunt |
Возвращает значение, указывающее, не удается ли принтеру распечатать текущую страницу. |
| Parent |
Возвращает родительский объект объекта . (Унаследовано от PrintSystemObject) |
| PrintingIsCancelled |
Возвращает или задает значение, указывающее, отменено ли текущее задание печати. |
| Priority |
Возвращает или задает приоритет очереди печати относительно других очередей печати, размещенных на том же сервере печати и использующих тот же физический принтер. |
| PropertiesCollection |
Возвращает коллекцию пар атрибутов и значений. (Унаследовано от PrintSystemObject) |
| QueueAttributes |
Возвращает свойства очереди печати. |
| QueueDriver |
Возвращает или задает драйвер принтера для очереди. |
| QueuePort |
Возвращает или задает порт, используемый очередью. |
| QueuePrintProcessor |
Возвращает или задает обработчик печати, который использует очередь. |
| QueueStatus |
Возвращает значение, представляющее состояние принтера. К ним относятся "потепление", "инициализация", "печать", а также другие. |
| ScheduleCompletedJobsFirst |
Возвращает значение, указывающее, выполняется ли задание печати принтера, которое завершило процесс spooling до заданий, которые не полностью спунули, даже если последний вошел в очередь первым или имеет более высокий приоритет. |
| SeparatorFile |
Возвращает или задает путь и имя файла, вставленного в начале каждого задания печати. |
| ShareName |
Получает или задает имя принтера, который отображается пользователями в сети при совместном использовании. |
| StartTimeOfDay |
Возвращает или задает самое раннее время дня, выраженное как количество минут после полуночи в формате UTC (также называемое среднее время Гринвича [GMT]), которое принтер будет печатать задание. |
| UntilTimeOfDay |
Возвращает или задает последнее время, выраженное в виде количества минут после полуночи координированное универсальное время (UTC) (также называемое среднее время Гринвича [GMT]), что принтер будет печатать задание. |
| UserPrintTicket |
Возвращает или задает объект по умолчанию PrintTicket текущего пользователя, содержащий подробные сведения о задании печати. |
Методы
| Имя | Описание |
|---|---|
| AddJob() |
Вставляет новое (универсально именованное) задание печати, содержимое которого является массивом Byte , в очередь. |
| AddJob(String, PrintTicket) |
Вставляет новое задание печати для документа XML Paper (XPS) в очередь и предоставляет ему указанное имя и параметры. |
| AddJob(String, String, Boolean, PrintTicket) |
Вставляет новое задание печати для документа XML Paper (XPS) в очередь, дает ему указанное имя и параметры, а также указывает, следует ли проверять его. |
| AddJob(String, String, Boolean) |
Вставляет новое задание печати для документа XML Paper (XPS) в очередь, дает ему указанное имя и указывает, следует ли проверять его. |
| AddJob(String) |
Вставляет новое задание печати, содержимое которого является массивом Byte , в очередь. |
| Commit() |
Записывает текущие свойства PrintQueue объекта в фактическую очередь печати на сервере печати. |
| CreateXpsDocumentWriter(Double, Double) |
XpsDocumentWriter Создает объект с указанными измерениями. |
| CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange) |
XpsDocumentWriter Создает объект, открывает общий диалог печати Windows, предоставляет диалоговое окно с диапазоном страниц и описанием задания печати и возвращает |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
XpsDocumentWriter Создает объект, открывает общий диалог печати Windows и возвращает |
| CreateXpsDocumentWriter(PrintQueue) |
Создает объект и связывает его с указанной XpsDocumentWriter очередью печати. |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
XpsDocumentWriter Создает объект, открывает общий диалог печати Windows, предоставляет диалоговое окно с диапазоном страниц и возвращает |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea) |
XpsDocumentWriter Создает объект, открывает общий диалог печати Windows (и предоставляет его описание задания) и возвращает |
| Dispose() |
Освобождает все ресурсы, используемые параметром PrintSystemObject. (Унаследовано от PrintSystemObject) |
| Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые PrintSystemObject и при необходимости освобождает управляемые ресурсы. (Унаследовано от PrintSystemObject) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetJob(Int32) |
Возвращает задание печати с указанным идентификатором. |
| GetPrintCapabilities() |
Возвращает объект, определяющий PrintCapabilities возможности принтера. |
| GetPrintCapabilities(PrintTicket) |
Возвращает объект, определяющий PrintCapabilities возможности принтера. |
| GetPrintCapabilitiesAsXml() |
Возвращает объект, указывающий MemoryStream возможности принтера в виде XML-потока, соответствующего схеме печати. |
| GetPrintCapabilitiesAsXml(PrintTicket) |
Возвращает объект, указывающий MemoryStream возможности принтера в формате XML, который соответствует схеме печати. |
| GetPrintJobInfoCollection() |
Создает коллекцию, содержащую PrintSystemJobInfo объект для каждого задания в очереди. |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Initialize() |
Инициализирует свойства объекта PrintSystemObject. (Унаследовано от PrintSystemObject) |
| InternalDispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые PrintQueue и при необходимости освобождает управляемые ресурсы. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope) |
Объединяет два PrintTicketи гарантирует, что полученный результат PrintTicket действителен, не запрашивает какие-либо функции печати, которые принтер не поддерживает, и ограничивается указанной областью. |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket) |
Объединяет два PrintTicketи гарантирует, что полученный результат PrintTicket действителен и не запрашивает какие-либо функции печати, которые принтер не поддерживает. |
| Pause() |
Приостанавливает очередь печати. Он остается приостановленным, пока Resume() не будет выполнено. |
| Purge() |
Удаляет все задания в очереди печати. |
| Refresh() |
Обновляет свойства PrintQueue объекта со значениями из принтера и служебной программы очереди печати, которая выполняется на компьютере. |
| Resume() |
Перезапуск очереди печати, приостановленной. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |