Procedura: definire le proprietà della pagina con il componente PageSetupDialogHow to: Determine Page Properties Using the PageSetupDialog Component

Il componente PageSetupDialog presenta layout, dimensioni del foglio e altre opzioni relative al layout di pagina per un documento.The PageSetupDialog component presents layout, paper size, and other page layout choices to the user for a document.

È necessario specificare un'istanza della classe PrintDocument , che rappresenta il documento da stampare.You need to specify an instance of the PrintDocument class—this is the document to be printed. È inoltre necessario che sul computer dell'utente sia installata una stampante, locale o di rete, tramite la quale il componente PageSetupDialog determina in parte le scelte di formattazione della pagina presentate all'utente.Additionally, users must have a printer installed on their computer, either locally or through a network, as this is partly how the PageSetupDialog component determines the page formatting choices presented to the user.

Un aspetto importante dell'uso del componente PageSetupDialog è dato dalla modalità di interazione con la classe PageSettings .An important aspect of working with the PageSetupDialog component is how it interacts with the PageSettings class. La classe PageSettings viene usata per specificare le impostazioni che modificano la modalità di stampa di una pagina, come l'orientamento, le dimensioni e i margini.The PageSettings class is used to specify settings that modify the way a page will be printed, such as paper orientation, the size of the page, and the margins. Ciascuna di queste impostazioni è rappresentata come una proprietà della classe PageSettings .Each of these settings is represented as a property of the PageSettings class. La classe PageSetupDialog modifica i valori delle proprietà per una determinata istanza della classe PageSettings , che è associata al documento ed è rappresentata come proprietà DefaultPageSettings .The PageSetupDialog class modifies these property values for a given instance of the PageSettings class that is associated with the document (and is represented as a DefaultPageSettings property).

Per impostare le proprietà della pagina mediante il componente PageSetupDialogTo set page properties using the PageSetupDialog component

  1. Usare il metodo ShowDialog per aprire la finestra di dialogo, specificando l'oggetto PrintDocument desiderato.Use the ShowDialog method to display the dialog box, specifying the PrintDocument to use.

    Nell'esempio seguente il gestore eventi Button del controllo Click apre un'istanza del componente PageSetupDialog .In the example below, the Button control's Click event handler opens an instance of the PageSetupDialog component. Un documento esistente è specificato nella proprietà Document e la relativa proprietà PageSettings.Color è impostata su false.An existing document is specified in the Document property, and its PageSettings.Color property is set to false.

    Nell'esempio si presuppone il modulo contiene un Button (controllo), un PrintDocument componente denominato myDocumente un PageSetupDialog componente.The example assumes your form has a Button control, a PrintDocument component named myDocument, and a PageSetupDialog component.

    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++Visual C++) inserire il codice seguente nel costruttore del form per registrare il gestore dell'evento.(Visual C# and Visual C++Visual C++) Place the following code in the form's constructor to register the event handler.

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

Vedere ancheSee Also

PageSetupDialog
Procedura: Creare processi di stampa standard per Windows FormHow to: Create Standard Windows Forms Print Jobs
Componente PageSetupDialogPageSetupDialog Component