Compartilhar via

Como determinar propriedades de página usando o componente PageSetupDialog

O componente PageSetupDialog apresenta layout, 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 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 forma como uma página será impressa, como orientação de 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 associada ao documento (e é representada como uma DefaultPageSettings propriedade).

Para definir propriedades de página usando o componente PageSetupDialog

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

    No exemplo abaixo, o manipulador de eventos do controle Button abre uma instância do componente Click. 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 Button controle, um PrintDocument componente chamado 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 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);

Consulte também

  • Last updated on