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 метода .

Внимание!

Классы в 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 и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

CreateXpsDocumentWriter(PrintDocumentImageableArea, PageRangeSelection, PageRange)

Создает объект XpsDocumentWriter, открывает стандартный диалог печати Windows, передает в него диапазон страниц и описание задания печати и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

CreateXpsDocumentWriter(PrintQueue)

Создает объект XpsDocumentWriter и связывает его с указанной очередью печати.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows (и передает в него описание задания) и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

CreateXpsDocumentWriter(String, PrintDocumentImageableArea, PageRangeSelection, PageRange)

Создает объект XpsDocumentWriter, открывает стандартное диалоговое окно печати Windows, передает в него диапазон страниц и возвращает параметр ref (ByRef в Visual Basic), представляющий сведения об области печати и размерах носителя.

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)

Применяется к

См. также раздел