System.Drawing.Printing Пространство имен

Пространство имен System.Drawing.Printing обеспечивает службы, связанные с печатью, для приложений Windows Forms. The System.Drawing.Printing namespace provides print-related services for Windows Forms applications.

Классы

InvalidPrinterException

Представляет исключение, возникающее при попытке доступа к принтеру с использованием недопустимых параметров.Represents the exception that is thrown when you try to access a printer using printer settings that are not valid.

Margins

Задает размеры полей печатаемой страницы.Specifies the dimensions of the margins of a printed page.

MarginsConverter

Предоставляет MarginsConverter для Margins.Provides a MarginsConverter for Margins.

PageSettings

Задает параметры одной страницы, выводимой на печать.Specifies settings that apply to a single, printed page.

PaperSize

Задает размер бумажного листа.Specifies the size of a piece of paper.

PaperSource

Задает лоток, из которого принтер берет бумагу.Specifies the paper tray from which the printer gets paper.

PreviewPageInfo

Задает информацию для предварительного просмотра одной страницы.Specifies print preview information for a single page. Этот класс не наследуется.This class cannot be inherited.

PreviewPrintController

Задает контроллер печати, отображающий на экране документ в виде набора рисунков.Specifies a print controller that displays a document on a screen as a series of images.

PrintController

Управляет способами печати документов при осуществлении печати из приложения Windows Forms.Controls how a document is printed, when printing from a Windows Forms application.

PrintDocument

Определяет повторно используемый объект, который отправляет выходные данные на принтер при печати из приложения Windows Forms.Defines a reusable object that sends output to a printer, when printing from a Windows Forms application.

PrinterResolution

Представляет разрешение, поддерживаемое принтером.Represents the resolution supported by a printer.

PrinterSettings

Задает сведения о способе печати документа, включая принтер, выполняющий печать из приложения Windows Forms.Specifies information about how a document is printed, including the printer that prints it, when printing from a Windows Forms application.

PrinterSettings.PaperSizeCollection

Содержит коллекцию объектов PaperSize.Contains a collection of PaperSize objects.

PrinterSettings.PaperSourceCollection

Содержит коллекцию объектов PaperSource.Contains a collection of PaperSource objects.

PrinterSettings.PrinterResolutionCollection

Содержит коллекцию объектов PrinterResolution.Contains a collection of PrinterResolution objects.

PrinterSettings.StringCollection

Содержит коллекцию объектов String.Contains a collection of String objects.

PrinterUnitConvert

Задает набор методов преобразования, применяющихся при взаимодействии с интерфейсом печати Win32 API.Specifies a series of conversion methods that are useful when interoperating with the Win32 printing API. Этот класс не наследуется.This class cannot be inherited.

PrintEventArgs

Предоставляет данные для событий BeginPrint и EndPrint.Provides data for the BeginPrint and EndPrint events.

PrintingPermission

Управляет доступом к принтерам.Controls access to printers. Этот класс не наследуется.This class cannot be inherited.

PrintingPermissionAttribute

Разрешает декларативные проверки разрешений для печати.Allows declarative printing permission checks.

PrintPageEventArgs

Предоставляет данные для события PrintPage.Provides data for the PrintPage event.

QueryPageSettingsEventArgs

Предоставляет данные для события QueryPageSettings.Provides data for the QueryPageSettings event.

StandardPrintController

Задает контроллер печати, отправляющий данные на принтер.Specifies a print controller that sends information to a printer.

Перечисления

Duplex

Задает параметр двухсторонней печати.Specifies the printer's duplex setting.

PaperKind

Указывает стандартные форматы бумаги.Specifies the standard paper sizes.

PaperSourceKind

Стандартные источники бумаги.Standard paper sources.

PrintAction

Указывает тип выполняющейся операции печати.Specifies the type of print operation occurring.

PrinterResolutionKind

Задает разрешающую способность принтера.Specifies a printer resolution.

PrinterUnit

Задает несколько элементов измерения, используемых для печати.Specifies several of the units of measure used for printing.

PrintingPermissionLevel

Задает тип печати, разрешенной для выполнения кодом.Specifies the type of printing that code is allowed to do.

PrintRange

Задает выводимую на печать часть документа.Specifies the part of the document to print.

Делегаты

PrintEventHandler

Представляет метод, обрабатывающий событие BeginPrint или событие EndPrint из PrintDocument.Represents the method that will handle the BeginPrint or EndPrint event of a PrintDocument.

PrintPageEventHandler

Представляет метод, обрабатывающий событие PrintPage объекта PrintDocument.Represents the method that will handle the PrintPage event of a PrintDocument.

QueryPageSettingsEventHandler

Представляет метод, обрабатывающий событие QueryPageSettings PrintDocument.Represents the method that handles the QueryPageSettings event of a PrintDocument.

Комментарии

Обычно при печати из приложения Windows Forms, создается новый экземпляр класса PrintDocument класса, задайте свойства, такие как DefaultPageSettings и PrinterSettings, описывающие способы печати и вызова Print способ печати документ.Typically, when you print from a Windows Forms application, you create a new instance of the PrintDocument class, set properties, such as DefaultPageSettings and PrinterSettings, that describe how to print, and call the Print method to actually print the document. Вызов PrintDocument.Print вызывает метод PrintDocument.PrintPage событие, которое должно обрабатываться для выполнения макета документа для печати.Calling the PrintDocument.Print method raises the PrintDocument.PrintPage event, which should be handled to perform the document layout for printing.

Используйте Graphics свойство PrintPageEventArgs полученный из PrintDocument.PrintPage событием, чтобы указать вывести на печать.Use the Graphics property of the PrintPageEventArgs object obtained from the PrintDocument.PrintPage event to specify the output to print. При печати в текстовый файл, используйте StreamReader можно прочитать одной строке за раз из потока и вызова DrawString способ рисования линии в графический объект.If you are printing a text file, use StreamReader to read one line at a time from the stream and call the DrawString method to draw the line in the graphics object. Дополнительные сведения об этом процессе см. в разделе Graphics и StreamReader классы.For more information about this process, see the Graphics and StreamReader classes. Можно просмотреть пример печати текстового документа в PrintDocument класс обзорной статье.You can view an example of printing a text document in the PrintDocument class overview topic.

Примечание

DrawText Методы TextRenderer класса не поддерживаются для печати.The DrawText methods of the TextRenderer class are not supported for printing. Вместо этого используйте DrawString методы Graphics класса.Instead, use the DrawString methods of the Graphics class.

При реализации в производном классе, PrintController элементы управления как PrintDocument печати.When implemented in a derived class, the PrintController controls how a PrintDocument is printed. PrintDocument.Print Метод вызывает контроллер печати OnStartPrint, OnEndPrint, OnStartPage, и OnEndPage методы, которые в свою очередь указаний принтером печати документа.The PrintDocument.Print method invokes the print controller's OnStartPrint, OnEndPrint, OnStartPage, and OnEndPage methods, which in turn tell the printer how to print the document. Дополнительные сведения о печати диалоговым окнам см. в разделе PrintDialog и PageSetupDialog.For more information about printing dialog boxes, see PrintDialog and PageSetupDialog.

В процессе предварительного используется специализированный контроллер печати, диалоговое окно и управления.The print-preview process uses a specialized print controller, dialog box, and control. Пример контроллера печати и диалоговое окно, см. в разделе PreviewPrintController, PrintPreviewDialog, и PrintPreviewControl.For an example of such a print controller and dialog box, see PreviewPrintController, PrintPreviewDialog, and PrintPreviewControl.

Внимание!

Классы в System.Drawing.Printing пространства имен не поддерживаются для использования в службе Windows или приложения ASP.NET или службе.Classes within the System.Drawing.Printing namespace are not supported for use within a Windows service or ASP.NET application or service. Попытка использования этих классов из одного из этих типов приложений может привести к непредвиденным проблемам, например неодинаково службы исключения производительности и времени выполнения.Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Если вы хотите напечатать из приложения Windows Presentation Foundation (WPF), см. в разделе System.Printing пространства имен.If you want to print from a Windows Presentation Foundation (WPF) application, see the System.Printing namespace.

Дополнительно