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


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

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

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

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

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

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

    В следующем примере обработчик событий Button элемента управления Click открывает экземпляр компонента 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);  
    

См. также