CWsScreenDevice Class Reference

class CWsScreenDevice : public CBitmapDevice

Software device screen.

An object of this class can be used to enquire or set parameters of the software screen, and determine the physical limits of the device.

CWsScreenDevice gives access to the list of screen modes. These are the combinations of screen rotation and screen size supported by the device. One of them is selected as the current screen mode. The possible screen modes are initialised in wsini.ini.

CFbsScreenDevice

Inherits from

Public Member Functions
CWsScreenDevice()
CWsScreenDevice(RWsSession &)
~CWsScreenDevice()
IMPORT_C TIntAddFile(const TDesC &, TInt &)
IMPORT_C TIntConstruct()
IMPORT_C TIntConstruct(TInt)
IMPORT_C TIntCopyScreenToBitmap(const CFbsBitmap *)
IMPORT_C TIntCopyScreenToBitmap(const CFbsBitmap *, const TRect &)
IMPORT_C TIntCreateContext(CGraphicsContext *&)
TInt CreateContext(CWindowGc *&)
IMPORT_C TIntCurrentScreenMode()
IMPORT_C TDisplayModeDisplayMode()
IMPORT_C TIntFontHeightInPixels(TInt, TInt)
IMPORT_C TIntFontHeightInTwips(TInt, TInt)
IMPORT_C TSizeModeGetCurrentScreenModeAttributes()
IMPORT_C TSizeGetCurrentScreenModeScale()
IMPORT_C TPointGetCurrentScreenModeScaledOrigin()
IMPORT_C TPointGetDefaultScreenModeOrigin()
IMPORT_C voidGetDefaultScreenSizeAndRotation(TPixelsTwipsAndRotation &)
IMPORT_C voidGetDefaultScreenSizeAndRotation(TPixelsAndRotation &)
IMPORT_C TIntGetFontById(CFont *&, TUid, const TAlgStyle &)
IMPORT_C TAny *GetInterface(TUint)
const TAny *GetInterface(TUint)
IMPORT_C TIntGetNearestFontInPixels(CFont *&, const TFontSpec &)
IMPORT_C TIntGetNearestFontInTwips(CFont *&, const TFontSpec &)
IMPORT_C TIntGetNearestFontToDesignHeightInPixels(CFont *&, const TFontSpec &)
IMPORT_C TIntGetNearestFontToDesignHeightInTwips(CFont *&, const TFontSpec &)
IMPORT_C TIntGetNearestFontToMaxHeightInPixels(CFont *&, const TFontSpec &, TInt)
IMPORT_C TIntGetNearestFontToMaxHeightInTwips(CFont *&, const TFontSpec &, TInt)
IMPORT_C TIntGetPalette(CPalette *&)
IMPORT_C voidGetPixel(TRgb &, const TPoint &)
IMPORT_C TIntGetRotationsList(TInt, CArrayFixFlat< TInt > *)
IMPORT_C voidGetScanLine(TDes8 &, const TPoint &, TInt, TDisplayMode)
IMPORT_C TDisplayModeGetScreenModeDisplayMode(const TInt &)
IMPORT_C TPointGetScreenModeOrigin(TInt)
IMPORT_C TSizeGetScreenModeScale(TInt)
IMPORT_C TPointGetScreenModeScaledOrigin(TInt)
IMPORT_C voidGetScreenModeSizeAndRotation(TInt, TPixelsTwipsAndRotation &)
IMPORT_C voidGetScreenModeSizeAndRotation(TInt, TPixelsAndRotation &)
IMPORT_C TIntGetScreenNumber()
IMPORT_C TIntGetScreenSizeModeList(RArray< TInt > *)
IMPORT_C TIntHorizontalPixelsToTwips(TInt)
IMPORT_C TIntHorizontalTwipsToPixels(TInt)
IMPORT_C TBoolIsCurrentModeDynamic()
IMPORT_C TBoolIsModeDynamic(TInt)
IMPORT_C TIntNumScreenModes()
IMPORT_C TIntNumTypefaces()
IMPORT_C voidPaletteAttributes(TBool &, TInt &)
IMPORT_C TRectPointerRect()
IMPORT_C TBoolRectCompare(const TRect &, const TRect &)
IMPORT_C TBoolRectCompare(const TRect &, const TRect &, TUint)
IMPORT_C voidReleaseFont(CFont *)
IMPORT_C voidRemoveFile(TInt)
IMPORT_C TScreenModeEnforcementScreenModeEnforcement()
IMPORT_C voidSetAppScreenMode(TInt)
IMPORT_C TIntSetBackLight(TBool)
IMPORT_C voidSetCurrentRotations(TInt, CFbsBitGc::TGraphicsOrientation)
IMPORT_C voidSetCurrentScreenModeAttributes(const TSizeMode &)
IMPORT_C TIntSetCustomPalette(const CPalette *)
IMPORT_C voidSetPalette(CPalette *)
IMPORT_C voidSetScreenMode(TInt)
IMPORT_C voidSetScreenModeEnforcement(TScreenModeEnforcement)
IMPORT_C voidSetScreenSizeAndRotation(const TPixelsTwipsAndRotation &)
IMPORT_C voidSetScreenSizeAndRotation(const TPixelsAndRotation &)
IMPORT_C TSizeSizeInPixels()
IMPORT_C TSizeSizeInTwips()
IMPORT_C voidTypefaceSupport(TTypefaceSupport &, TInt)
IMPORT_C TIntVerticalPixelsToTwips(TInt)
IMPORT_C TIntVerticalTwipsToPixels(TInt)
Private Member Functions
TSize DisplaySizeInPixels()
TSize PhysicalScreenSizeInTwips()
CFbsTypefaceStore *TypeFaceStore()
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()
CBitmapDevice::CreateBitmapContext(CBitmapContext *&)
Public Member Enumerations
enumTSpriteInCompare { ERemoveSprite = 0, EIncludeSprite = 1, EIncludeTextCursor = 2 }
Private Attributes
TSize iDisplaySizeInPixels
CScrDevExtension *iExtension
TSize iPhysicalScreenSizeInTwips

Constructor & Destructor Documentation

CWsScreenDevice()

IMPORT_CCWsScreenDevice()

CWsScreenDevice(RWsSession &)

IMPORT_CCWsScreenDevice(RWsSession &aWs)

Parameters

RWsSession & aWs

~CWsScreenDevice()

IMPORT_C~CWsScreenDevice()

Member Functions Documentation

AddFile(const TDesC &, TInt &)

IMPORT_C TIntAddFile(const TDesC &aName,
TInt &aId
)[virtual]

Adds a font file to the device's typeface store. The specified font file must be accessible to any process, i.e. not located inside an application's private directory.

This pure virtual function is implemented in derived classes.

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

Parameters

const TDesC & aNameThe name of the font file.
TInt & aIdOn return, contains an ID for the font file.

Construct()

IMPORT_C TIntConstruct()

Construct(TInt)

IMPORT_C TIntConstruct(TIntaDefaultScreenNumber)

Parameters

TInt aDefaultScreenNumber

CopyScreenToBitmap(const CFbsBitmap *)

IMPORT_C TIntCopyScreenToBitmap(const CFbsBitmap *aBitmap)const

Parameters

const CFbsBitmap * aBitmap

CopyScreenToBitmap(const CFbsBitmap *, const TRect &)

IMPORT_C TIntCopyScreenToBitmap(const CFbsBitmap *aBitmap,
const TRect &aRect
)const

Parameters

const CFbsBitmap * aBitmap
const TRect & aRect

CreateContext(CGraphicsContext *&)

IMPORT_C TIntCreateContext(CGraphicsContext *&aGC)[virtual]

Creates a graphics context for the device.

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

Parameters

CGraphicsContext *& aGCOn return, contains a pointer to the created graphics context.

CreateContext(CWindowGc *&)

TInt CreateContext(CWindowGc *&aGc)[inline]

Creates a graphics context for this device.

This function always causes a flush of the window server buffer.

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

CGraphicsDevice::CreateContext()

Parameters

CWindowGc *& aGcOn successful return, contains a new graphics context referring to this screen device.

CurrentScreenMode()

IMPORT_C TIntCurrentScreenMode()const

DisplayMode()

IMPORT_C TDisplayModeDisplayMode()const [virtual]

Gets the display mode of the device.

The display mode of the device.

DisplaySizeInPixels()

TSize DisplaySizeInPixels()const [private]

FontHeightInPixels(TInt, TInt)

IMPORT_C TIntFontHeightInPixels(TIntaTypefaceIndex,
TIntaHeightIndex
)const [virtual]

Gets the height, in pixels, of the specified typeface at one of its defined heights.

The typeface is identified by by an index. For a given typeface, there are a discrete number of heights; the specific height is also identified by an index.

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

This pure virtual function is implemented in derived classes.

The height of the font, in pixels.

TTypefaceSupport

CGraphicsDevice::NumTypefaces()

CGraphicsDevice::TypefaceSupport()

Parameters

TInt aTypefaceIndexA typeface index number, in the range: 0 to (NumTypefaces() - 1).
TInt aHeightIndexA font height index number, in the range: 0 to (iNumHeights - 1) where iNumHeights is a public data member of the TTypefaceSupport object returned by TypefaceSupport().

FontHeightInTwips(TInt, TInt)

IMPORT_C TIntFontHeightInTwips(TIntaTypefaceIndex,
TIntaHeightIndex
)const [virtual]

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.

The height of the font, in twips.

Parameters

TInt aTypefaceIndexAn index identifying the typeface, in the range: 0 to (NumTypefaces() - 1).
TInt aHeightIndexAn index identifying the font height, in the range: 0 to (iNumHeights - 1). Note that iNumHeights is in the TTypefaceSupport object returned by TypefaceSupport().

GetCurrentScreenModeAttributes()

IMPORT_C TSizeModeGetCurrentScreenModeAttributes()const

GetCurrentScreenModeScale()

IMPORT_C TSizeGetCurrentScreenModeScale()const

GetCurrentScreenModeScaledOrigin()

IMPORT_C TPointGetCurrentScreenModeScaledOrigin()const

GetDefaultScreenModeOrigin()

IMPORT_C TPointGetDefaultScreenModeOrigin()const

GetDefaultScreenSizeAndRotation(TPixelsTwipsAndRotation &)

IMPORT_C voidGetDefaultScreenSizeAndRotation(TPixelsTwipsAndRotation &aSizeAndRotation)const

Parameters

TPixelsTwipsAndRotation & aSizeAndRotation

GetDefaultScreenSizeAndRotation(TPixelsAndRotation &)

IMPORT_C voidGetDefaultScreenSizeAndRotation(TPixelsAndRotation &aSizeAndRotation)const

Parameters

TPixelsAndRotation & aSizeAndRotation

GetFontById(CFont *&, TUid, const TAlgStyle &)

IMPORT_C TIntGetFontById(CFont *&aFont,
TUidaUid,
const TAlgStyle &aAlgStyle
)

Parameters

CFont *& aFont
TUid aUid
const TAlgStyle & aAlgStyle

GetInterface(TUint)

IMPORT_C TAny *GetInterface(TUintaInterfaceId)

Parameters

TUint aInterfaceId

GetInterface(TUint)

const TAny *GetInterface(TUintaInterfaceId)const [inline]

Parameters

TUint aInterfaceId

GetNearestFontInPixels(CFont *&, const TFontSpec &)

IMPORT_C TIntGetNearestFontInPixels(CFont *&aFont,
const TFontSpec &aFontSpec
)[virtual]

Gets the font which is the nearest to the given font specification.

When the font is no longer needed, call ReleaseFont().

Note that this deprecated function is replaced by the new GetNearestFontToDesignHeightInPixels() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInPixels() function instead. This will guarantee that every character within any given text string will fit within the given amount of pixels, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.

KErrNone if successful; a system-wide error code otherwise.

Use GetNearestFontToDesignHeightInPixels

Parameters

CFont *& aFontOn return, contains a pointer to the nearest font.
const TFontSpec & aFontSpecThe specification of the font to be matched.

GetNearestFontInTwips(CFont *&, const TFontSpec &)

IMPORT_C TIntGetNearestFontInTwips(CFont *&aFont,
const TFontSpec &aFontSpec
)[virtual]

Parameters

CFont *& aFont
const TFontSpec & aFontSpec

GetNearestFontToDesignHeightInPixels(CFont *&, const TFontSpec &)

IMPORT_C TIntGetNearestFontToDesignHeightInPixels(CFont *&,
const TFontSpec &
)[virtual]

Gets the font which is the nearest to the given font specification.

When the font is no longer needed, call ReleaseFont().

This new function replaces the deprecated GetNearestFontInPixels() yielding (virtually) the same result. However clients are strongly encouraged to use the new GetNearestFontToMaxHeightInPixels() function instead. This will guarantee that every character within any given text string will fit within the given amount of pixels, whereas the design height is an aesthetic unit decided by the font designer without strict physical meaning, which may result in cropped characters.

KErrNone if successful; a system-wide error code otherwise.

Parameters

CFont *&
const TFontSpec &

GetNearestFontToDesignHeightInTwips(CFont *&, const TFontSpec &)

IMPORT_C TIntGetNearestFontToDesignHeightInTwips(CFont *&aFont,
const TFontSpec &aFontSpec
)[virtual]

Parameters

CFont *& aFont
const TFontSpec & aFontSpec

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

IMPORT_C TIntGetNearestFontToMaxHeightInPixels(CFont *&,
const TFontSpec &,
TInt
)[virtual]

Gets the font which is the nearest to the given font specification.

When the font is no longer needed, call ReleaseFont().

The font and bitmap server returns a pointer to the nearest matching font from those available. Matches to max height of font - this does its best to return a font that will fit within the maximum height specified (but note that variations due to hinting algorithms may rarely result in this height being exceeded by up to one pixel). Problems can also be encountered with bitmap fonts where the typeface exists but doesn't have a font small enough.

KErrNone if successful; a system-wide error code otherwise.

Parameters

CFont *&
const TFontSpec &
TInt

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

IMPORT_C TIntGetNearestFontToMaxHeightInTwips(CFont *&aFont,
const TFontSpec &aFontSpec,
TIntaMaxHeight
)[virtual]

Parameters

CFont *& aFont
const TFontSpec & aFontSpec
TInt aMaxHeight

GetPalette(CPalette *&)

IMPORT_C TIntGetPalette(CPalette *&aPalette)const [virtual]

Gets the device's current palette.

This function is only supported if the device has a modifiable palette, which can be determined by calling PaletteAttributes().

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

Parameters

CPalette *& aPaletteOn return, holds the device's current palette.

GetPixel(TRgb &, const TPoint &)

IMPORT_C voidGetPixel(TRgb &aColor,
const TPoint &aPixel
)const [virtual]

Gets the RGB colour of an individual pixel on a bitmapped graphics device.

This pure virtual function is implemented in derived classes.

Parameters

TRgb & aColorOn return, should contain the RGB colour of the pixel.
const TPoint & aPixelThe (x,y) co-ordinates of the pixel. The top left pixel is (0,0).

GetRotationsList(TInt, CArrayFixFlat< TInt > *)

IMPORT_C TIntGetRotationsList(TIntaMode,
CArrayFixFlat< TInt > *aRotationList
)const

Parameters

TInt aMode
CArrayFixFlat< TInt > * aRotationList

GetScanLine(TDes8 &, const TPoint &, TInt, TDisplayMode)

IMPORT_C voidGetScanLine(TDes8 &aBuf,
const TPoint &aStartPixel,
TIntaLength,
TDisplayModeaDispMode
)const [virtual]

Copies a scanline into a buffer.

The pixels are converted from the display mode format on the bitmapped graphics device to the format of the specified device display mode.

By specifying the start pixel and the number of pixels, either the whole or a portion of a bitmapped graphics device pixel row may be copied.

This pure virtual function is implemented in derived classes.

Parameters

TDes8 & aBufAn 8 bit modifiable descriptor buffer into which pixels are copied; it must be sufficiently large to store all the scanline pixels.
const TPoint & aStartPixelThe (x,y) co-ordinates of the first pixel of the bitmap scanline to be put into the buffer.
TInt aLengthThe number of pixels to put into the buffer.
TDisplayMode aDispModeThe display mode into which to convert the pixels.

GetScreenModeDisplayMode(const TInt &)

IMPORT_C TDisplayModeGetScreenModeDisplayMode(const TInt &aMode)const

Parameters

const TInt & aMode

GetScreenModeOrigin(TInt)

IMPORT_C TPointGetScreenModeOrigin(TIntaMode)const

Parameters

TInt aMode

GetScreenModeScale(TInt)

IMPORT_C TSizeGetScreenModeScale(TIntaMode)const

Parameters

TInt aMode

GetScreenModeScaledOrigin(TInt)

IMPORT_C TPointGetScreenModeScaledOrigin(TIntaMode)const

Parameters

TInt aMode

GetScreenModeSizeAndRotation(TInt, TPixelsTwipsAndRotation &)

IMPORT_C voidGetScreenModeSizeAndRotation(TIntaMode,
TPixelsTwipsAndRotation &aSizeAndRotation
)const

Parameters

TInt aMode
TPixelsTwipsAndRotation & aSizeAndRotation

GetScreenModeSizeAndRotation(TInt, TPixelsAndRotation &)

IMPORT_C voidGetScreenModeSizeAndRotation(TIntaMode,
TPixelsAndRotation &aSizeAndRotation
)const

Parameters

TInt aMode
TPixelsAndRotation & aSizeAndRotation

GetScreenNumber()

IMPORT_C TIntGetScreenNumber()const

GetScreenSizeModeList(RArray< TInt > *)

IMPORT_C TIntGetScreenSizeModeList(RArray< TInt > *aModeList)const

Parameters

RArray< TInt > * aModeList

HorizontalPixelsToTwips(TInt)

IMPORT_C TIntHorizontalPixelsToTwips(TIntaPixels)const

Parameters

TInt aPixels

HorizontalTwipsToPixels(TInt)

IMPORT_C TIntHorizontalTwipsToPixels(TIntaTwips)const

Parameters

TInt aTwips

IsCurrentModeDynamic()

IMPORT_C TBoolIsCurrentModeDynamic()const

IsModeDynamic(TInt)

IMPORT_C TBoolIsModeDynamic(TIntaSizeMode)const

Parameters

TInt aSizeMode

NumScreenModes()

IMPORT_C TIntNumScreenModes()const

NumTypefaces()

IMPORT_C TIntNumTypefaces()const [virtual]

Gets the number of typefaces supported by the graphics device.

The number of typefaces supported.

PaletteAttributes(TBool &, TInt &)

IMPORT_C voidPaletteAttributes(TBool &aModifiable,
TInt &aNumEntries
)const [virtual]

Gets the palette attributes of the device.

Parameters

TBool & aModifiableOn return, holds information on whether or not the device's palette is modifiable (ETrue) or fixed (EFalse).
TInt & aNumEntriesOn return, holds the number of entries in the device's palette.

PhysicalScreenSizeInTwips()

TSize PhysicalScreenSizeInTwips()const [private]

PointerRect()

IMPORT_C TRectPointerRect()const

RectCompare(const TRect &, const TRect &)

IMPORT_C TBoolRectCompare(const TRect &aRect1,
const TRect &aRect2
)const

Parameters

const TRect & aRect1
const TRect & aRect2

RectCompare(const TRect &, const TRect &, TUint)

IMPORT_C TBoolRectCompare(const TRect &aRect1,
const TRect &aRect2,
TUintaFlags
)const

Parameters

const TRect & aRect1
const TRect & aRect2
TUint aFlags

ReleaseFont(CFont *)

IMPORT_C voidReleaseFont(CFont *aFont)

Parameters

CFont * aFont

RemoveFile(TInt)

IMPORT_C voidRemoveFile(TIntaId = 0)[virtual]

Removes a font file from the font store.

This pure virtual function is implemented in derived classes.

Parameters

TInt aId = 0The ID of the font file to be removed. The default is 0.

ScreenModeEnforcement()

IMPORT_C TScreenModeEnforcementScreenModeEnforcement()const

SetAppScreenMode(TInt)

IMPORT_C voidSetAppScreenMode(TIntaMode)

Parameters

TInt aMode

SetBackLight(TBool)

IMPORT_C TIntSetBackLight(TBoolaBackLight)

Parameters

TBool aBackLight

SetCurrentRotations(TInt, CFbsBitGc::TGraphicsOrientation)

IMPORT_C voidSetCurrentRotations(TIntaMode,
CFbsBitGc::TGraphicsOrientationaRotation
)const

Parameters

TInt aMode
CFbsBitGc::TGraphicsOrientation aRotation

SetCurrentScreenModeAttributes(const TSizeMode &)

IMPORT_C voidSetCurrentScreenModeAttributes(const TSizeMode &aModeAtt)

Parameters

const TSizeMode & aModeAtt

SetCustomPalette(const CPalette *)

IMPORT_C TIntSetCustomPalette(const CPalette *aPalette)

Parameters

const CPalette * aPalette

SetPalette(CPalette *)

IMPORT_C voidSetPalette(CPalette *aPalette)[virtual]

Sets the device's palette.

Setting the palette is only possible if the device has a modifiable palette, which can be determined by calling PaletteAttributes().

Parameters

CPalette * aPaletteThe new palette for the device.

SetScreenMode(TInt)

IMPORT_C voidSetScreenMode(TIntaMode)

Parameters

TInt aMode

SetScreenModeEnforcement(TScreenModeEnforcement)

IMPORT_C voidSetScreenModeEnforcement(TScreenModeEnforcementaMode)const

Parameters

TScreenModeEnforcement aMode

SetScreenSizeAndRotation(const TPixelsTwipsAndRotation &)

IMPORT_C voidSetScreenSizeAndRotation(const TPixelsTwipsAndRotation &aSizeAndRotation)

Parameters

const TPixelsTwipsAndRotation & aSizeAndRotation

SetScreenSizeAndRotation(const TPixelsAndRotation &)

IMPORT_C voidSetScreenSizeAndRotation(const TPixelsAndRotation &aSizeAndRotation)

Parameters

const TPixelsAndRotation & aSizeAndRotation

SizeInPixels()

IMPORT_C TSizeSizeInPixels()const [virtual]

Gets the size of the device area in pixels.

The width and height of the device area, in pixels

SizeInTwips()

IMPORT_C TSizeSizeInTwips()const [virtual]

Gets the size of the device area in twips.

The width and height of the device area, in twips

TypeFaceStore()

CFbsTypefaceStore *TypeFaceStore()const [private]

TypefaceSupport(TTypefaceSupport &, TInt)

IMPORT_C voidTypefaceSupport(TTypefaceSupport &aTypefaceSupport,
TIntaTypefaceIndex
)const [virtual]

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

NumTypefaces()

Parameters

TTypefaceSupport & aTypefaceSupportOn return, contains the typeface information.
TInt aTypefaceIndexA typeface index number, in the range: zero to (NumTypefaces() - 1).

VerticalPixelsToTwips(TInt)

IMPORT_C TIntVerticalPixelsToTwips(TIntaPixels)const

Parameters

TInt aPixels

VerticalTwipsToPixels(TInt)

IMPORT_C TIntVerticalTwipsToPixels(TIntaTwips)const

Parameters

TInt aTwips

Member Enumerations Documentation

Enum TSpriteInCompare

Whether or not to include sprites when comparing areas of the screen

Enumerators

ERemoveSprite = 0

This enum can be specified as the 3rd parameter to CWsScreenDevice::RectCompare(const TRect &aRect1, const TRect &aRect2,TUint aFlags). When called with the value ERemoveSprite if there are any sprites visible in the areas of the screen being compared then these will not be included in the comparison. The function CWsScreenDevice::RectCompare(const TRect &aRect1,const TRect &aRect2) will not include sprites in the comparison.

EIncludeSprite = 1

This enum can be specified as the 3rd parameter to CWsScreenDevice::RectCompare(const TRect &aRect1, const TRect &aRect2,TUint aFlags). When called with the value EIncludeSprite if there are any sprites visible in the areas of the screen being compared then these will be included in the comparison.

EIncludeTextCursor = 2

This enum can be specified as the 3rd parameter to CWsScreenDevice::RectCompare(const TRect &aRect1, const TRect &aRect2,TUint aFlags). When called with the value EIncludeTextCursor if there are any text cursors visible in the areas of the screen being compared then these will be included in the comparison.

Member Data Documentation

TSize iDisplaySizeInPixels

TSize iDisplaySizeInPixels[private]

CScrDevExtension * iExtension

CScrDevExtension *iExtension[private]

TSize iPhysicalScreenSizeInTwips

TSize iPhysicalScreenSizeInTwips[private]