StandardPrintController.OnStartPrint メソッド

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

StandardPrintController.OnStartPrint メソッド

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

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

Visual Basic (宣言)

Public Overrides Sub OnStartPrint
 ( _
    document As PrintDocument, _
    e As PrintEventArgs _
)

Visual Basic (使用法)

Dim instance As StandardPrintController
Dim document As PrintDocument
Dim e As PrintEventArgs

instance.OnStartPrint(document, e)

C#

public override void OnStartPrint (
    PrintDocument document,
    PrintEventArgs e
)

C++

public:
virtual void OnStartPrint (
    PrintDocument^ document, 
    PrintEventArgs^ e
) override

J#

public void OnStartPrint (
    PrintDocument document, 
    PrintEventArgs e
)

JScript

public override function OnStartPrint (
    document : PrintDocument, 
    e : PrintEventArgs
)

パラメータ

document

印刷中のドキュメントを表す PrintDocument。

e

ドキュメントの印刷方法についてのデータを格納する PrintEventArgs。

例外

例外の種類	条件
InvalidPrinterException	プリンタ設定が無効です。
Win32Exception	ネイティブの Win32 アプリケーション プログラミング インターフェイス (API) が、印刷ジョブを開始できませんでした。

解説

OnStartPrint は、PrintDocument が BeginPrint イベントを発生させた直後に呼び出されます。

OnStartPrint は、印刷で使用される Graphics オブジェクトを作成します。OnStartPrint が呼び出された後で、OnStartPage メソッドは、Graphics オブジェクトを単一ページのグラフィックに設定します。OnEndPage メソッドは Graphics オブジェクトを消去します。OnEndPrint メソッドはオブジェクトを解放します。

OnStartPrint は、印刷設定が有効であることを確認します。

.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
OnStartPage
PrinterSettings クラス
PrintEventArgs クラス