Gewusst wie: Bestimmen von Seiteneigenschaften mit der PageSetupDialog-Komponente

  • Artikel

Aktualisiert: November 2007

Die PageSetupDialog-Komponente stellt dem Benutzer Layout-, Papierformat- und andere Seitenlayoutoptionen für ein Dokument zur Verfügung.

Sie müssen eine Instanz der PrintDocument-Klasse angeben. Dabei handelt es sich um das Dokument, das gedruckt werden soll. Darüber hinaus muss auf dem Computer des Benutzers lokal oder über ein Netzwerk ein Drucker installiert sein, da die PageSetupDialog-Komponente die für den Benutzer verfügbaren Seitenformatierungsoptionen teilweise von diesem Drucker übernimmt.

Ein wichtiger Aspekt bei der Verwendung der PageSetupDialog-Komponente ist deren Interaktion mit der PageSettings-Klasse. Die PageSettings-Klasse wird dazu verwendet, die Druckeinstellungen für eine Seite festzulegen, z. B. Papierausrichtung, Seitengröße und Seitenränder. Alle diese Einstellungen werden als Eigenschaft der PageSettings-Klasse dargestellt. Von der PageSetupDialog-Klasse werden diese Eigenschaftenwerte für eine bestimmte Instanz der PageSettings-Klasse geändert, die mit dem Dokument verknüpft ist (und als DefaultPageSettings-Eigenschaft dargestellt wird).

So legen Sie die Eigenschaften einer Seite mit der PageSetupDialog-Komponente fest

  • Verwenden Sie die ShowDialog-Methode zum Anzeigen des Dialogfelds, und geben Sie dabei die zu verwendende PrintDocument-Komponente an.

    Im folgenden Beispiel wird vom Click-Ereignishandler des Button-Steuerelements eine Instanz der PageSetupDialog-Komponente geöffnet. In der Document-Eigenschaft wird ein vorhandenes Dokument angegeben, dessen PageSettings.Color-Eigenschaft auf false festgelegt ist.

    In diesem Beispiel wird davon ausgegangen, dass das Formular über ein Button-Steuerelement, eine PrintDocument-Komponente mit dem Namen 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 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.set_Document(myDocument);
   // Sets the print document's color setting to false,
   // so that the page will not be printed in color.
   pageSetupDialog1.get_Document().get_DefaultPageSettings().set_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#, Visual J# und Visual C++) Fügen Sie den folgenden Code im Konstruktor des Formulars ein, um den Ereignishandler zu registrieren.

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

    this.button1.add_Click(new System.EventHandler(this.button1_Click));

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

Siehe auch

Aufgaben

Gewusst wie: Erstellen von standardmäßigen Druckaufträgen in Windows Forms

Referenz

PageSetupDialog

Weitere Ressourcen

PageSetupDialog-Komponente (Windows Forms)