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は、PrintDocument イベントPrintPage発生する直前に呼び出されます。

OnStartPrint は、印刷に使用される Graphics オブジェクトを作成します。 OnStartPrintが呼び出されると、OnStartPage メソッドは、Graphics オブジェクトを 1 つのページのグラフィックに設定します。 OnEndPage メソッドはGraphics オブジェクトをクリアしますが、OnEndPrint メソッドはオブジェクトの割り当てを解除します。

適用対象

こちらもご覧ください