Qt 4.0: QAbstractPrintDialog Class Reference

|  | Home · All Classes · Main Classes · Grouped Classes · Modules · Functions |

# QAbstractPrintDialog Class Reference
[QtGui module]

The QAbstractPrintDialog class provides a base implementation for print dialogs used to configure printers. More...

    #include <QAbstractPrintDialog>

Inherits QDialog.

Inherited by QPrintDialog.

- List of all members, including inherited members

### Public Types

- enum PrintDialogOption { None, PrintToFile, PrintSelection, PrintPageRange, PrintCollateCopies }
- flags PrintDialogOptions
- enum PrintRange { AllPages, Selection, PageRange }

### Public Functions

- QAbstractPrintDialog ( QPrinter * printer, QWidget * parent = 0 )
- void addEnabledOption ( PrintDialogOption option )
- PrintDialogOptions enabledOptions () const
- virtual int exec () = 0
- int fromPage () const
- bool isOptionEnabled ( PrintDialogOption option ) const
- int maxPage () const
- int minPage () const
- PrintRange printRange () const
- QPrinter * printer () const
- void setEnabledOptions ( PrintDialogOptions options )
- void setFromTo ( int from, int to )
- void setMinMax ( int min, int max )
- void setPrintRange ( PrintRange range )
- int toPage () const

- 9 public functions inherited from QDialog
- 184 public functions inherited from QWidget
- 28 public functions inherited from QObject
- 10 public functions inherited from QPaintDevice

### Additional Inherited Members

- 2 properties inherited from QDialog
- 52 properties inherited from QWidget
- 1 property inherited from QObject
- 5 public slots inherited from QDialog
- 17 public slots inherited from QWidget
- 1 public slot inherited from QObject
- 1 signal inherited from QWidget
- 1 signal inherited from QObject
- 4 static public members inherited from QWidget
- 4 static public members inherited from QObject
- 39 protected functions inherited from QWidget
- 7 protected functions inherited from QObject

## Detailed Description

The QAbstractPrintDialog class provides a base implementation for print dialogs used to configure printers.

## Member Type Documentation

### enum QAbstractPrintDialog::PrintDialogOption
flags QAbstractPrintDialog::PrintDialogOptions

Used to specify which parts of the print dialog should be enabled.

Constant | Value | Description
--- | --- | ---
`QAbstractPrintDialog::None` | `0x0000` | None of the options are enabled.
`QAbstractPrintDialog::PrintToFile` | `0x0001` | The print to file option is enabled.
`QAbstractPrintDialog::PrintSelection` | `0x0002` | The print selection option is enalbed.
`QAbstractPrintDialog::PrintPageRange` | `0x0004` | The page range selection option is enabled.
`QAbstractPrintDialog::PrintCollateCopies` | `0x0010` |

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

### enum QAbstractPrintDialog::PrintRange

Used to specify the print range selection option.

Constant | Value | Description
--- | --- | ---
`QAbstractPrintDialog::AllPages` | `0` | All pages should be printed.
`QAbstractPrintDialog::Selection` | `1` | Only the selection should be printed.
`QAbstractPrintDialog::PageRange` | `2` | The specified page range should be printed.

## Member Function Documentation

### QAbstractPrintDialog::QAbstractPrintDialog ( QPrinter * printer, QWidget * parent = 0 )

Constructs an abstract print dialog for printer with parent as parent widget

### void QAbstractPrintDialog::addEnabledOption ( PrintDialogOption option )

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

### PrintDialogOptions QAbstractPrintDialog::enabledOptions () const

Returns the set of enabled options in this dialog.

See also setEnabledOptions().

### int QAbstractPrintDialog::exec () `[pure virtual]`

This virtual function is called to pop up the dialog. It must be reimplemented in subclasses.

### int QAbstractPrintDialog::fromPage () const

Returns the first page to be printed

### bool QAbstractPrintDialog::isOptionEnabled ( PrintDialogOption option ) const

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

### int QAbstractPrintDialog::maxPage () const

Returns the maximum page in the page range.

### int QAbstractPrintDialog::minPage () const

Returns the minimum page in the page range.

### PrintRange QAbstractPrintDialog::printRange () const

Returns the print range.

See also setPrintRange().

### QPrinter * QAbstractPrintDialog::printer () const

Returns the printer that this printer dialog operates on.

### void QAbstractPrintDialog::setEnabledOptions ( PrintDialogOptions options )

Sets the set of options that should be enabled in the print dialog to options.

See also enabledOptions().

### void QAbstractPrintDialog::setFromTo ( int from, int to )

Sets the range in the print dialog to be from from to to.

### void QAbstractPrintDialog::setMinMax ( int min, int max )

Sets the page range in this dialog to be from min to max. This also enables the PrintPageRange option.

### void QAbstractPrintDialog::setPrintRange ( PrintRange range )

Sets the print range option in to be range.

See also printRange().

### int QAbstractPrintDialog::toPage () const

Returns the last page to be printed.