StandardPrintController.OnStartPage(PrintDocument, PrintPageEventArgs) 方法

定義

命名空間:

System.Drawing.Printing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

DefaultPrintController.cs

開始可決定何時以及如何在文件中列印頁面的控制順序。

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

Graphics 物件，表示 PrintDocument 的頁面。

例外狀況

Win32Exception

原生 Win32 應用程式開發介面 (API) 無法準備印表機驅動程式以接收資料。

-或-

原生 Windows API 無法使用指定的資訊來更新指定的印表機或繪圖機裝置內容 (DC)。

備註

OnStartPage會在引發 PrintPage 事件之前PrintDocument立即呼叫 。

OnStartPrint 會 Graphics 建立列印中使用的物件。 呼叫 之後 OnStartPrint ，方法會將 OnStartPageGraphics 物件設定為單一頁面的圖形。 方法 OnEndPage 會 Graphics 清除 物件，而 OnEndPrint 方法會解除分配 物件。

另請參閱

• OnEndPage(PrintDocument, PrintPageEventArgs)
• OnEndPrint(PrintDocument, PrintEventArgs)
• OnStartPrint(PrintDocument, PrintEventArgs)
• PrintPageEventArgs