Freigeben über


Vorgehensweise: Bestimmen von Seiteneigenschaften mit 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 dazu eine Instanz der PrintDocument -Klasse angeben. Dabei handelt es sich um das Dokument, das gedruckt werden soll. Darüber hinaus benötigen Benutzer einen lokal oder über ein Netzwerk auf dem Computer installierten Drucker, da die PageSetupDialog -Komponente darauf aufbauend die Formatierungsoptionen bestimmt, die dem Benutzer angezeigt werden.

Ein wichtiger Aspekt an der Arbeit mit der PageSetupDialog -Komponente ist ihre Interaktionsweise mit der PageSettings -Klasse. Die PageSettings -Klasse wird verwendet, um die Einstellungen anzugeben, die die Druckweise einer Seite beeinflussen, z.B. die Ausrichtung, die Seitengröße und die 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 mit dem Dokument verknüpft ist (als eine DefaultPageSettings -Eigenschaft dargestellt).

So bestimmen Sie die Seiteneigenschaften mit der PageSetupDialog-Komponente

  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 Document -Eigenschaft 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++) Fügen Sie folgenden Code in den Konstruktor des Formulars ein, um den Ereignishandler zu registrieren.

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

Weitere Informationen