Advanced 10 min read Control #15

PageSetupDialog Control

PageSetupDialog allows users to configure page layout settings before printing: margins, paper size, orientation, and paper source.

What is a PageSetupDialog?

PageSetupDialog is a standard dialog that lets users set page layout options. It's typically used before printing to let users choose paper size, orientation, and margins.

Code Example

// Use PageSetupDialog with PrintDocument
private void btnPageSetup_Click(object sender, EventArgs e)
{
    // Show the dialog
    if (pageSetupDialog1.ShowDialog() == DialogResult.OK)
    {
        // Apply the user's page settings
        printDocument1.DefaultPageSettings = 
            pageSetupDialog1.PageSettings;
        MessageBox.Show("Page setup updated!");
    }
}

// Configure the dialog
pageSetupDialog1.AllowMargins = true;
pageSetupDialog1.AllowOrientation = true;
pageSetupDialog1.AllowPaper = true;
pageSetupDialog1.AllowPrinter = true;
pageSetupDialog1.Document = printDocument1;

Exercise

Task: Create a print setup demo.

  1. Add a PrintDocument component.
  2. Add a PageSetupDialog component.
  3. Add a Button: "Page Setup".
  4. When clicked, show the PageSetupDialog.
  5. Apply the settings to the PrintDocument.
  6. Add a Button to print and show a preview.
Key Takeaway

PageSetupDialog lets users control page layout. Always use it before printing to give users full control over the output.

Previous: NotifyIcon Next: Panel
Controls