Поделиться через

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

  • Статья

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

Компонент 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 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.set_Document(myDocument);
   // Sets the print document's color setting to false,
   // so that the page will not be printed in color.
   pageSetupDialog1.get_Document().get_DefaultPageSettings().set_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 J# и Visual C++) Добавьте в конструктор формы следующий код, чтобы зарегистрировать обработчик событий.

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

    this.button1.add_Click(new System.EventHandler(this.button1_Click));

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

См. также

Задачи

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

Ссылки

PageSetupDialog

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

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