Collapse all Symbian^3 Product Developer Library

CPrinterDevice Class Reference

class CPrinterDevice : public CGraphicsDevice

Printer graphics device interface.

This abstract class represents a physical graphics device that is used for printing.

This class is used to:

set and get the page specification

map between the co-ordinates of the printed page (in twips) and the co-ordinates of the image device (in pixels)

get and set the printer model entry

create and delete a printer control.

A printer driver is defined in terms of a printer device and a printer control. A printer device can own either a single or no printer control. The control determines the progress and termination of the print job and is responsible for producing output.

CPrinterControl

Inherits from

CPrinterDevice
- CGraphicsDevice
  - CBase

Public Member Functions
	~CPrinterDevice()
void	CreateControlL(CPrinterPort *)
TPageSpec	CurrentPageSpecInTwips()
IMPORT_C void	DeleteControl()
void	ExternalizePropertiesL(RWriteStream &)
void	InternalizePropertiesL(RReadStream &)
TPrinterModelEntry	Model()
IMPORT_C TRect	PrintablePageInPixels()
IMPORT_C void	RestorePropertiesL()
IMPORT_C void	SelectPageSpecInTwips(const TPageSpec &)
TInt	SetModel(const TPrinterModelHeader &, CStreamStore &)
IMPORT_C void	StorePropertiesL()

Protected Member Functions
	CPrinterDevice()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CGraphicsDevice::CreateContext(CGraphicsContext *&)
	CGraphicsDevice::DisplayMode()const
	CGraphicsDevice::FontHeightInTwips(TInt,TInt)const
	CGraphicsDevice::GetPalette(CPalette *&)const
	CGraphicsDevice::NumTypefaces()const
	CGraphicsDevice::PaletteAttributes(TBool &,TInt &)const
	CGraphicsDevice::SetPalette(CPalette *)
	CGraphicsDevice::SizeInPixels()const
	CGraphicsDevice::SizeInTwips()const
	CGraphicsDevice::TypefaceSupport(TTypefaceSupport &,TInt)const

Public Attributes
CPrinterControl *	iControl

Protected Attributes
TPageSpec	iCurrentPageSpecInTwips

Constructor & Destructor Documentation

CPrinterDevice()

IMPORT_C

CPrinterDevice

(

)

[protected]

Standard constructor.

~CPrinterDevice()

IMPORT_C

~CPrinterDevice

(

)

Destructor. It frees all resources owned by the object, prior to its destruction.

Member Functions Documentation

CreateControlL(CPrinterPort *)

void

CreateControlL

(

CPrinterPort *

aPrinterPort

)

[pure virtual]

Creates a printer control.

The printer control is an instance of a CPrinterControl derived class; it is assigned to this printer device's iControl member.

Note that this function is called by CPrintSetup::StartPrintL().

Parameters

CPrinterPort * aPrinterPort

Pointer to an instance of a printer port.

CurrentPageSpecInTwips()

TPageSpec

CurrentPageSpecInTwips

(

)

const [inline]

Gets the current page specification in twips.

DeleteControl()

IMPORT_C void

DeleteControl

(

)

[virtual]

Deletes the printer control owned by this object.

The function sets the iControl member to NULL.

ExternalizePropertiesL(RWriteStream &)

void

ExternalizePropertiesL

(

RWriteStream &

)

const [inline, virtual]

Externalizes printer properties to the store.

The default implementation is empty.

Parameters

RWriteStream &

InternalizePropertiesL(RReadStream &)

void

InternalizePropertiesL

(

RReadStream &

)

[inline, virtual]

Externalizes printer properties to the store.

The default implementation is empty.

Parameters

RReadStream &

Model()

TPrinterModelEntry

Model

(

)

const [pure virtual]

Gets the printer model entry.

PrintablePageInPixels()

IMPORT_C TRect

PrintablePageInPixels

(

)

const [virtual]

Gets the dimensions of the area to which the printer device can print.

These dimensions are normally less than those returned by TPageSpec::OrientedPageSize() because a margin exists between the boundary of the printable page and the absolute extent of the page.

RestorePropertiesL()

IMPORT_C void

RestorePropertiesL

(

)

Restores printer properties.

SelectPageSpecInTwips(const TPageSpec &)

IMPORT_C void

SelectPageSpecInTwips

(

const TPageSpec &

aPageSpec

)

[virtual]

Sets the page specification in twips.

Parameters

const TPageSpec & aPageSpec

The page specification in twips.

SetModel(const TPrinterModelHeader &, CStreamStore &)

TInt	SetModel	(	const TPrinterModelHeader &	aModel,
			CStreamStore &	aStore
		)	[pure virtual]

Sets the printer model header and the store.

Parameters

const TPrinterModelHeader & aModel	The printer model header.
CStreamStore & aStore	The store.

StorePropertiesL()

IMPORT_C void

StorePropertiesL

(

)

const

Stores the printer properties.

Member Data Documentation

CPrinterControl * iControl

CPrinterControl *

iControl

The printer control.

This may be NULL. If implemented, it provides control over the print operation.

TPageSpec iCurrentPageSpecInTwips

TPageSpec

iCurrentPageSpecInTwips

[protected]

Current page specification in twips.