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) |
Вставляет новое задание печати для документа XML Paper Specification (XPS) в очередь и присваивает ему указанное имя и параметры. |
| AddJob(String, String, Boolean) |
Вставляет новое задание печати для документа XML Paper Specification (XPS) в очередь, присваивает ему указанное имя и указывает, следует ли проверять документ. |
| AddJob(String, String, Boolean, PrintTicket) |
Вставляет новое задание печати для документа XML Paper Specification (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) |