Como determinar propriedades de página usando o componente PageSetupDialog

  • Artigo

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

Você precisa especificar uma instância da PrintDocument classe — este é o documento a ser impresso. Além disso, os usuários devem ter uma impressora instalada em seu computador, localmente ou por meio de uma rede, pois é em parte como o PageSetupDialog componente determina as opções de formatação de página apresentadas ao usuário.

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

Para determinar propriedades de página usando o componente PageSetupDialog

  1. Use o método para exibir a caixa de diálogo, especificando o ShowDialogPrintDocument a ser usado.

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

    O exemplo pressupõe que seu formulário tenha um controle, um componente chamado myDocumente um PageSetupDialogButtonPrintDocument 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 código a seguir 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);

Confira também