Class CPrinterDriverUI

CPrinterDriverUI

Support

Supported from 5.0

Description

Printer specific user interface.

The class is used to implement a printer specific setup dialog. A concrete implementation of the class is supplied in a UDL (i.e. a UI DLL).

CPrinterDriver::CreatePrinterDriverUIL() is used to construct a CPrinterDriverUI object for a specific printer. (This function calls the ordinal 1 exported function of the UDL that performs the construction of the CPrinterDriverUI object).

Derivation

CBase Base class for all classes to be instantiated on the heap CPrinterDriverUI Printer specific user interface

Defined in CPrinterDriverUI:
AfterPrintL(), BeforePrintL(), CanSetProperties(), SetPrinterDevice(), SetPropertiesL()

Inherited from CBase:
operator new()

See also:

• CPrinterDriver::CreatePrinterDriverUIL()

virtual TBool BeforePrintL();

Description

Provides an opportunity for a dialog to be put up before printing begins.

Return value

TBool True, if printing is to continue; false, if printing is to be cancelled. The default implementation returns true.

virtual void AfterPrintL();

Description

Provides an opportunity for a dialog to be put up after printing is complete.

The default implementation is empty.

virtual void SetPropertiesL();

Description

Provides an opportunity for a dialog to be put up to capture or change printer properties.

The default implementation is empty.

virtual TBool CanSetProperties();

Description

Tests whether printer properties can be set.

Return value

TBool True, if printer properties can be set; false, otherwise. The default implementation returns false.

virtual TInt SetPrinterDevice(CPrinterDevice* aPrinterDevice) = 0;

Description

Sets the printer device.

Parameters

CPrinterDevice* aPrinterDevice The printer device.