PrintPageEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
PrintPage イベントのデータを提供します。
public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
- 継承
例
次のコード例では、 で Button 名前付き と PrintDocument というprintButton
名前pd
が作成Formされていることを前提としています。 のClickイベントButtonが メソッドにprintButton_Click
関連付けられていることを確認し、 のPrintPagePrintDocumentイベントが例の メソッドにpd_PrintPage
関連付けられていることを確認します。 この例の メソッドは printButton_Click
、 イベントを Print 発生させる メソッドを PrintPage 呼び出し、 メソッドで指定された .bmp ファイルを pd_PrintPage
出力します。 この例を実行するには、印刷するビットマップへのパスを変更します。
この例では、 System.Drawing、 System.Drawing.Printing、および System.Windows.Forms 名前空間を使用します。
private:
// Specifies what happens when the user clicks the Button.
void printButton_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
try
{
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;
}
// Specifies what happens when the user clicks the Button.
private void printButton_Click(object sender, EventArgs e)
{
try
{
// Assumes the default printer.
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;
}
' Specifies what happens when the user clicks the Button.
Private Sub printButton_Click(sender As Object, e As EventArgs) _
Handles printButton.Click
Try
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) _
Handles pd.PrintPage
' 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
注釈
注意
.NET 6 以降のバージョンでは、この種類を含む System.Drawing.Common パッケージは Windows オペレーティング システムでのみサポートされています。 クロスプラットフォーム アプリでこの型を使用すると、コンパイル時の警告と実行時の例外が発生します。 詳細については、「 Windows でのみサポートされる System.Drawing.Common」を参照してください。
プロパティは MarginBounds 、余白の間のページの部分を表す四角形の領域を取得します。 プロパティは PageBounds 、ページの合計領域を表す四角形の領域を取得します。 プロパティは Graphics 、描画を実行するグラフィックス オブジェクトを定義します。 プロパティは PageSettings 、現在のページのプリンター設定を取得します。 残りのプロパティは、印刷ジョブを取り消す必要があるかどうか、または印刷ジョブのページ数が多いかを示します。
Windows フォームでの印刷の詳細については、名前空間の概要に関するページをSystem.Drawing.Printing参照してください。 Windows Presentation Foundation アプリケーションから印刷する場合は、 名前空間をSystem.Printing参照してください。
コンストラクター
PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) |
PrintPageEventArgs クラスの新しいインスタンスを初期化します。 |
プロパティ
Cancel |
印刷ジョブをキャンセルするかどうかを示す値を取得または設定します。 |
Graphics |
ページの描画に使用される Graphics を取得します。 |
HasMorePages |
追加のページを印刷するかどうかを示す値を取得または設定します。 |
MarginBounds |
ページ余白の内側の部分を表す四角形領域を取得します。 |
PageBounds |
ページの全領域を表す四角形領域を取得します。 |
PageSettings |
現在のページのページ設定を取得します。 |
メソッド
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
GetHashCode() |
既定のハッシュ関数として機能します。 (継承元 Object) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
MemberwiseClone() |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
適用対象
こちらもご覧ください
.NET