|  | Home · All Classes · Modules

# QPageSetupDialog Class Reference
[QtGui module]

The QPageSetupDialog class provides a configuration dialog for the page-related options on a printer. More...

Inherits QDialog.

### Types

- enum PageSetupDialogOption { None, DontUseSheet }
- class PageSetupDialogOptions

### Methods

- __init__ (self, QPrinter printer, QWidget parent = None)
- addEnabledOption (self, PageSetupDialogOption option)
- PageSetupDialogOptions enabledOptions (self)
- int exec_ (self)
- bool isOptionEnabled (self, PageSetupDialogOption option)
- QPrinter printer (self)
- setEnabledOptions (self, PageSetupDialogOptions options)

## Detailed Description

The QPageSetupDialog class provides a configuration dialog for the page-related options on a printer.

On Windows and Mac OS X the page setup dialog is implemented using the native page setup dialogs.

Note that on Windows and Mac OS X custom paper sizes won't be reflected in the native page setup dialogs. Additionally, custom page margins set on a QPrinter won't show in the native Mac OS X page setup dialog.

See also QPrinter and QPrintDialog.

## Type Documentation

### QPageSetupDialog.PageSetupDialogOption

Used to specify options to the page setup dialog

Constant | Value | Description
--- | --- | ---
`QPageSetupDialog.None` | `0x0000` | None of the options are enabled.

`QPageSetupDialog.DontUseSheet`

`0x0001`

Do not make the native print dialog a sheet. By default on Mac OS X, the native dialog is made a sheet if it has a parent that can accept sheets and is visible. Internally, Mac OS X tracks whether a printing <em>session</em> and not which particular dialog should have a sheet or not. Therefore, make sure this value matches between the page setup dialog and the print dialog or you can potentially end up in a modal loop that you can't break.

This enum was introduced in Qt 4.4.

The PageSetupDialogOptions type is a typedef for QFlags<PageSetupDialogOption>. It stores an OR combination of PageSetupDialogOption values.

## Method Documentation

### QPageSetupDialog.__init__ (self, QPrinter printer, QWidget parent = None)

The parent argument, if not None, causes self to be owned by Qt instead of PyQt.

Constructs a page setup dialog that configures printer with parent as the parent widget.

### QPageSetupDialog.addEnabledOption (self, PageSetupDialogOption option)

Adds the option option to the set of enabled options in this dialog.

This function was introduced in Qt 4.4.

### PageSetupDialogOptions QPageSetupDialog.enabledOptions (self)

Returns the set of enabled options in this dialog.

This function was introduced in Qt 4.4.

See also setEnabledOptions().

### int QPageSetupDialog.exec_ (self)

### bool QPageSetupDialog.isOptionEnabled (self, PageSetupDialogOption option)

Returns true if the specified option is enabled; otherwise returns false

This function was introduced in Qt 4.4.

### QPrinter QPageSetupDialog.printer (self)

Returns the printer that was passed to the QPageSetupDialog constructor.

### QPageSetupDialog.setEnabledOptions (self, PageSetupDialogOptions options)

Sets the set of options that should be enabled for the page setup dialog to options.

This function was introduced in Qt 4.4.

See also enabledOptions().