Share via


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) 未能使打印驱动程序就绪以接受数据。

- 或 -

本机 Windows API 未能使用指定信息更新指定的打印机或绘图仪的设备上下文 (DC)。

注解

OnStartPage在引发PrintPage事件之前PrintDocument立即调用 。

OnStartPrintGraphics创建打印中使用的 对象。 调用 后 OnStartPrintOnStartPage 方法将 Graphics 对象设置为单个页面的图形。 方法 OnEndPage 清除 Graphics 对象,而 OnEndPrint 方法解除分配 对象。

适用于

另请参阅