class KPrintDialogPage |
|
|
This class is intended to be used as base class for customized print dialog page. One of the feature of the KDE print framework is to allow to customize the print dialog to add some application specific print options. This is done by subclassing KPrintDialogPage and reimplementing the 3 virtual functions getOptions, setOptions and isValid(). The print options will be stored in the KPrinter object, and will be accessible via KPrinter.option(). The option name should follow the form "kde-appname-optionname" for internal reasons.
#include Base class for customized print dialog pages. See also KPrinter |
|
Standard constructor. |
|
Modified constructor. For internal use only. |
|
For internal use only. |
|
This function is called to fill the structure opts with the selected options from this dialog page. If incldef is true, include also options with default values, otherwise discard them. Reimplement this function in subclasses. opts - the option set to fill incldef - if true, include also options with default values See also setOptions() |
|
Get the ID of the page. Not used yet. Returns the page ID See also setId() |
|
Returns true if options selected in the page are valid (no conflict), false otherwise. When returning false, msg should contain an error message explaining what is wrong in the selected options. msg - should contain an error message when returning false Returns valid status |
|
Tell wether or not the page should be disable if a non real printer (special printer) is selected in the print dialog. Returns false by default. Application specific pages usually corresponds to printer-independent options, so the page should be kept enabled whatever the selected printer. The default value is then correct and your application doesn't to change anything. Returns true if the page should be disabled for non real printers See also setOnlyRealPrinters() |
|
For internal use only |
|
Set the ID of the page. Not used yet. ID - the ID number See also id() |
|
Change the page state when a non real printer is selected in the print dialog. Usually, the default value (false) is OK in most cases and you don't need to call this function explicitly. on - if true, then the page will be disabled if a non real printer is selected See also onlyRealPrinters() |
|
This function is called to update the current page with the options contained in opts. Reimplement it in subclasses. opts - the structure containing the options to update the page |
|
Set the page title. This title will be used as tab name for this page in the print dialog. txt - the page title See also title() |
|
Get the page title. Returns the page title See also setTitle() |