PrintPageEventArgs Класс

Определение

Пространство имен:

System.Drawing.Printing

Сборка:

System.Drawing.Common.dll

Пакет:

System.Drawing.Common v8.0.0

Исходный код:

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 что именованные printButton и PrintDocument именованные pd были созданы в Form. Убедитесь, Click что событие для Button связано с методом printButton_Click , а PrintPage событие PrintDocument объекта — с методом pd_PrintPage в примере. Метод printButton_Click из примера вызывает метод, вызывающий PrintPrintPage событие, и выводит .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. Использование этого типа в кроссплатформенных приложениях вызывает предупреждения во время компиляции и исключения во время выполнения. Дополнительные сведения см . в статье System.Drawing.Common, поддерживаемая только в Windows.

Свойство MarginBounds извлекает прямоугольную область, представляющую часть страницы между полями. Свойство PageBounds извлекает прямоугольную область, представляющую общую область страницы. Свойство Graphics определяет графический объект, с помощью которого выполняется рисование. Свойство PageSettings извлекает параметры принтера для текущей страницы. Остальные свойства указывают, следует ли отменить задание печати или у задания печати больше страниц.

Дополнительные сведения о печати с помощью Windows Forms см. в обзоре 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