|  | 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, QWidget parent = None)
- __init__ (self, QPrinter printer, QWidget parent = None)
- addEnabledOption (self, PageSetupDialogOption option)
- PageSetupDialogOptions enabledOptions (self)
- int exec_ (self)
- bool isOptionEnabled (self, PageSetupDialogOption option)
- open (self)
- open (self, QObject receiver, SLOT()SLOT() member)
- open (self, callable receiver)
- PageSetupDialogOptions options (self)
- QPrinter printer (self)
- setEnabledOptions (self, PageSetupDialogOptions options)
- setOption (self, PageSetupDialogOption option, bool on = True)
- setOptions (self, PageSetupDialogOptions options)
- setVisible (self, bool visible)
- bool testOption (self, PageSetupDialogOption option)

## 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.

In Symbian, there is no support for printing. Hence, this dialog should not be used in Symbian.

## Type Documentation

### QPageSetupDialog.PageSetupDialogOption

Used to specify options to the page setup dialog

This value is obsolete and does nothing since Qt 4.5:

Constant | Value | Description
--- | --- | ---
`QPageSetupDialog.DontUseSheet` | `0x00000001` | In previous versions of QDialog.exec() the page setup dialog would create a sheet by default if the dialog was given a parent. This is no longer supported from Qt 4.5. If you want to use sheets, use QPageSetupDialog.open() instead.

This enum was introduced or modified 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, 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.__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 a default-constructed QPrinter with parent as the parent widget.

This function was introduced in Qt 4.5.

See also printer().

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

### PageSetupDialogOptions QPageSetupDialog.enabledOptions (self)

### int QPageSetupDialog.exec_ (self)

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

### QPageSetupDialog.open (self)

This is an overloaded function.

Opens the dialog and connects its accepted() signal to the slot specified by receiver and member.

The signal will be disconnected from the slot when the dialog is closed.

This function was introduced in Qt 4.5.

### QPageSetupDialog.open (self, QObject receiver, SLOT()SLOT() member)

### QPageSetupDialog.open (self, callable receiver)

### PageSetupDialogOptions QPageSetupDialog.options (self)

### QPrinter QPageSetupDialog.printer (self)

Returns the printer that was passed to the QPageSetupDialog constructor.

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

### QPageSetupDialog.setOption (self, PageSetupDialogOption option, bool on = True)

Sets the given option to be enabled if on is true; otherwise, clears the given option.

See also options and testOption().

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

### QPageSetupDialog.setVisible (self, bool visible)

Reimplemented from QWidget.setVisible().

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

Returns true if the given option is enabled; otherwise, returns false.

See also options and setOption().