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 TInt CountL ()
const CLogEvent & Event ()
IMPORT_C TBool FirstL ( TRequestStatus &)
IMPORT_C TBool LastL ( TRequestStatus &)
IMPORT_C TBool NextL ( TRequestStatus &)
IMPORT_C TBool PreviousL ( TRequestStatus &)
IMPORT_C void SetFlagsL ( TLogFlags )
Protected Member Functions
CLogView ( CLogClient &, TInt )
void ConstructL ( TInt , MLogViewChangeObserver *)
void DoCancel ()
TBool IsValid ()
TInt LogViewRecordCount ()
void ReadEventFromWindowL ()
void ReawaitForChanges ()
Private Member Functions
void DoRunL ()
TBool NavigateL ( TInt , TRequestStatus &)
void NotifyLogServerTerminatedL ()
void PrepareViewChildrenL ()
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,
TInt aPriority = 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 *)

void ConstructL ( TInt aType,
MLogViewChangeObserver * aObserver = NULL
) [protected]

Parameters

TInt aType
MLogViewChangeObserver * aObserver = NULL

CountL()

IMPORT_C TInt CountL ( )

Gets the number of events in the view.

DoCancel()

void DoCancel ( ) [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()

void DoRunL ( ) [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 TBool FirstL ( 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 & aStatus The 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 TBool LastL ( 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 & aStatus The 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 ( TInt aPosition,
TRequestStatus & aStatus
) [private]

Parameters

TInt aPosition
TRequestStatus & aStatus

NextL(TRequestStatus &)

IMPORT_C TBool NextL ( 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 & aStatus The 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()

void NotifyLogServerTerminatedL ( ) [private]

PrepareViewChildrenL()

void PrepareViewChildrenL ( ) [private]

PreviousL(TRequestStatus &)

IMPORT_C TBool PreviousL ( 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 & aStatus The 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()

void ReadEventFromWindowL ( ) [protected]

ReawaitForChanges()

void ReawaitForChanges ( ) [protected]

SetFlagsL(TLogFlags)

IMPORT_C void SetFlagsL ( TLogFlags aFlags )
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]