PrintPageEventArgs 类

定义

命名空间:

System.Drawing.Printing

程序集:

System.Drawing.Common.dll

包:

System.Drawing.Common v8.0.0

Source:

PrintPageEventArgs.cs

为 PrintPage 事件提供数据。

public ref class PrintPageEventArgs : EventArgs

public class PrintPageEventArgs : EventArgs

type PrintPageEventArgs = class
    inherit EventArgs

Public Class PrintPageEventArgs
Inherits EventArgs

继承

Object

EventArgs

PrintPageEventArgs

示例

下面的代码示例假定Button已在 上创建了一个PrintDocument命名printButton和一个Form命名pd的 。 确保 Click 的事件 Button 与 printButton_Click 方法相关联， PrintPage 并且 的 PrintDocument 事件与 pd_PrintPage 示例中的 方法相关联。 printButton_Click示例中的 方法调用Print引发 PrintPage 事件的方法，并打印 方法中指定的 pd_PrintPage .bmp 文件。 若要运行此示例，请更改要打印的位图的路径。

对于此示例， 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)

另请参阅

• Graphics
• Rectangle
• PrintEventArgs