PrintPageEventArgs Класс

Определение

Предоставляет данные о событии PrintPage.

public ref class PrintPageEventArgs : EventArgs
public class PrintPageEventArgs : EventArgs
type PrintPageEventArgs = class
    inherit EventArgs
Public Class PrintPageEventArgs
Inherits EventArgs
Наследование
PrintPageEventArgs

Примеры

В следующем примере кода предполагаетсяButton, что в объекте Formсоздано именованное имя printButton и PrintDocument именованное имяpd. Убедитесь, Click что событие для Button метода связано с методом, а PrintPage событие PrintDocument связано с printButton_Clickpd_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)

Применяется к

См. также раздел