Partilhar via

Como: Determinar propriedades de página usando o componente PageSetupDialog

  • Artigo

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

Você precisa especificar uma instância da classe PrintDocument — 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 é em parte assim que o componente PageSetupDialog determina as opções de formatação de página apresentadas ao usuário.

Um aspeto importante de trabalhar com o componente PageSetupDialog é como ele interage com a classe PageSettings. A classe PageSettings é 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 classe PageSettings. A classe PageSetupDialog modifica esses valores de propriedade para uma determinada instância da classe PageSettings que está associada ao documento (e é representada como uma propriedade DefaultPageSettings).

Para definir propriedades de página usando o componente PageSetupDialog

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

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

    O exemplo pressupõe que seu formulário tenha um controle Button, um componente PrintDocument chamado myDocumente um componente 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# 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);

Ver também