Symbian
Symbian Developer Library

SYMBIAN OS V9.4

Feedback

[Index] [Previous] [Next]

#include <W32STDGRAPHIC.H>
Link against: w32stdgraphic.lib
This item is not part of the S60 5th Edition SDK

Class CWsGraphicBitmap

class CWsGraphicBitmap : public CWsGraphic;

Description

Client representation of a window-server-side CFbsBitmap owned by this Client

Derivation

Members

Defined in CWsGraphicBitmap:

Inherited from CBase:

Inherited from CWsGraphic:


Construction and destruction


NewL(const CFbsBitmap *,const CFbsBitmap *)

IMPORT_C static CWsGraphicBitmap* NewL(const CFbsBitmap *aBitmap, const CFbsBitmap *aMask);

Description

Constructs the client representation of a window-server-side CFbsBitmap owned by this Client. The base class CWsGraphic is therefore constructed having KStdBitmapType as artwork type.

Parameters

const CFbsBitmap *aBitmap

CFbsBitmap owned by the Client

const CFbsBitmap *aMask

Bitmap's Mask.

Return value

CWsGraphicBitmap *


NewL(TUid,const CFbsBitmap *,const CFbsBitmap *)

IMPORT_C static CWsGraphicBitmap* NewL(TUid aUid, const CFbsBitmap *aBitmap, const CFbsBitmap *aMask);

Description

Constructs the client representation of a window-server-side CFbsBitmap owned by this Client. The base class CWsGraphic is therefore constructed having KStdBitmapType as artwork type.

Parameters

TUid aUid

Graphic Bitmap UID.

const CFbsBitmap *aBitmap

CFbsBitmap owned by the Client

const CFbsBitmap *aMask

Bitmap's Mask.

Return value

CWsGraphicBitmap *


NewL(const TWsGraphicId &,const CFbsBitmap *,const CFbsBitmap *)

IMPORT_C static CWsGraphicBitmap* NewL(const TWsGraphicId &aReplace, const CFbsBitmap *aBitmap, const CFbsBitmap *aMask);

Description

Constructs the client representation of a window-server-side CFbsBitmap owned by this Client. The base class CWsGraphic is therefore constructed having KStdBitmapType as artwork type.

Atomically replace the artwork that already exists with this artwork (i.e. aBitmap) . If failure to properly construct the replacement artwork occurs, the replacee artwork will remain

Parameters

const TWsGraphicId &aReplace

Bitmap artwork which will be replaced.

const CFbsBitmap *aBitmap

CFbsBitmap owned by the Client

const CFbsBitmap *aMask

Bitmap's Mask.

Return value

CWsGraphicBitmap *


~CWsGraphicBitmap()

IMPORT_C ~CWsGraphicBitmap();

Description

[Top]


Member functions


ShareGlobally()

IMPORT_C virtual TInt ShareGlobally();

Description

Shares the graphic artwork with all the client sessions. Sharing globally trumps explicit shares.

Return value

TInt

KErrNone if the graphic is globally shared, else one of the system-wide error codes.


UnShareGlobally()

IMPORT_C virtual TInt UnShareGlobally();

Description

Prevents this graphic artwork from being shared with all the client sessions. A graphic artwork that isn't shared explicitly is only available to clients it has been explicitly shared with using CWsGraphicBitmap::Share(TSecureId).

Return value

TInt

KErrNone if the graphic is not globally shared, else one of the system-wide error codes.


Share(TSecureId)

IMPORT_C virtual TInt Share(TSecureId aClientId);

Description

Explicitly shares this graphic artwork with client sessions with the specified Secure ID.

Parameters

TSecureId aClientId

the Secure ID of the client sessions to share with.

Return value

TInt

KErrNone If the graphic artwork was shared, else one of the system-wide error codes.


UnShare(TSecureId)

IMPORT_C virtual TInt UnShare(TSecureId aClientId);

Description

Stops this graphic artwork from being shared with all client sessions with the specific Secure ID. CWsGraphicBitmap::ShareGlobally() trumps explicit sharing.

Parameters

TSecureId aClientId

the Secure ID of the client sessions to not share with

Return value

TInt

KErrNone if the graphic artwork is no longer shared, KErrNotFound if the graphic was not shared anyway, else one of the system-wide error codes


HandleMessage(const TDesC8 &)

private: virtual void HandleMessage(const TDesC8 &aData);

Description

Handles message from this graphic artwork peer on the server.

Parameters

const TDesC8 &aData

Message from peer CWsGraphicDrawer.


OnReplace()

private: virtual void OnReplace();

Description

Handles custom operation when this graphic artwork is replaced. When this method is invoked, the replaced peer CWsGraphicDrawer on the server has been destroyed.