Практическое руководство. Предварительный просмотр при печати в приложениях Windows Forms

Обновлен: Ноябрь 2007

Элемент управления PrintPreviewDialog используется для отображения документа до того, как он будет напечатан.

Для этого необходимо указать экземпляр класса PrintDocument, представляющий документ, который должен быть напечатан. Дополнительные сведения об использовании предварительного просмотра с компонентом PrintDocument см. в разделе Практическое руководство. Печать в Windows Forms с использованием предварительного просмотра.

Примечание.
Чтобы использовать элемент управления PrintPreviewDialog во время выполнения, пользователи должны иметь установленный на компьютере локальный или сетевой принтер, так как это отчасти необходимо для определения компонентом PrintPreviewDialog, как будет выглядеть документ при печати.

Элемент управления PrintPreviewDialog использует класс PrinterSettings. Кроме того, элемент управления PrintPreviewDialog использует класс PageSettings, так же как и компонент PrintPreviewDialog. Документ для печати, указанный в свойстве Document элемента управления PrintPreviewDialog, взаимодействует с экземплярами классов PrinterSettings и PageSettings, которые используются для отображения документа в окне предварительного просмотра.

Просмотр страниц с помощью элемента управления PrintPreviewDialog

• Используйте метод ShowDialog для отображения диалогового окна, указав используемый компонент PrintDocument.

  В следующем примере кода обработчик событий Click элемента управления Button открывает экземпляр элемента управления PrintPreviewDialog. Документ, который требуется распечатать, указан с помощью свойства Document. В приведенном ниже примере не указан документ, который требуется распечатать.

  В примере предполагается, что на форме существует элемент управления Button, компонент PrintDocument с именем myDocument и элемент управления PrintPreviewDialog.

  Private Sub Button1_Click(ByVal sender As System.Object, _
     ByVal e As System.EventArgs) Handles Button1.Click
     ' The print document 'myDocument' used below
     ' is merely for an example.
     ' You will have to specify your own print document.
     PrintPreviewDialog1.Document = myDocument
     PrintPreviewDialog1.ShowDialog()
  End Sub
  

  private void button1_Click(object sender, System.EventArgs e)
  {
     // The print document 'myDocument' used below
     // is merely for an example.
     // You will have to specify your own print document.
     printPreviewDialog1.Document = myDocument;
     printPreviewDialog1.ShowDialog();
  }
  

  private void button1_Click(Object sender, System.EventArgs e)
  {
     // The print document 'myDocument' used below
     // is merely for an example.
     // You will have to specify your own print document.
     printPreviewDialog1.set_Document(myDocument);
     printPreviewDialog1.ShowDialog();
  }
  

  private:
     void button1_Click(System::Object ^ sender,
        System::EventArgs ^ e)
     {
        // The print document 'myDocument' used below
        // is merely for an example.
        // You will have to specify your own print document.
        printPreviewDialog1->Document = myDocument;
        printPreviewDialog1->ShowDialog();
     }
  

  (Visual C#, Visual C++) Добавьте в конструктор формы следующий код, чтобы зарегистрировать обработчик событий.

  this.button1.Click += new System.EventHandler(this.button1_Click);
  

  this->button1->Click += gcnew
     System::EventHandler(this, &Form1::button1_Click);
  

См. также

Другие ресурсы

Компонент PrintDocument (Windows Forms)

Элемент управления PrintPreviewDialog (Windows Forms)

Поддержка печати в Windows Forms

Формы Windows Forms