PrintPageEventArgs PrintPageEventArgs PrintPageEventArgs PrintPageEventArgs Class

Определение

Предоставляет данные для события PrintPage.Provides data for the PrintPage event.

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

Примеры

В следующем примере кода предполагается Button , printButton что для PrintDocument Form. pd были созданы именованные и именованные.The following code example assumes a Button named printButton and a PrintDocument named pd have been created on a Form. Убедитесь, Click что событие PrintPage printButton_Click Button для события связано с методом, а событие объекта PrintDocument связано с pd_PrintPage методом в примере.Make sure the Click event for the Button is associated with the printButton_Click method and the PrintPage event of the PrintDocument is associated with the pd_PrintPage method in the example. Метод из примера Print вызывает метод, вызывающий PrintPage событие, и pd_PrintPage выводит файл. bmp, указанный в методе. printButton_ClickThe printButton_Click method from the example calls the Print method raising the PrintPage event, and prints the .bmp file specified in the pd_PrintPage method. Чтобы выполнить этот пример, измените путь к точечному рисунку, который нужно напечатать.To run this example, change the path to the bitmap you want to print.

Для этого примера System.Drawing.Printingиспользуйте пространства System.Windows.Forms имен ,и.System.DrawingUse the System.Drawing, System.Drawing.Printing, and System.Windows.Forms namespaces for this example.

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

Комментарии

MarginBounds Свойство получает прямоугольную область, представляющую часть страницы между полями.The MarginBounds property retrieves the rectangular area that represents the portion of the page between the margins. PageBounds Свойство получает прямоугольную область, представляющую общую область страницы.The PageBounds property retrieves the rectangular area that represents the total area of the page. Graphics Свойство определяет графический объект, с которым выполняется рисование.The Graphics property defines the graphics object with which to do the painting. PageSettings Свойство получает параметры принтера для текущей страницы.The PageSettings property retrieves the printer settings for the current page. Остальные свойства указывают, следует ли отменить задание печати или наличие большего количества страниц в задании печати.The remaining properties indicate whether a print job should be canceled or whether a print job has more pages.

Дополнительные сведения о печати с помощью Windows Forms см. в System.Drawing.Printing разделе Общие сведения о пространстве имен.For more information about printing with Windows Forms, see the System.Drawing.Printing namespace overview. Если вы хотите выполнить печать из Windows Presentation Foundation приложения, см. раздел System.Printing пространство имен.If you wish to print from a Windows Presentation Foundation application, see the System.Printing namespace.

Конструкторы

PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings) PrintPageEventArgs(Graphics, Rectangle, Rectangle, PageSettings)

Инициализирует новый экземпляр класса PrintPageEventArgs.Initializes a new instance of the PrintPageEventArgs class.

Свойства

Cancel Cancel Cancel Cancel

Получает или задает значение, показывающее, нужно ли отменить задание для принтера.Gets or sets a value indicating whether the print job should be canceled.

Graphics Graphics Graphics Graphics

Получает Graphics, используемый для рисования страницы.Gets the Graphics used to paint the page.

HasMorePages HasMorePages HasMorePages HasMorePages

Получает или задает значение, показывающее, нужно ли выводить на печать дополнительную страницу.Gets or sets a value indicating whether an additional page should be printed.

MarginBounds MarginBounds MarginBounds MarginBounds

Получает прямоугольную область, представляющую находящуюся внутри полей часть страницы.Gets the rectangular area that represents the portion of the page inside the margins.

PageBounds PageBounds PageBounds PageBounds

Получает прямоугольную область, представляющую полную площадь страницы.Gets the rectangular area that represents the total area of the page.

PageSettings PageSettings PageSettings PageSettings

Получает параметры текущей страницы.Gets the page settings for the current page.

Методы

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Inherited from Object)

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

Дополнительно