KdePrint Namespace Reference

Namespace for the KDE printing system. More...

Enumerations
enum	PageSelectPolicy { ApplicationSelectsPages, SystemSelectsPages }
Functions
QPrintDialog *	createPrintDialog (QPrinter *printer, PageSelectPolicy pageSelectPolicy, const QList< QWidget * > &customTabs, QWidget *parent=0)
QPrintDialog *	createPrintDialog (QPrinter *printer, QWidget *parent=0)
QPrintDialog *	createPrintDialog (QPrinter *printer, PageSelectPolicy pageSelectPolicy, QWidget *parent=0)
QPrintDialog *	createPrintDialog (QPrinter *printer, const QList< QWidget * > &customTabs, QWidget *parent=0)

---

Detailed Description

Namespace for the KDE printing system.

---

Enumeration Type Documentation

enum KdePrint::PageSelectPolicy

Whether pages to be printed are selected by the application or the print system.

If ApplicationSelectsPages is set then the Application paints only the pages selected by the user in the Print Dialog and the Print System prints all the pages.

If SystemSelectsPages is set then the Application paints all the pages and the Server will attempt to select the user requested pages. This only works in CUPS, not LPR, Windows, or OSX.

Enumerator:

ApplicationSelectsPages
SystemSelectsPages

Definition at line 48 of file kdeprintdialog.h.

---

Function Documentation

QPrintDialog * KdePrint::createPrintDialog	(	QPrinter *	printer,
		PageSelectPolicy	pageSelectPolicy,
		const QList< QWidget * > &	customTabs,
		QWidget *	parent = 0
	)

Since:

4.4

Creates a printer dialog for a QPrinter with the given custom widgets.

If ApplicationSelectsPages is set then the Application paints only the pages selected by the user in the Print Dialog and the Print System prints all the pages.

If SystemSelectsPages is set then the Application paints all the pages and the Server will attempt to select the user requested pages. On platforms where the Server does not support the selection of pages (i.e. Windows, OSX, and LPR) then the Page Range input will be disabled on the print dialog.

Note that the custom widgets are only supported on X11 and will not be shown on Qt versions prior to 4.3.2. On non-X11 systems it is preferred to provide the widgets within configuration dialog of the application.

Setting the widgets will transfer their ownership to the print dialog even on non-X11 systems.

The caller takes ownership of the dialog and is responsible for deleting it.

Parameters:

printer	the QPrinter to apply settings to
pageSelectPolicy	whether the Application or the System does the page selection
customTabs	a list of custom widgets to show as tabs, the name printed on the tab will be taken from the widgets windowTitle().
parent	the parent for the dialog

See also:

QWidget::setWindowTitle()

QAbstractPrintDialog::setOptionTabs()

Definition at line 39 of file kdeprintdialog.cpp.

QPrintDialog * KdePrint::createPrintDialog	(	QPrinter *	printer,
		QWidget *	parent = 0
	)

Creates a printer dialog for a QPrinter.

Convenience method, assumes PageSelectionMode of ApplicationSelectsPages, see full version method for full documentation.

The caller takes ownership of the dialog and is responsible for deleting it.

Parameters:

printer	the QPrinter to apply settings to
parent	the parent for the dialog

Definition at line 92 of file kdeprintdialog.cpp.

QPrintDialog * KdePrint::createPrintDialog	(	QPrinter *	printer,
		PageSelectPolicy	pageSelectPolicy,
		QWidget *	parent = 0
	)

Since:

4.4

Creates a printer dialog for a QPrinter with the given custom widgets.

Convenience method, see full version method for full documentation.

The caller takes ownership of the dialog and is responsible for deleting it.

Parameters:

printer	the QPrinter to apply settings to
pageSelectPolicy	whether the Application or the System does the page selection
parent	the parent for the dialog

Definition at line 85 of file kdeprintdialog.cpp.

QPrintDialog * KdePrint::createPrintDialog	(	QPrinter *	printer,
		const QList< QWidget * > &	customTabs,
		QWidget *	parent = 0
	)

Creates a printer dialog for a QPrinter with the given custom widgets.

Convenience method, assumes PageSelectionMode of ApplicationSelectsPages, see full version method for full documentation.

The caller takes ownership of the dialog and is responsible for deleting it.

Parameters:

printer	the QPrinter to apply settings to
parent	the parent for the dialog
customTabs	a list of custom widgets to show as tabs, the name printed on the tab will be taken from the widgets windowTitle().

Definition at line 77 of file kdeprintdialog.cpp.