CLogView Class Reference

class CLogView : public CLogActive

Navigates a view on the log database.

The class provides functions for navigating through a set of events and a function to retrieve the event at the current position within the view.

The class cannot be instantiated. Further classes are derived from this class to define and construct views on the log database.

The set of events in a view are always ordered so that the first event in a view is the most recent.

Inherits from

Public Member Functions
~CLogView()
IMPORT_C TIntCountL()
const CLogEvent &Event()
IMPORT_C TBoolFirstL(TRequestStatus &)
IMPORT_C TBoolLastL(TRequestStatus &)
IMPORT_C TBoolNextL(TRequestStatus &)
IMPORT_C TBoolPreviousL(TRequestStatus &)
IMPORT_C voidSetFlagsL(TLogFlags)
Protected Member Functions
CLogView(CLogClient &, TInt)
voidConstructL(TInt, MLogViewChangeObserver *)
voidDoCancel()
TBool IsValid()
TInt LogViewRecordCount()
voidReadEventFromWindowL()
voidReawaitForChanges()
Private Member Functions
voidDoRunL()
TBool NavigateL(TInt, TRequestStatus &)
voidNotifyLogServerTerminatedL()
voidPrepareViewChildrenL()
Inherited Functions
CActive::CActive(TInt)
CActive::Cancel()
CActive::Deque()
CActive::Extension_(TUint,TAny *&,TAny *)
CActive::IsActive()const
CActive::IsAdded()const
CActive::Priority()const
CActive::RunError(TInt)
CActive::SetActive()
CActive::SetPriority(TInt)
CActive::~CActive()
CBase::CBase()
CBase::Delete(CBase *)
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()
CLogActive::CLogActive(TInt)
CLogActive::Complete(TInt)
CLogActive::Queue(TRequestStatus &)
CLogActive::~CLogActive()
Inherited Enumerations
CActive:TPriority
Protected Attributes
CLogClient &iClient
TDes8 *iData
CLogMaintainClientOp *iMaintain
CLogPackage *iPackage
TAny *iSpare2
TBool iValid
TLogViewId iViewId
CLogViewWindow *iWindow
Private Attributes
CLogEvent *iEvent
MLogViewChangeObserver *iLogViewChangeObserver
CLogViewObserver *iLogViewObserver
TAny *iSpare1
TInt iType
Inherited Attributes
CActive::iStatus

Constructor & Destructor Documentation

CLogView(CLogClient &, TInt)

CLogView(CLogClient &aClient,
TIntaPriority = CActive::EPriorityStandard
)[protected]

Parameters

CLogClient & aClient
TInt aPriority = CActive::EPriorityStandard

~CLogView()

IMPORT_C~CLogView()

Frees all resources owned by this object prior to its destruction. In particular, any outstanding asynchronous request is cancelled.

Member Functions Documentation

ConstructL(TInt, MLogViewChangeObserver *)

voidConstructL(TIntaType,
MLogViewChangeObserver *aObserver = NULL
)[protected]

Parameters

TInt aType
MLogViewChangeObserver * aObserver = NULL

CountL()

IMPORT_C TIntCountL()

Gets the number of events in the view.

DoCancel()

voidDoCancel()[protected, 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

DoRunL()

voidDoRunL()[private, virtual]

Event()

const CLogEvent &Event()const [inline]

Returns details of the log event at the current position within the view.

FirstL(TRequestStatus &)

IMPORT_C TBoolFirstL(TRequestStatus &aStatus)

Moves the current position in the view to the first event. The first event is the most recent event.

This is an asynchronous request.

Parameters

TRequestStatus & aStatusThe request status. On request completion, contains:KErrNone, if the position in the view has been successfully moved; otherwise, one of the other system wide error codes.

IsValid()

TBool IsValid()const [protected, inline]

LastL(TRequestStatus &)

IMPORT_C TBoolLastL(TRequestStatus &aStatus)

Moves the current position in the view to the last event. The last event is the oldest event.

This is an asynchronous request.

Parameters

TRequestStatus & aStatusThe request status. On request completion, contains:KErrNone, if the position in the view has been successfully moved; otherwise, one of the other system wide error codes.

LogViewRecordCount()

TInt LogViewRecordCount()const [protected]

NavigateL(TInt, TRequestStatus &)

TBool NavigateL(TIntaPosition,
TRequestStatus &aStatus
)[private]

Parameters

TInt aPosition
TRequestStatus & aStatus

NextL(TRequestStatus &)

IMPORT_C TBoolNextL(TRequestStatus &aStatus)

Moves the current position in the view to the next event. The next event is always older than the current event, i.e. next implies movement in the first to last direction.

Parameters

TRequestStatus & aStatusThe request status. On request completion, contains:KErrNone, if the position in the view has been successfully moved; otherwise, one of the other system wide error codes.

NotifyLogServerTerminatedL()

voidNotifyLogServerTerminatedL()[private]

PrepareViewChildrenL()

voidPrepareViewChildrenL()[private]

PreviousL(TRequestStatus &)

IMPORT_C TBoolPreviousL(TRequestStatus &aStatus)

Moves the current position in the view to the previous event. The previous event is always more recent than the current event, i.e. previous implies movement in the last to first direction.

Parameters

TRequestStatus & aStatusThe request status. On request completion, contains:KErrNone, if the position in the view has been successfully moved; otherwise, one of the other system wide error codes.

ReadEventFromWindowL()

voidReadEventFromWindowL()[protected]

ReawaitForChanges()

voidReawaitForChanges()[protected]

SetFlagsL(TLogFlags)

IMPORT_C voidSetFlagsL(TLogFlagsaFlags)
capability
Note For built-in event types, the required capability level is defined in the event type's write access policy.

Parameters

TLogFlags aFlags

Member Data Documentation

CLogClient & iClient

CLogClient &iClient[protected]

TDes8 * iData

TDes8 *iData[protected]

CLogEvent * iEvent

CLogEvent *iEvent[private]

MLogViewChangeObserver * iLogViewChangeObserver

MLogViewChangeObserver *iLogViewChangeObserver[private]

CLogViewObserver * iLogViewObserver

CLogViewObserver *iLogViewObserver[private]

CLogMaintainClientOp * iMaintain

CLogMaintainClientOp *iMaintain[protected]

CLogPackage * iPackage

CLogPackage *iPackage[protected]

TAny * iSpare1

TAny *iSpare1[private]

TAny * iSpare2

TAny *iSpare2[protected]

TInt iType

TInt iType[private]

TBool iValid

TBool iValid[protected]

TLogViewId iViewId

TLogViewId iViewId[protected]

CLogViewWindow * iWindow

CLogViewWindow *iWindow[protected]