Freigeben über

Vorgehensweise: Ermitteln von Seiteneigenschaften mithilfe der PageSetupDialog-Komponente

Mithilfe der PageSetupDialog -Komponente können Benutzer das Layout, die Papiergröße und weitere Optionen für das Seitenlayout festlegen.

Sie müssen eine Instanz der PrintDocument-Klasse angeben– dies ist das zu druckende Dokument. Darüber hinaus müssen die Benutzer einen Drucker auf ihrem Computer installiert haben, entweder lokal oder über ein Netzwerk, da die PageSetupDialog-Komponente teilweise darüber entscheidet, welche Optionen zur Seitenformatierung dem Benutzer präsentiert werden.

Ein wichtiger Aspekt an der Arbeit mit der PageSetupDialog-Komponente ist ihre Interaktionsweise mit der PageSettings-Klasse. Die PageSettings Klasse wird verwendet, um Einstellungen anzugeben, mit denen die Art und Weise geändert wird, wie eine Seite gedruckt wird, z. B. Papierausrichtung, Größe der Seite und Ränder. Jede dieser Einstellungen wird als Eigenschaft der PageSettings-Klasse dargestellt. Die PageSetupDialog Klasse ändert diese Eigenschaftswerte für eine bestimmte Instanz der PageSettings Klasse, die dem Dokument zugeordnet ist (und wird als DefaultPageSettings Eigenschaft dargestellt).

So legen Sie Seiteneigenschaften mithilfe der PageSetupDialog-Komponente fest

  1. Verwenden Sie die ShowDialog-Methode, um das Dialogfeld anzuzeigen, und geben Sie das zu verwendende PrintDocument an.

    Im folgenden Beispiel öffnet der Button-Ereignishandler des Click-Steuerelements eine Instanz der PageSetupDialog-Komponente. Ein vorhandenes Dokument wird in der eigenschaft Document angegeben, und seine PageSettings.Color-Eigenschaft wird auf falsefestgelegt.

    In diesem Beispiel wird angenommen, dass Ihr Formular über ein Button-Steuerelement, eine PrintDocument-Komponente namens myDocument und eine PageSetupDialog-Komponente verfügt.

    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# und Visual C++) Platzieren Sie den folgenden Code im Konstruktor des Formulars, um den Ereignishandler zu registrieren.

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

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

Siehe auch

  • Last updated on