StandardPrintController.OnStartPage メソッド

.NET Framework クラス ライブラリ リファレンス

StandardPrintController.OnStartPage メソッド

ドキュメントのページを印刷する時点と印刷方法を決定する制御シーケンスを開始します。

名前空間: System.Drawing.Printing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Overrides Function
 OnStartPage ( _
    document As PrintDocument, _
    e As PrintPageEventArgs _
) As Graphics

Visual Basic (使用法)

Dim instance As StandardPrintController
Dim document As PrintDocument
Dim e As PrintPageEventArgs
Dim returnValue As Graphics

returnValue = instance.OnStartPage(document, e)

C#

public override Graphics OnStartPage (
    PrintDocument document,
    PrintPageEventArgs e
)

C++

public:
virtual Graphics^ OnStartPage (
    PrintDocument^ document, 
    PrintPageEventArgs^ e
) override

J#

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 メソッドはオブジェクトを解放します。

.NET Framework のセキュリティ

• PrintingPermission  (プリンタへのアクセスを制御するために必要なアクセス許可)。PrintingPermissionLevel (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
StandardPrintController クラス
StandardPrintController メンバ
System.Drawing.Printing 名前空間
OnEndPage
OnEndPrint
OnStartPrint
PrintPageEventArgs クラス