System.Drawing.Printing Пространство имен
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет службы, связанные с печатью, для приложений Windows Forms.
Классы
| InvalidPrinterException |
Представляет исключение, возникающее при попытке доступа к принтеру с использованием недопустимых параметров. |
| Margins |
Задает размеры полей печатаемой страницы. |
| MarginsConverter |
Предоставляет MarginsConverter для Margins. |
| PageSettings |
Задает параметры одной страницы, выводимой на печать. |
| PaperSize |
Задает размер бумажного листа. |
| PaperSource |
Задает лоток, из которого принтер берет бумагу. |
| PreviewPageInfo |
Задает информацию для предварительного просмотра одной страницы. Этот класс не наследуется. |
| PreviewPrintController |
Задает контроллер печати, отображающий на экране документ в виде набора изображений. |
| PrintController |
Управляет способами печати документов при осуществлении печати из приложения Windows Forms. |
| PrintDocument |
Определяет повторно используемый объект, который отправляет выходные данные на принтер при печати из приложения Windows Forms. |
| PrinterResolution |
Представляет разрешение, поддерживаемое принтером. |
| PrinterSettings |
Задает сведения о способе печати документа, включая принтер, выполняющий печать из приложения Windows Forms. |
| PrinterSettings.PaperSizeCollection |
Содержит коллекцию объектов PaperSize. |
| PrinterSettings.PaperSourceCollection |
Содержит коллекцию объектов PaperSource. |
| PrinterSettings.PrinterResolutionCollection |
Содержит коллекцию объектов PrinterResolution. |
| PrinterSettings.StringCollection |
Содержит коллекцию объектов String. |
| PrinterUnitConvert |
Задает набор методов преобразования, применяющихся при взаимодействии с интерфейсом печати Win32 API. Этот класс не наследуется. |
| PrintEventArgs |
Предоставляет данные для событий BeginPrint и EndPrint . |
| PrintingPermission |
Управляет доступом к принтерам. Этот класс не наследуется. |
| PrintingPermissionAttribute |
Разрешает декларативные проверки разрешений для печати. |
| PrintPageEventArgs |
Предоставляет данные для события PrintPage. |
| QueryPageSettingsEventArgs |
Предоставляет данные для события QueryPageSettings. |
| StandardPrintController |
Задает контроллер печати, отправляющий данные на принтер. |
Перечисления
| Duplex |
Задает параметр двухсторонней печати. |
| PaperKind |
Указывает стандартные форматы бумаги. |
| PaperSourceKind |
Стандартные источники бумаги. |
| PrintAction |
Указывает тип выполняющейся операции печати. |
| PrinterResolutionKind |
Задает разрешающую способность принтера. |
| PrinterUnit |
Задает несколько элементов измерения, используемых для печати. |
| PrintingPermissionLevel |
Задает тип печати, разрешенной для выполнения кодом. |
| PrintRange |
Задает выводимую на печать часть документа. |
Делегаты
| PrintEventHandler |
Представляет метод, обрабатывающий событие BeginPrint или событие EndPrint из PrintDocument. |
| PrintPageEventHandler |
Представляет метод, обрабатывающий событие PrintPage объекта PrintDocument. |
| QueryPageSettingsEventHandler |
Представляет метод, обрабатывающий событие QueryPageSettingsPrintDocument. |
Комментарии
Как правило, при печати из приложения Windows Forms создается новый экземпляр PrintDocument класса , задаются свойства, такие как DefaultPageSettings и PrinterSettings, описывающие способ печати, и вызывается Print метод для фактической печати документа. PrintDocument.Print Вызов метода вызывает PrintDocument.PrintPage событие , которое должно быть обработано для выполнения макета документа для печати.
Graphics Используйте свойство объекта, полученного PrintPageEventArgs из события , PrintDocument.PrintPage чтобы указать выходные данные для печати. При печати текстового файла используйте StreamReader для чтения одной строки за раз из потока и вызовите DrawString метод для рисования линии в графическом объекте. Дополнительные сведения об этом процессе см. в классах Graphics и StreamReader . Пример печати текстового документа можно просмотреть в PrintDocument разделе обзора класса.
Примечание
Методы DrawText класса TextRenderer не поддерживаются для печати. Вместо этого используйте DrawString методы Graphics класса .
При реализации в производном классе определяет PrintControllerPrintDocument способ печати . Метод PrintDocument.Print вызывает методы , , OnEndPrintOnStartPageи OnEndPage контроллера OnStartPrintпечати, которые, в свою очередь, сообщают принтеру, как печатать документ. Дополнительные сведения о печати диалоговых окон см. в разделах PrintDialog и PageSetupDialog.
В процессе предварительного просмотра печати используется специализированный контроллер печати, диалоговое окно и элемент управления. Пример такого контроллера печати и диалогового окна см. в PreviewPrintControllerразделе , PrintPreviewDialogи PrintPreviewControl.
Внимание!
Классы в System.Drawing.Printing пространстве имен не поддерживаются для использования в службе Windows или ASP.NET приложении или службе. Попытка использовать эти классы из одного из этих типов приложений может привести к непредвиденным проблемам, таким как снижение производительности службы и исключения во время выполнения.
Если вы хотите выполнить печать из приложения Windows Presentation Foundation (WPF), смSystem.Printing. пространство имен.
