PrintQueue Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет принтерами и заданиями печати.
public ref class PrintQueue : System::Printing::PrintSystemObjectpublic class PrintQueue : System.Printing.PrintSystemObjecttype PrintQueue = class
inherit PrintSystemObjectPublic Class PrintQueue
Inherits PrintSystemObject- Наследование
Комментарии
Некоторые свойства PrintQueue объекта представляют характеристики служебной программы очереди печати, которая выполняется на компьютере, а другие — функции или состояния самого принтера. Например, NumberOfJobs является характеристикой очереди печати, но Location является свойством принтера. Многие свойства принтера, например требуется ли ему внимание пользователя, должны передаваться с помощью Refresh метода из самого принтера в PrintQueue объект . Это необходимо сделать до того, как программа считывает соответствующее свойство (NeedUserIntervention). Аналогичным образом, когда программа изменяет значения одного или нескольких PrintQueue свойств объекта, это изменение должно быть записано в служебную программу очереди печати на компьютере. Сделайте это с помощью Commit метода .
Внимание!
Классы в System.Printing пространстве имен не поддерживаются для использования в службе Windows или ASP.NET приложении или службе. Попытка использовать эти классы в одном из этих типов приложений может привести к непредвиденным проблемам, таким как снижение производительности службы и исключения во время выполнения.
Если вы хотите выполнить печать из приложения Windows Forms, см System.Drawing.Printing . пространство имен.
Конструкторы
| PrintQueue(PrintServer, String) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer и имя очереди. |
| PrintQueue(PrintServer, String, Int32) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и версию схемы печати. |
| PrintQueue(PrintServer, String, Int32, PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди, версию схемы печати и необходимый тип доступа. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[]) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и массив инициализируемых значений PrintQueueIndexedProperty. |
| PrintQueue(PrintServer, String, PrintQueueIndexedProperty[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди, массив инициализируемых значений типа PrintQueueIndexedProperty и необходимый тип доступа. |
| PrintQueue(PrintServer, String, PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и необходимый тип доступа. |
| PrintQueue(PrintServer, String, String[]) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди и массив имен инициализируемых свойств. |
| PrintQueue(PrintServer, String, String[], PrintSystemDesiredAccess) |
Инициализирует новый экземпляр класса PrintQueue, используя указанный PrintServer, имя очереди, фильтр свойств и необходимый тип доступа. |
Свойства
| 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), ускоряющий поток данных от приложения, которое осуществляет печать, к диспетчеру очереди 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 |
Получает значение, указывающее, печатает ли принтер задания, у которых завершен процесс буферизации, прежде чем печатать не полностью буферизованные задания, даже если последние стали в очередь раньше или имеют более высокий приоритет. |
| SeparatorFile |
Получает или задает путь и имя файла, который вставляется в начало каждого задания печати. |
| ShareName |
Получает или задает имя принтера, которое пользователи видят по сети, когда он находится в общем доступе. |
| StartTimeOfDay |
Получает или задает самое раннее время дня, выраженное как количество минут после полуночи в формате UTC (время по Гринвичу [GMT]), когда принтер будет печатать задание. |
| UntilTimeOfDay |
Получает или задает самое позднее время, выраженное как количество минут после полуночи в формате UTC (время по Гринвичу [GMT]), когда принтер будет печатать задание. |
| UserPrintTicket |
Возвращает или задает объект по умолчанию PrintTicket текущего пользователя, который содержит подробные сведения о задании печати. |
Методы
| AddJob() |
Вставляет в очередь новое задание печати (с общим именем), содержимое которого является массивом типа Byte. |
| AddJob(String) |
Вставляет в очередь новое задание печати, содержимое которого является массивом типа Byte. |
| AddJob(String, PrintTicket) |
Вставляет новое задание печати для документа XPS в очередь и присваивает ему указанное имя и параметры. |
| AddJob(String, String, Boolean) |
Вставляет новое задание печати для документа XPS в очередь, присваивает ему указанное имя и указывает, следует ли проверять документ. |
| AddJob(String, String, Boolean, PrintTicket) |
Вставляет новое задание печати для документа XPS в очередь, присваивает ему указанное имя и параметры, а также указывает, следует ли проверять документ. |
| Commit() |
Записывает текущие свойства объекта PrintQueue в действующую очередь печати на сервере печати. |
| CreateXpsDocumentWriter(Double, Double) |
Создает объект XpsDocumentWriter с указанными размерами. |
| CreateXpsDocumentWriter(PrintDocumentImageableArea) |
Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows и возвращает параметр |
| CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Создает объект XpsDocumentWriter, открывает стандартный диалог печати Windows, передает в него диапазон страниц и описание задания печати и возвращает параметр |
| CreateXpsDocumentWriter(PrintQueue) |
Создает объект XpsDocumentWriter и связывает его с указанной очередью печати. |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea) |
Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows (и передает в него описание задания) и возвращает параметр |
| CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange) |
Создает объект 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) |
Выполняет слияние двух объектов PrintTicket и гарантирует, что конечный объект PrintTicket будет допустимым и ему не потребуются какие-либо возможности печати, не поддерживаемые принтером. |
| MergeAndValidatePrintTicket(PrintTicket, PrintTicket, PrintTicketScope) |
Выполняет слияние двух объектов PrintTicket и гарантирует, что конечный объект PrintTicket будет допустимым, ему не потребуются какие-либо возможности печати, не поддерживаемые принтером, и он будет ограничен указанной областью. |
| Pause() |
Приостанавливает очередь печати. Очередь остается приостановленной до тех пор, пока не будет выполнен метод Resume(). |
| Purge() |
Удаляет все задания из очереди печати. |
| Refresh() |
Обновляет свойства объекта PrintQueue значениями, поступающими от принтера и утилиты очереди печати, запущенной на компьютере. |
| Resume() |
Возобновляет работу приостановленной очереди печати. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
