System.Printing Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет классы, позволяющие автоматизировать управление серверами печати, очередями печати и заданиями печати.
Классы
| Имя | Описание |
|---|---|
| LocalPrintServer |
Представляет локальный сервер печати (компьютер, на котором работает приложение) и включает управление очередями печати. |
| PageImageableArea |
Представляет область страницы, которую можно распечатать. |
| PageMediaSize |
Описывает размер страницы для бумаги или другого носителя. |
| PageResolution |
Определяет разрешение печатных выходных данных как качественное или как точки на дюйм или оба. |
| PageScalingFactorRange |
Указывает диапазон процентных значений, с помощью которых принтер может увеличить или уменьшить изображение печати на странице. |
| PrintCapabilities |
Определяет возможности принтера. |
| PrintCommitAttributesException |
Исключение, которое возникает, когда условие ошибки предотвращает фиксацию некоторых атрибутов фактическим PrintSystemObject компьютером, принтером или устройством, которое представляет объект. |
| PrintDocumentImageableArea |
Задает размер бумаги (или другого носителя), размер области изображения и расположение области изображения. |
| PrintDriver |
Представляет драйвер печати. |
| PrintFilter |
Определяет поведение удаления, которое обычно используется как PrintDriver для классов, так и PrintProcessor для классов. PrintFilter поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначена для использования непосредственно из кода. |
| PrintingCanceledException |
Исключение, возникающее при попытке кода получить доступ к отмененном заданию печати. |
| PrintingNotSupportedException |
Исключение, которое возникает, когда операция печати не поддерживается. |
| PrintJobException |
Исключение, возникающее при неправильном выполнении задания печати. |
| PrintJobInfoCollection |
Представляет один или несколько PrintSystemJobInfo объектов. |
| PrintJobSettings |
Описывает задание печати. |
| PrintPort |
Представляет порт принтера на сервере печати. Каждая очередь печати имеет порт печати, назначенный ему. |
| PrintProcessor |
Представляет обработчик печати на сервере печати. |
| PrintQueue |
Управляет принтерами и заданиями печати. |
| PrintQueueCollection |
Представляет коллекцию PrintQueue объектов. |
| PrintQueueException |
Исключение, которое возникает, когда условие ошибки препятствует доступу или созданию объекта PrintQueue. |
| PrintQueueStream |
Поток, представляющий задание печати в очереди печати. |
| PrintQueueStringProperty |
Представляет один и только один из трех возможных свойств очереди печати: Location, Commentили ShareName. |
| PrintServer |
Управляет очередями печати на сервере печати, который обычно является компьютером, но может быть выделенным аппаратным устройством сервера печати. |
| PrintServerException |
Исключение, возникающее, когда условие ошибки предотвращает доступ или создание объекта PrintServer. |
| PrintSystemException |
Исключение, возникающее, когда условие ошибки предотвращает доступ или создание PrintSystemObject. |
| PrintSystemJobInfo |
Подробно определяет задание печати. |
| PrintSystemObject |
Определяет основные свойства и методы, которые являются общими для объектов системы печати. Классы, производные от этого класса, представляют такие объекты, как очереди печати, серверы печати и задания печати. |
| PrintSystemObjectPropertiesChangedEventArgs |
Предоставляет данные для события PropertiesChanged, которое необходимо создать. |
| PrintSystemObjectPropertyChangedEventArgs |
Предоставляет данные для события PropertyChanged, которое необходимо создать. |
| PrintSystemObjects |
Представляет коллекцию объектов системы печати. |
| PrintTicket |
Определяет параметры задания печати. |
Структуры
| Имя | Описание |
|---|---|
| ValidationResult |
Представляет объединенный PrintTicket, который гарантированно является жизнеспособным, с отчетом о любых параметрах, которые были изменены, чтобы сделать его жизнеспособным. |
Перечисления
| Имя | Описание |
|---|---|
| Collation |
Указывает, выполняется ли сортировка выходных данных принтера при печати нескольких копий многостраничного задания печати. |
| ConflictStatus |
Указывает, были ли внесены изменения в объединенный PrintTicket для обеспечения жизнеспособности PrintTicket. |
| DeviceFontSubstitution |
Указывает, включена ли подстановка шрифта устройства на принтере. |
| Duplexing |
Указывает, использует ли принтер одностороннюю печать или двухстороннюю печать (дуплексную). |
| EnumeratedPrintQueueTypes |
Задает атрибуты очередей печати. |
| InputBin |
Указывает входной контейнер, используемый в качестве источника пустой бумаги или другого носителя печати. |
| LocalPrintServerIndexedProperty |
Указывает свойства объекта LocalPrintServer, инициализируемые при его создании. |
| OutputColor |
Указывает, как распечатать содержимое, содержащее цвет или оттенки серого. |
| OutputQuality |
Задает типы качества вывода для устройства печати. |
| PageBorderless |
Указывает, печатает ли устройство печати на краю носителя или предоставляет непечатаемое поле вокруг края. |
| PageMediaSizeName |
Указывает размер страницы или ширину рулона бумаги или другого носителя печати. |
| PageMediaType |
Указывает типы бумаги или другого носителя. |
| PageOrder |
Указывает, печатает ли устройство печати многостраничные документы с переднего или заднего или заднего. |
| PageOrientation |
Указывает, как страницы содержимого ориентированы на печатные носители. |
| PageQualitativeResolution |
Задает разрешение страницы как качественное, нечисловое значение. |
| PagesPerSheetDirection |
Указывает расположение страниц, когда на одной стороне печати отображается несколько страниц содержимого. |
| PhotoPrintingIntent |
Указывает качество выходных данных при печати фотографии. Драйвер принтера преобразует PhotoPrintingIntent в количественные значения для разрешения и других факторов качества. |
| PrintJobPriority |
Указывает нечисленный приоритет задания печати относительно других заданий печати в очереди печати. |
| PrintJobStatus |
Указывает текущее состояние задания печати в очереди печати. |
| PrintJobType |
Указывает, использует ли задание печати спецификацию XML-бумаги (XPS). |
| PrintQueueAttributes |
Задает атрибуты очереди печати и его принтера. |
| PrintQueueIndexedProperty |
Указывает свойства, инициализированные при создании объекта PrintQueue. |
| PrintQueueStatus |
Указывает состояние очереди печати или его принтера. |
| PrintQueueStringPropertyType |
Указывает предполагаемое значение PrintQueueStringProperty. |
| PrintServerEventLoggingTypes |
Указывает типы событий, которые можно регистрировать PrintServer. |
| PrintServerIndexedProperty |
Указывает свойства объекта PrintServer, инициализируемые при его создании. |
| PrintSystemDesiredAccess |
Указывает различные права доступа (или уровни доступа) для объектов печати. |
| PrintSystemObjectLoadMode |
Указывает, инициализированы ли свойства объекта при загрузке объекта. |
| PrintTicketScope |
Указывает, применяется ли PrintTicket ко всему заданию печати, одному документу в задании печати или просто странице в задании печати. |
| Stapling |
Указывает, является ли принтер основным элементом документа с несколькими страницами. |
| TrueTypeFontMode |
Указывает, как принтер обрабатывает текст, отформатированный шрифтом TrueType. |
Комментарии
Это пространство имен содержит следующие основные классы:
Класс PrintSystemObject , являющийся базовым классом для других основных классов печати.
Класс PrintServer , представляющий фактический сервер печати, обычно компьютер.
Класс PrintQueue , представляющий фактическую очередь печати и его принтер.
Класс PrintSystemJobInfo , представляющий определенное задание печати.
Класс PrintTicket , который указывает принтеру, как обработать задание печати.
Классы, производные PrintSystemObject от класса, имеют метод Commit и Refresh метод. Эти методы необходимо использовать для синхронизации экземпляров классов с аппаратными или программными компонентами, которые они представляют.
Пространство System.Printing имен также содержит множество перечислений, описывающих возможности принтера, например, может ли принтер производить сортировку выходных данных, а также указывать инструкции принтерам, таким как размер бумаги, используемый для задания печати.
Это пространство имен является частью расширенных служб печати, предоставляемых Windows Presentation Foundation. Разработчики управляемого кода, использующие Windows Forms, должны использовать API в пространстве имен System.Drawing.Printing.
Предостережение
Классы в System.Printing пространстве имен не поддерживаются для использования в службе Windows или ASP.NET приложения или службы. При попытке использовать эти классы из одного из этих типов приложений могут возникнуть непредвиденные проблемы, такие как снижение производительности службы и исключения во время выполнения.
