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.Graphics
Public Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As Graphics

Параметры

document
PrintDocument

Класс PrintDocument, представляющий напечатанный документ.

e
PrintPageEventArgs

Класс PrintPageEventArgs, содержащий сведения о способе печати страницы документа. Сначала свойство Graphics этого параметра равно null. Свойству присваивается значение, возвращенное методом OnStartPage(PrintDocument, PrintPageEventArgs).

Возвращаемое значение

Объект Graphics, представляющий страницу из PrintDocument.

Исключения

Драйвер принтера не может быть подготовлен машинным интерфейсом Win32 API к приему данных.

-или-

В собственном API Windows нельзя обновить контекст устройства для принтера или плоттера, используя указанные данные.

Комментарии

OnStartPage вызывается непосредственно перед тем, как PrintDocumentPrintPage вызывает событие .

OnStartPrint создает объект , используемый Graphics при печати. После OnStartPrint вызова OnStartPage метод задает Graphics объект в виде рисунка одной страницы. Метод OnEndPage очищает Graphics объект , а OnEndPrint метод освобождает объект.

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

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