Partilhar via

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

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 Button do controle Click 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

  • Last updated on