Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <PDRSTORE.H>
Link against: pdrstr.lib

Class CPdrDevice

class CPdrDevice : public CPrinterDevice;

Description

Derivation

Members

Defined in CPdrDevice:

Inherited from CBase:

Inherited from CGraphicsDevice:

Inherited from CPrinterDevice:

Inherited from MGraphicsDeviceMap:

See also:


Construction and destruction


CPdrDevice()

protected: IMPORT_C CPdrDevice();

Description


~CPdrDevice()

IMPORT_C virtual ~CPdrDevice();

Description

[Top]


Member functions


SelectPageSpecInTwips(const TPageSpec &)

IMPORT_C virtual void SelectPageSpecInTwips(const TPageSpec &aPageSpec);

Description

Sets the page specification in twips.

Parameters

const TPageSpec &aPageSpec

The page specification in twips.


DisplayMode()const

IMPORT_C virtual TDisplayMode DisplayMode() const;

Description

Gets the display mode of the device.

Return value

TDisplayMode

The display mode of the device.


SizeInPixels()const

IMPORT_C virtual TSize SizeInPixels() const;

Description

Gets the size of the device area in pixels.

Return value

TSize

The width and height of the device area, in pixels


SizeInTwips()const

IMPORT_C virtual TSize SizeInTwips() const;

Description

Gets the size of the device area in twips.

Return value

TSize

The width and height of the device area, in twips


PrintablePageInPixels()const

IMPORT_C virtual TRect PrintablePageInPixels() const;

Description

Return value

TRect


HorizontalTwipsToPixels(TInt)const

IMPORT_C virtual TInt HorizontalTwipsToPixels(TInt aTwips) const;

Description

Converts a horizontal dimension from twips to pixels.

An implementation is supplied by a derived class.

Parameters

TInt aTwips

A horizontal dimension of a device in twips.

Return value

TInt

A horizontal dimension of a device in pixels.


VerticalTwipsToPixels(TInt)const

IMPORT_C virtual TInt VerticalTwipsToPixels(TInt aTwips) const;

Description

Converts a vertical dimension from twips to pixels.

An implementation is supplied by a derived class.

Parameters

TInt aTwips

A vertical dimension of a device in twips.

Return value

TInt

A vertical dimension of a device in pixels.


HorizontalPixelsToTwips(TInt)const

IMPORT_C virtual TInt HorizontalPixelsToTwips(TInt aPixels) const;

Description

Converts a horizontal dimension from pixels to twips.

An implementation is supplied by a derived class.

Parameters

TInt aPixels

A horizontal dimension of a device in pixels.

Return value

TInt

A horizontal dimension of a device in twips.


VerticalPixelsToTwips(TInt)const

IMPORT_C virtual TInt VerticalPixelsToTwips(TInt aPixels) const;

Description

Converts a vertical dimension from pixels to twips.

An implementation is supplied by a derived class.

Parameters

TInt aPixels

A vertical dimension of a device in pixels.

Return value

TInt

A vertical dimension of a device in twips.


GetNearestFontInTwips(CFont *&,const TFontSpec &)

Interface status: deprecated

IMPORT_C virtual TInt GetNearestFontInTwips(CFont *&aFont, const TFontSpec &aFontSpec);

Description

Creates a font from those available in the printer device's typeface store that most closely matches a font specification.

When the font is no longer needed, call CPdrDevice::ReleaseFont(CFont *).

This function is replaced by CPdrDevice::GetNearestFontToDesignHeightInTwips(CFont *&,const TFontSpec &)

Parameters

CFont *&aFont

On return, points to the font which most closely matches the specified font.

const TFontSpec &aFontSpec

An absolute font specification. Its iHeight member is interpreted as being in twips.

Return value

TInt

KErrNone if successful; otherwise, another one of the system-wide error codes.


GetNearestFontToDesignHeightInTwips(CFont *&,const TFontSpec &)

IMPORT_C virtual TInt GetNearestFontToDesignHeightInTwips(CFont *&aFont, const TFontSpec &aFontSpec);

Description

Creates a font from those available in the printer device's typeface store that most closely matches a font specification.

When the font is no longer needed, call CPdrDevice::ReleaseFont(CFont *).

This function replaces CPdrDevice::GetNearestFontInTwips(CFont *&,const TFontSpec &)

Parameters

CFont *&aFont

On return, points to the font which most closely matches the specified font.

const TFontSpec &aFontSpec

An absolute font specification. Its iHeight member is interpreted as being in twips.

Return value

TInt

KErrNone if successful; otherwise, another one of the system-wide error codes.


GetNearestFontToMaxHeightInTwips(CFont *&,const TFontSpec &,TInt)

IMPORT_C virtual TInt GetNearestFontToMaxHeightInTwips(CFont *&aFont, const TFontSpec &aFontSpec, TInt aMaxHeight);

Description

This call is defined because it had to be - it appeared as an abstract virtual in the base class. But it should never actually get called for this class.

Parameters

CFont *&aFont

const TFontSpec &aFontSpec

TInt aMaxHeight

Return value

TInt


NumTypefaces()const

IMPORT_C virtual TInt NumTypefaces() const;

Description

Gets the number of typefaces supported by the graphics device.

Return value

TInt

The number of typefaces supported.


TypefaceSupport(TTypefaceSupport &,TInt)const

IMPORT_C virtual void TypefaceSupport(TTypefaceSupport &aTypefaceSupport, TInt aTypefaceIndex) const;

Description

Gets typeface information for a specified typeface.

This information is returned in aTypefaceSupport, and includes:

the typeface name and typeface attributes

the number of font heights

the maximum and minimum font heights

whether it is a scalable typeface

Parameters

TTypefaceSupport &aTypefaceSupport

On return, contains the typeface information.

TInt aTypefaceIndex

A typeface index number, in the range: zero to (CPdrDevice::NumTypefaces()const - 1).

See also:


FontHeightInTwips(TInt,TInt)const

IMPORT_C virtual TInt FontHeightInTwips(TInt aTypefaceIndex, TInt aHeightIndex) const;

Description

Get the height of a font in twips.

The font is identified by typeface and height.

The value returned is rounded up or down to the nearest font height in twips.

Parameters

TInt aTypefaceIndex

An index identifying the typeface, in the range: 0 to (CPdrDevice::NumTypefaces()const - 1).

TInt aHeightIndex

An index identifying the font height, in the range: 0 to (iNumHeights - 1). Note that iNumHeights is in the TTypefaceSupport object returned by CPdrDevice::TypefaceSupport(TTypefaceSupport &,TInt)const.

Return value

TInt

The height of the font, in twips.


PaletteAttributes(TBool &,TInt &)const

IMPORT_C virtual void PaletteAttributes(TBool &aModifiable, TInt &aNumEntries) const;

Description

Gets the palette attributes of the device.

Parameters

TBool &aModifiable

On return, holds information on whether or not the device's palette is modifiable (ETrue) or fixed (EFalse).

TInt &aNumEntries

On return, holds the number of entries in the device's palette.


SetPalette(CPalette *)

IMPORT_C virtual void SetPalette(CPalette *aPalette);

Description

Sets the device's palette.

Parameters

CPalette *aPalette

The new palette for the device.


GetPalette(CPalette *&)const

IMPORT_C virtual TInt GetPalette(CPalette *&aPalette) const;

Description

Gets the device's current palette.

Parameters

CPalette *&aPalette

On return, holds the device's current palette.

Return value

TInt

KErrNone, if successful; otherwise, another of the system-wide error codes.


Model()const

IMPORT_C virtual TPrinterModelEntry Model() const;

Description

Gets the printer model entry.

Return value

TPrinterModelEntry

The printer model entry.


Flags()const

IMPORT_C TInt Flags() const;

Description

Return value

TInt


SetModel(const TPrinterModelHeader &,CStreamStore &)

IMPORT_C virtual TInt SetModel(const TPrinterModelHeader &aModel, CStreamStore &aStore);

Description

Sets the printer model header and the store.

Parameters

const TPrinterModelHeader &aModel

The printer model header.

CStreamStore &aStore

The store.

Return value

TInt

KErrNone if successful; otherwise, another of the system-wide error codes.


ReleaseFont(CFont *)

IMPORT_C virtual void ReleaseFont(CFont *aFont);

Description

Releases the specified font.

It is used to indicate that the specified font is no longer needed for use by the device map. As fonts can be shared between applications, this function does not delete the copy of the font from RAM unless the font was only being used by this particular device map.

An implementation is supplied by a derived class.

Parameters

CFont *aFont

A pointer to the font to be released.


OffsetInPixels()

IMPORT_C TPoint OffsetInPixels();

Description

Return value

TPoint


KPixelSizeInTwips()const

protected: IMPORT_C virtual TSize KPixelSizeInTwips() const;

Description

Return value

TSize

[Top]


Member data


iStore

protected: CStreamStore * iStore;

Description


iModel

protected: TPrinterModelHeader iModel;

Description


iModelInfo

protected: CPdrModelInfo * iModelInfo;

Description


iTypefaceStore

protected: CPdrTypefaceStore * iTypefaceStore;

Description