PageSetupDialog Component Overview (Windows Forms)

The Windows Forms PageSetupDialog component is a pre-configured dialog box used to set page details for printing in Windows-based applications. Use it within your Windows-based application as a simple solution for users to set page preferences in lieu of configuring your own dialog box. You can enable users to set border and margin adjustments, headers and footers, and portrait or landscape orientation. By relying on standard Windows dialog boxes, you create applications whose basic functionality is immediately familiar to users.

Key Properties and Methods

Use the ShowDialog method to display the dialog at run time. This component has properties you can set that relate to either a single page (PrintDocument class) or any document (PageSettings class). Additionally, the PageSetupDialog component can be used to determine specific printer settings, which are stored in the PrinterSettings class.

When it is added to a form, the PageSetupDialog component appears in the tray at the bottom of the Windows Forms Designer in Visual Studio.

See also