Практическое руководство. Определение свойств страницы с помощью компонента PageSetupDialog

Компонент PageSetupDialog предоставляет пользователю возможность выбрать макет, размер бумаги и другие параметры страницы документа.

Необходимо указать экземпляр класса PrintDocument; это документ, который должен быть напечатан. Помимо этого, на компьютере должен быть установлен принтер — либо локально, либо по сети, — поскольку от этого частично зависит, как компонент PageSetupDialog определяет параметры форматирования страницы, предоставляемые пользователю.

Важный аспект работы с компонентом PageSetupDialog — способ взаимодействия с классом PageSettings. Класс PageSettings используется для определения параметров, которые влияют на способ печати страницы, например на ориентацию, размер страницы и поля. Каждый из этих параметров определяется свойством класса PageSettings. Класс PageSetupDialog изменяет значения свойств для заданного экземпляра класса PageSettings, который связан с документом (и представлен в виде свойства DefaultPageSettings).

Задание свойств страницы с помощью компонента PageSetupDialog

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

  В приведенном ниже примере обработчик событий Click элемента управления Button открывает экземпляр элемента управления PageSetupDialog. Текущий документ определен свойством Document, а свойство PageSettings.Color этого документа имеет значение false.

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

  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.
     PageSetupDialog1.Document = myDocument
     ' Sets the print document's color setting to false,
     ' so that the page will not be printed in color.
     PageSetupDialog1.Document.DefaultPageSettings.Color = False
     PageSetupDialog1.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.
     pageSetupDialog1.Document = myDocument;
     // Sets the print document's color setting to false,
     // so that the page will not be printed in color.
     pageSetupDialog1.Document.DefaultPageSettings.Color = false;
     pageSetupDialog1.ShowDialog();
  }
  

  private:
     System::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.
        pageSetupDialog1->Document = myDocument;
        // Sets the print document's color setting to false,
        // so that the page will not be printed in color.
        pageSetupDialog1->Document->DefaultPageSettings->Color = false;
        pageSetupDialog1->ShowDialog();
     }
  

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

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

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

См. также

Задачи

Практическое руководство. Создание стандартных задания печати в Windows Forms

Ссылки

PageSetupDialog

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

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