StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Начинает набор команд управления, определяющих время и способ вывода на печать страницы документа.
public:
override System::Drawing::Graphics ^ OnStartPage(System::Drawing::Printing::PrintDocument ^ document, System::Drawing::Printing::PrintPageEventArgs ^ e);public override System.Drawing.Graphics OnStartPage (System.Drawing.Printing.PrintDocument document, System.Drawing.Printing.PrintPageEventArgs e);override this.OnStartPage : System.Drawing.Printing.PrintDocument * System.Drawing.Printing.PrintPageEventArgs -> System.Drawing.GraphicsPublic Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As GraphicsПараметры
- document
- PrintDocument
Класс PrintDocument, представляющий напечатанный документ.
Класс PrintPageEventArgs, содержащий сведения о способе печати страницы документа. Сначала свойство Graphics этого параметра равно null. Свойству присваивается значение, возвращенное методом OnStartPage(PrintDocument, PrintPageEventArgs).
Возвращаемое значение
Объект Graphics, представляющий страницу из PrintDocument.
Исключения
Драйвер принтера не может быть подготовлен машинным интерфейсом Win32 API к приему данных.
-или-
В собственном API Windows нельзя обновить контекст устройства для принтера или плоттера, используя указанные данные.
Комментарии
OnStartPage вызывается непосредственно перед тем, как PrintDocumentPrintPage вызывает событие .
OnStartPrint создает объект , используемый Graphics при печати. После OnStartPrint вызова OnStartPage метод задает Graphics объект в виде рисунка одной страницы. Метод OnEndPage очищает Graphics объект , а OnEndPrint метод освобождает объект.
