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は、PrintDocument イベントPrintPage発生する直前に呼び出されます。
OnStartPrint は、印刷に使用される Graphics オブジェクトを作成します。 OnStartPrintが呼び出されると、OnStartPage メソッドは、Graphics オブジェクトを 1 つのページのグラフィックに設定します。 OnEndPage メソッドはGraphics オブジェクトをクリアしますが、OnEndPrint メソッドはオブジェクトの割り当てを解除します。