PrintPageEventArgs

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

PrintPageEventArgs クラス

PrintPage イベントのデータを提供します。

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

Visual Basic (宣言)

Public Class PrintPageEventArgs
    Inherits EventArgs

Visual Basic (使用法)

Dim instance As PrintPageEventArgs

C#

public class PrintPageEventArgs : EventArgs

C++

public ref class PrintPageEventArgs : public
 EventArgs

J#

public class PrintPageEventArgs extends EventArgs

JScript

public class PrintPageEventArgs extends
 EventArgs

解説

MarginBounds プロパティは、ページ余白どうしの間の部分を表す四角形領域を取得します。PageBounds プロパティは、ページの全領域を表す四角形領域を取得します。Graphics プロパティは、描画に使用するグラフィックス オブジェクトを定義します。PageSettings プロパティは、現在のページのプリンタ設定を取得します。その他のプロパティは、印刷ジョブをキャンセルするかどうか、または印刷ジョブに追加のページがあるかどうかを示します。

印刷の詳細については、System.Drawing.Printing 名前空間のトピックを参照してください。

使用例

次のコード例は、Form 上に Button が作成されていることを前提にしています。例中の printButton_Click メソッドは、PrintDocument クラスのインスタンスを作成し、pd_PrintPage メソッドを呼び出し、pd_PrintPage メソッドで指定されている .bmp ファイルを出力します。この例を実行するには、印刷するビットマップにパスを変更します。

この例では、System.ComponentModel、System.Collections、System.Drawing、System.Drawing.Printing、System.Resources、System.Windows.Forms の各名前空間を使用します。

Visual Basic

' Specifies what happens when the user clicks the Button.
Private Sub printButton_Click(sender As
 Object, e As EventArgs)
    Try
        ' Assumes the default printer.
        Dim pd As New PrintDocument()
        AddHandler pd.PrintPage, AddressOf
 Me.pd_PrintPage
        pd.Print()
    Catch ex As Exception
        MessageBox.Show("An error occurred while printing",
 _
            ex.ToString())
    End Try
End Sub    

' Specifies what happens when the PrintPage event is raised.
Private Sub pd_PrintPage(sender As
 Object, ev As PrintPageEventArgs)
    ' Draw a picture.
    ev.Graphics.DrawImage(Image.FromFile("C:\My Folder\MyFile.bmp"),
 _
        ev.Graphics.VisibleClipBounds)
    
    ' Indicate that this is the last page to print.
    ev.HasMorePages = False
End Sub

C#

// Specifies what happens when the user clicks the Button.
 private void printButton_Click(object sender,
 EventArgs e) 
 {
   try 
   {
     // Assumes the default printer.
     PrintDocument pd = new PrintDocument();
     pd.PrintPage += new PrintPageEventHandler(this.pd_PrintPage);
     pd.Print();
   }  
   catch(Exception ex) 
   {
     MessageBox.Show("An error occurred while printing",
 ex.ToString());
   }
 }
 
 // Specifies what happens when the PrintPage event is raised.
 private void pd_PrintPage(object sender, PrintPageEventArgs
 ev) 
 {      
   // Draw a picture.
   ev.Graphics.DrawImage(Image.FromFile("C:\\My Folder\\MyFile.bmp"), ev.Graphics.VisibleClipBounds);
      
   // Indicate that this is the last page to print.
   ev.HasMorePages = false;
 }
 

C++

private:
   // Specifies what happens when the user clicks the Button.
   void printButton_Click( Object^ /*sender*/, EventArgs^ /*e*/
 )
   {
      try
      {
         // Assumes the default printer.
         PrintDocument^ pd = gcnew PrintDocument;
         pd->PrintPage += gcnew PrintPageEventHandler( this,
 &Form1::pd_PrintPage );
         pd->Print();
      }
      catch ( Exception^ ex ) 
      {
         MessageBox::Show( "An error occurred while printing",
 ex->ToString() );
      }
   }

   // Specifies what happens when the PrintPage event is raised.
   void pd_PrintPage( Object^ /*sender*/, PrintPageEventArgs^
 ev )
   {
      // Draw a picture.
      ev->Graphics->DrawImage( Image::FromFile( "C:\\My Folder\\MyFile.bmp"
 ),
         ev->Graphics->VisibleClipBounds );
      
      // Indicate that this is the last page to print.
      ev->HasMorePages = false;
   }

J#

// Specifies what happens when the user clicks the Button.
private void printButton_Click(Object sender,
 EventArgs e)
{
    try {
        // Assumes the default printer.
        PrintDocument pd = new PrintDocument();
        pd.add_PrintPage(new PrintPageEventHandler(this.pd_PrintPage));
        pd.Print();
    }
    catch (System.Exception ex) {
        MessageBox.Show("An error occurred while printing",
 ex.ToString());
    }
} //printButton_Click

// Specifies what happens when the PrintPage event is raised.
private void pd_PrintPage(Object sender, PrintPageEventArgs
 ev)
{
    // Draw a picture.
    ev.get_Graphics().DrawImage(Image.FromFile
        ("C:\\My Folder\\MyFile.bmp"),
        ev.get_Graphics().get_VisibleClipBounds());

    // Indicate that this is the last page to print.
    ev.set_HasMorePages(false);
} //pd_PrintPage

継承階層

System.Object
   System.EventArgs
    System.Drawing.Printing.PrintPageEventArgs

スレッド セーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッド セーフです。インスタンス メンバの場合は、スレッド セーフであるとは限りません。

プラットフォーム

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

参照

関連項目
PrintPageEventArgs メンバ
System.Drawing.Printing 名前空間
Graphics クラス
Rectangle 構造体
PrintEventArgs クラス

PrintPageEventArgs コンストラクタ

PrintPageEventArgs クラスの新しいインスタンスを初期化します。

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

Visual Basic (宣言)

Public Sub New ( _
    graphics As Graphics, _
    marginBounds As Rectangle, _
    pageBounds As Rectangle, _
    pageSettings As PageSettings _
)

Visual Basic (使用法)

Dim graphics As Graphics
Dim marginBounds As Rectangle
Dim pageBounds As Rectangle
Dim pageSettings As PageSettings

Dim instance As New PrintPageEventArgs(graphics,
 marginBounds, pageBounds, pageSettings)

C#

public PrintPageEventArgs (
    Graphics graphics,
    Rectangle marginBounds,
    Rectangle pageBounds,
    PageSettings pageSettings
)

C++

public:
PrintPageEventArgs (
    Graphics^ graphics, 
    Rectangle marginBounds, 
    Rectangle pageBounds, 
    PageSettings^ pageSettings
)

J#

public PrintPageEventArgs (
    Graphics graphics, 
    Rectangle marginBounds, 
    Rectangle pageBounds, 
    PageSettings pageSettings
)

JScript

public function PrintPageEventArgs (
    graphics : Graphics, 
    marginBounds : Rectangle, 
    pageBounds : Rectangle, 
    pageSettings : PageSettings
)

パラメータ

graphics

項目の描画に使用される Graphics。

marginBounds

余白と余白の間の領域。

pageBounds

用紙の全領域。

pageSettings

ページの PageSettings。

プラットフォーム

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

参照

関連項目
PrintPageEventArgs クラス
PrintPageEventArgs メンバ
System.Drawing.Printing 名前空間
Graphics クラス
Rectangle 構造体

PrintPageEventArgs プロパティ

パブリック プロパティ

	名前	説明
	Cancel	印刷ジョブをキャンセルするかどうかを示す値を取得または設定します。
	Graphics	ページの描画に使用される Graphics を取得します。
	HasMorePages	追加のページを印刷するかどうかを示す値を取得または設定します。
	MarginBounds	ページ余白の内側の部分を表す四角形領域を取得します。
	PageBounds	ページの全領域を表す四角形領域を取得します。
	PageSettings	現在のページのページ設定を取得します。

参照

関連項目

PrintPageEventArgs クラス
System.Drawing.Printing 名前空間
Graphics クラス
Rectangle 構造体
PrintEventArgs クラス

PrintPageEventArgs メソッド

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 ( Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 ( Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 ( Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 ( Object から継承されます。)

参照

関連項目

PrintPageEventArgs クラス
System.Drawing.Printing 名前空間
Graphics クラス
Rectangle 構造体
PrintEventArgs クラス

PrintPageEventArgs メンバ

PrintPage イベントのデータを提供します。

PrintPageEventArgs データ型で公開されるメンバを以下の表に示します。

パブリック コンストラクタ

	名前	説明
	PrintPageEventArgs	PrintPageEventArgs クラスの新しいインスタンスを初期化します。

パブリック プロパティ

	名前	説明
	Cancel	印刷ジョブをキャンセルするかどうかを示す値を取得または設定します。
	Graphics	ページの描画に使用される Graphics を取得します。
	HasMorePages	追加のページを印刷するかどうかを示す値を取得または設定します。
	MarginBounds	ページ余白の内側の部分を表す四角形領域を取得します。
	PageBounds	ページの全領域を表す四角形領域を取得します。
	PageSettings	現在のページのページ設定を取得します。

パブリック メソッド

( プロテクト メソッド も参照)

	名前	説明
	Equals	オーバーロードされます。 2 つの Object インスタンスが等しいかどうかを判断します。 (Object から継承されます。)
	GetHashCode	特定の型のハッシュ関数として機能します。GetHashCode は、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造での使用に適しています。 (Object から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

プロテクト メソッド

	名前	説明
	Finalize	Object がガベージ コレクションにより収集される前に、その Object がリソースを解放し、その他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
	MemberwiseClone	現在の Object の簡易コピーを作成します。 (Object から継承されます。)

参照

関連項目

PrintPageEventArgs クラス
System.Drawing.Printing 名前空間
Graphics クラス
Rectangle 構造体
PrintEventArgs クラス