Using the <i class="emphasis">PageSetupDialog</i> Class

Using the PageSetupDialog Class

As discussed in the In Depth section of this chapter, page setup dialogs let you specify page orientation, paper size, margin size, and more; you can see the page setup dialog from the Printing example on the CD-ROM in Figure 9.10. Page setup dialogs are supported by the PageSetupDialog class, which has this class hierarchy:

Object
   MarshalByRefObject
      Component
         CommonDialog
            PageSetupDialog

You can find the notable properties of PageSetupDialog objects in Table 9.32, the notable methods in Table 9.33, and the notable events in Table 9.34.

Table 9.32: Noteworthy public properties of *PageSetupDialog* objects.
Property	Means
AllowMargins	Gets/sets whether the margins section of the dialog box is enabled.
AllowOrientation	Gets/sets whether the orientation section of the dialog box (landscape or portrait) is enabled.
AllowPaper	Gets/sets whether the paper section of the dialog box (paper size and paper source) is enabled.
AllowPrinter	Gets/sets whether the Printer button is enabled.
Document	Gets/sets the PrintDocument to get page settings from.
MinMargins	Gets/sets the minimum margins the user is allowed to select. Measured in hundredths of an inch.
PageSettings	Gets/sets the page settings to modify.
PrinterSettings	Gets/sets the printer settings to modify.
ShowHelp	Gets/sets whether the Help button is visible.
ShowNetwork	Gets/sets whether the Network button is visible.

Table 9.33: Noteworthy public methods of *PageSetupDialog* objects.
Method	Means
Reset	Resets all dialog options.
ShowDialog	Shows the dialog.

Table 9.34: Noteworthy public events of *PageSetupDialog* objects.
Event	Means
HelpRequest	Occurs when the user clicks the Help button.