Class CLogViewEvent

CLogViewEvent

Support

Supported from 6.0

Description

A view on the event log.

The events included in the view are defined using a filter that specifies the constraints that all events in the view must satisfy. Filters are specified using one or more CLogFilter objects.

Derivation

CActive The core class of the active object abstraction CBase Base class for all classes to be instantiated on the heap CLogActive Common active object behaviour CLogView Navigates a view on the log database CLogViewEvent A view on the event log

Defined in CLogViewEvent:
NewL(), SetFilterL(), ~CLogViewEvent()

Inherited from CActive:
Cancel(), Deque(), DoCancel(), EPriorityHigh, EPriorityIdle, EPriorityLow, EPriorityStandard, EPriorityUserInput, IsActive(), IsAdded(), Priority(), RunError(), RunL(), SetActive(), SetPriority(), TPriority, iStatus

Inherited from CBase:
operator new()

Inherited from CLogView:
CountL(), Event(), FirstL(), LastL(), NextL(), PreviousL()

See also:

• CLogFilter
• CLogFilterList

static CLogViewEvent* NewL(CLogClient& aClient, TInt aPriority = CActive::EPriorityStandard);

Description

Creates a new view on the event log.

After construction, the view is empty.

Parameters

CLogClient& aClient The Log Engine. The log database for which a view is constructed, is accessed through the Log Engine. TInt aPriority = CActive::EPriorityStandard The priority of this active object. By default, this is the standard active object priority.

Return value

CLogViewEvent* A pointer to the new event log view object.

~CLogViewEvent();

Description

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

TBool SetFilterL(const CLogFilter& aFilter, TRequestStatus& aStatus);

Description

Initialises or refreshes the event view defined by the specified filter.

The view can only be used after the request completes successfully.

Parameters

const CLogFilter& aFilter The filter. TRequestStatus& aStatus The request status. On request completion, contains:KErrNone, if the view has been successfully initialised or refreshed;one of the other system wide error codes, otherwise.

Return value

TBool True, if the function has successfully issued the asynchronous request. False, if there are no events in the view.

TBool SetFilterL(const CLogFilterList& aFilterList, TRequestStatus& aStatus);

Description

Initialises or refreshes the event view defined by the set of specified filters.

The view can only be used after the request completes successfully.

Parameters

const CLogFilterList& aFilterList The set of filters. TRequestStatus& aStatus The request status. On request completion, contains:KErrNone, if the view has been successfully initialised or refreshed;one of the other system wide error codes, otherwise.

Return value

TBool True, if the function has successfully issued the asynchronous request. False, if there are no events in the view.