ドキュメントのページを印刷する時点と印刷方法を決定する制御シーケンスを開始します。
Overrides Public Function OnStartPage( _
ByVal document As PrintDocument, _ ByVal e As PrintPageEventArgs _) As Graphics
[C#]
public override Graphics OnStartPage(PrintDocumentdocument,PrintPageEventArgse);
[C++]
public: Graphics* OnStartPage(PrintDocument* document,PrintPageEventArgs* e);
[JScript]
public override function OnStartPage(
document : PrintDocument,e : PrintPageEventArgs) : Graphics;
パラメータ
- document
印刷中のドキュメントを表す PrintDocument 。 - e
ドキュメントのページの印刷方法についてのデータを格納する PrintPageEventArgs 。初期の状態では、このパラメータの PrintPageEventArgs.Graphics プロパティは null 参照 (Visual Basic では Nothing) です。 OnStartPage メソッドによって返された値は、このプロパティを設定するために使用されます。
戻り値
PrintDocument からのページを表す Graphics オブジェクト。
例外
| 例外の種類 | 条件 |
|---|---|
| Win32Exception | ネイティブの Win32 アプリケーション プログラミング インターフェイス (API) が、データを受け入れるプリンタ ドライバを準備できませんでした。
または ネイティブの Win32 API が、指定されたプリンタまたはプロッタのデバイス コンテキスト (DC) を、指定された情報で更新できませんでした。 |
解説
OnStartPage は、 PrintDocument が PrintPage イベントを発生させる直前に呼び出されます。
OnStartPrint は、印刷で使用される Graphics オブジェクトを作成します。 OnStartPrint が呼び出された後で、 OnStartPage メソッドは、 Graphics オブジェクトを単一ページのグラフィックに設定します。 OnEndPage メソッドは Graphics オブジェクトを消去します。 OnEndPrint メソッドはオブジェクトを解放します。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
参照
StandardPrintController クラス | StandardPrintController メンバ | System.Drawing.Printing 名前空間 | OnEndPage | OnEndPrint | OnStartPrint | PrintPageEventArgs