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.GraphicsPublic Overrides Function OnStartPage (document As PrintDocument, e As PrintPageEventArgs) As Graphics參數
- document
- PrintDocument
PrintDocument代表正在列印的文件。
PrintPageEventArgs A 包含如何在文件中列印頁面的資料。 最初， Graphics 這個參數的性質會是 null。 方法回傳 OnStartPage(PrintDocument, PrintPageEventArgs) 的值將用於設定此屬性。
傳回
一個 Graphics 代表頁面的 PrintDocument物件。
例外狀況
原生的 Win32 應用程式介面（API）無法讓印表機驅動程式準備好接受資料。
-或-
原生 Windows API 無法利用指定資訊更新指定的印表機或繪圖機裝置上下文（DC）。
備註
OnStartPage在加PrintDocument碼前PrintPage立即被叫。
OnStartPrint 創造 Graphics 印刷所用的物件。 在 OnStartPrint 呼叫 後，該 OnStartPage 方法會將物件設定 Graphics 為單一頁面的圖形。 方法 OnEndPage 會清除 Graphics 物件，而方法 OnEndPrint 則釋放物件。
