Como: Determinar as propriedades da página usando o componente PageSetupDialog

O PageSetupDialog componente apresenta o layout, o tamanho do papel e outras opções de layout de página para o usuário para um documento.

Você precisa especificar uma instância do PrintDocument classe — este é o documento a ser impresso. Além disso, os usuários devem ter uma impressora instalada em seu computador, localmente ou através de uma rede, pois esta é parcialmente como o PageSetupDialog componente determina a página de formatação apresentadas ao usuário.

Um aspecto importante de trabalhar com o PageSetupDialog componente é como ele interage com o PageSettings classe. O PageSettings classe é usada para especificar as configurações que modificam a maneira como uma página será impresso, como a orientação do papel, o tamanho da página e as margens. Cada uma dessas configurações é representada como uma propriedade de PageSettings classe. O PageSetupDialog classe modifica esses valores de propriedade para uma determinada instância da PageSettings classe que está associado ao documento (e é representado como um DefaultPageSettings propriedade).

Para definir propriedades de página usando o componente PageSetupDialog

• Use o ShowDialog método para exibir a caixa de diálogo, especificando a PrintDocument para uso.

  No exemplo abaixo, o Button do controle Click manipulador de eventos abre uma instância da PageSetupDialog componente. Um documento existente é especificado na Document propriedade e seu PageSettings.Color for definida como false.

  O exemplo supõe que o formulário tem um Button o controle, uma PrintDocument componente denominado myDocumente um PageSetupDialog componente.

  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# e Visual C++) coloque o seguinte código no construtor do formulário para registrar o manipulador de eventos.

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

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

Consulte também

Tarefas

Como: Criar trabalhos de impressão padrão do Windows Forms

Referência

PageSetupDialog

Outros recursos

PageSetupDialog Component (Windows Forms)