StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
开始控制序列,确定何时以及如何打印文档页。
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,它表示所打印的文档。
PrintPageEventArgs,它包含有关如何打印文档中某页的数据。 最初,该参数的 Graphics 属性将为 null
。 由 OnStartPage(PrintDocument, PrintPageEventArgs) 方法所返回的值将用于设置该属性。
返回
Graphics 对象,它表示 PrintDocument 中的一页。
例外
本地的 Win32 应用程序编程接口 (API) 未能使打印驱动程序就绪以接受数据。
- 或 -
本机 Windows API 未能使用指定信息更新指定的打印机或绘图仪的设备上下文 (DC)。
注解
OnStartPage在引发PrintPage事件之前PrintDocument立即调用 。
OnStartPrintGraphics创建打印中使用的 对象。 调用 后 OnStartPrint , OnStartPage 方法将 Graphics 对象设置为单个页面的图形。 方法 OnEndPage 清除 Graphics 对象,而 OnEndPrint 方法解除分配 对象。