CGSShimmedView Class Reference

class CGSShimmedView : public CActive

CGSShimmedView is used by CGSPluginAndViewIdCache to provide view-framework with all existing plugin views immediately in GS start-up. Shimmed views are used to cache actual views: in case GS view is opened outside GS application while GS is not running in the background, view-framework needs the requested view to exist immediately after GS start-up. This is a problem as GS loads plugins asynchronously after GS start-up. Therefore we provide view-framework with shimmed views in the GS start-up instead of the actual views. Afterwards, when each plugin is loaded, we replace the shimmed view representing the plugin with a real view provided by the loaded plugin. (Each plugin is normally also a view).

Shimmed views are only used and needed for enabling external GS plugin view launch.

See CGSPluginAndViewIdCache for details.

Since
Series60_3.1

Inherits from

Constructor & Destructor Documentation

CGSShimmedView(TUid, CGSPluginAndViewIdCache &, CCoeAppUi &)

CGSShimmedView ( TUid aViewId,
CGSPluginAndViewIdCache & aCache,
CCoeAppUi & aAppUi
) [private]

C++ constructor

Parameters

TUid aViewId
CGSPluginAndViewIdCache & aCache
CCoeAppUi & aAppUi

~CGSShimmedView()

~CGSShimmedView ( )

Destructor.

Member Functions Documentation

ConstructL()

void ConstructL ( ) [private]

Second phase constructor

DeregisterView()

void DeregisterView ( )

DoCancel()

void DoCancel ( ) [private, virtual]

Implements cancellation of an outstanding request.

This function is called as part of the active object's Cancel() .

It must call the appropriate cancel function offered by the active object's asynchronous service provider. The asynchronous service provider's cancel is expected to act immediately.

DoCancel() must not wait for event completion; this is handled by Cancel() .

CActive::Cancel

NewLC(TUid, CGSPluginAndViewIdCache &, CCoeAppUi &)

CGSShimmedView * NewLC ( TUid aViewId,
CGSPluginAndViewIdCache & aCache,
CCoeAppUi & aAppUi
) [static]

Parameters

TUid aViewId
CGSPluginAndViewIdCache & aCache
CCoeAppUi & aAppUi

RegisterViewL()

void RegisterViewL ( )

RunL()

void RunL ( ) [private, virtual]

Handles an active object's request completion event.

A derived class must provide an implementation to handle the completed request. If appropriate, it may issue another request.

The function is called by the active scheduler when a request completion event occurs, i.e. after the active scheduler's WaitForAnyRequest() function completes.

Before calling this active object's RunL() function, the active scheduler has:

1. decided that this is the highest priority active object with a completed request

2. marked this active object's request as complete (i.e. the request is no longer outstanding)

RunL() runs under a trap harness in the active scheduler. If it leaves, then the active scheduler calls RunError() to handle the leave.

Note that once the active scheduler's Start() function has been called, all user code is run under one of the program's active object's RunL() or RunError() functions.

CActiveScheduler::Start CActiveScheduler::Error CActiveScheduler::WaitForAnyRequest TRAPD

SetState(TState, TBool)

void SetState ( TState aState,
TBool aCompleteRequest = ETrue
) [private]

Parameters

TState aState
TBool aCompleteRequest = ETrue

StateActivatePlaceholderViewL()

void StateActivatePlaceholderViewL ( ) [private]

StateLoadPluginL()

void StateLoadPluginL ( ) [private]

ViewActivatedL(const TVwsViewId &, TUid, const TDesC8 &)

void ViewActivatedL ( const TVwsViewId & aPrevViewId,
TUid aCustomMessageId,
const TDesC8 & aCustomMessage
)

Parameters

const TVwsViewId & aPrevViewId
TUid aCustomMessageId
const TDesC8 & aCustomMessage

ViewDeactivated()

void ViewDeactivated ( )

ViewId()

TVwsViewId ViewId ( ) const

Member Enumerations Documentation

Enum TState

Enumerators

EStateInactive = 0
EStateActivatingPlaceholderView
EStateLoadingPlugin
EStateDeletingSelf

Member Data Documentation

CCoeAppUi & iAppUi

CCoeAppUi & iAppUi [private]

CGSPluginAndViewIdCache & iCache

CGSPluginAndViewIdCache & iCache [private]

HBufC8 * iCustomMessage

HBufC8 * iCustomMessage [private]

TUid iCustomMessageId

TUid iCustomMessageId [private]

TBool iIsRegistered

TBool iIsRegistered [private]

TState iState

TState iState [private]

TUid iViewId

TUid iViewId [private]