Class CPrinterDriver

class CPrinterDriver : public CBase;

Description

Provides access to a store containing printer specification data.

Printer specification data is held as a direct file store, and usually has a .pdr file type.

A printer driver is implemented as two files: a PDR file containing the printer specification data and a PDL file containing the code to link the printer with the graphics printing system.

The printer specification data is generated by compiling a text file (a .pd file type) using the pdrtran tool. Printer specification data defines:

the name of the associated PDL

a list of one or more models supported by this driver, identified by name and UID

device information such as the size of the device, typeface information for each model, including which typefaces are supported, the heights available in each typeface and the width of each character in a font.

Derivation

• CBase - Base class for all classes to be instantiated on the heap

• CPrinterDriver - Provides access to a store containing printer specification data

Members

Defined in CPrinterDriver:
Close(), CreatePrinterDeviceL(), CreatePrinterDriverUIL(), Model(), NewL(), NumModels(), OpenPdrL(), PrinterDevice(), ~CPrinterDriver()

Inherited from CBase:
Delete(), Extension_(), operator new()

See also

• Class summary

See also:

• CPrinterDriverUI

static IMPORT_C CPrinterDriver *NewL();

Description

Constructs, and returns a pointer to a new instance for accessing a printer specification data store.

Return value

CPrinterDriver * Pointer to the object for accessing a printer specification data store.

IMPORT_C ~CPrinterDriver();

Description

Destructor.

It frees all resources owned by the object, prior to its destruction. In particular, it closes the printer specification data store and any open session with the file server.

IMPORT_C void OpenPdrL(const TDesC &aName);

Description

Opens the specified printer specification data store.

Parameters

const TDesC &aName

IMPORT_C void Close();

Description

Closes the printer specification data store and frees resources.

An open session with the file server remains open.

IMPORT_C TInt NumModels() const;

Description

Gets the number of printer models defined by the printer specification.

Return value

TInt The number of printer models.

IMPORT_C TPrinterModelEntry Model(TInt aNum) const;

Description

Gets the specified printer model.

Parameters

TInt aNum An index into the list of printer models defined in the printer specification data.

Return value

TPrinterModelEntry Model specific information.

inline CPrinterDevice *PrinterDevice();

Description

Gets the associated graphics printer device.

Return value

CPrinterDevice * The physical graphics device used for printing.

IMPORT_C CPrinterDevice *CreatePrinterDeviceL(TUid aModelUid);

Description

Creates the physical graphics device to be used for printing.

Parameters

TUid aModelUid The UID of a specific model which is defined in the printer specification data.

Return value

CPrinterDevice * The physical graphics device to be used for printing.

IMPORT_C CPrinterDriverUI *CreatePrinterDriverUIL();

Description

Constructs a printer specific user interface.

The user interface object is optional, but if it exists, it is implemented as part of a UDL (i.e. a UI DLL).

Return value

CPrinterDriverUI * A pointer to the printer specific user interface, or NULL if there is none.