Class CLogViewRecent

class CLogViewRecent : public CLogView;

Description

A view on a recent event list.

Derivation

• CBase - Base class for all classes to be instantiated on the heap

• CActive - The core class of the active object abstraction

• CLogActive - Common active object behaviour

• CLogView - Navigates a view on the log database

• CLogViewRecent - A view on a recent event list

Members

Defined in CLogViewRecent:
ClearDuplicatesL(), DoRunL(), DuplicatesL(), DuplicatesL(), DuplicatesL(), NewL(), NewL(), RecentList(), RemoveL(), RemoveL(), SetRecentListL(), SetRecentListL(), SetRecentListL(), ~CLogViewRecent()

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

Inherited from CBase:
Delete(), operator new()

Inherited from CLogActive:
Complete(), DoComplete(), Queue(), RunL()

Inherited from CLogView:
CountL(), DoCancel(), Event(), FirstL(), IsValid(), LastL(), NextL(), PreviousL(), SetFlagsL(), iClient, iData, iMaintain, iPackage, iSpare2, iValid, iViewId, iWindow

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

Description

Parameters

CLogClient &aClient TInt aPriority

Return value

CLogViewRecent *

static IMPORT_C CLogViewRecent *NewL(CLogClient &aClient, MLogViewChangeObserver &aObserver, TInt aPriority=CActive::EPriorityStandard);

Description

Parameters

CLogClient &aClient MLogViewChangeObserver &aObserver TInt aPriority

Return value

CLogViewRecent *

IMPORT_C ~CLogViewRecent();

Description

Frees resources owned by the object priot to its destruction.

Capability:

Security policy note:

None required.

IMPORT_C TBool SetRecentListL(TLogRecentList aList, TRequestStatus &aStatus);

Description

Initialises or refreshes the view for the specified recent event list. This is an asynchronous request.

On successful completion, the view is positioned at the first, i.e. most recent, event within the recent event list.

Parameters

TLogRecentList aList The recent event list specifier. A value of KLogNullRecentList indicates that the view is to include events from all of the recent event lists. TRequestStatus &aStatus The request status. On request completion, contains:KErrNone, if the view has been successfully initialised or refreshed; otherwise, one of the other system wide error codes.

Return value

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

Capability:

Security policy note:

None required.

IMPORT_C TBool SetRecentListL(TLogRecentList aList, const CLogFilter &aFilter, TRequestStatus &aStatus);

Description

Initialises or refreshes the view for the specified recent event list, conforming to the specified filter. This is an asynchronous request.

On successful completion, the view is positioned at the first, i.e. most recent, event in the recent event list.

Parameters

TLogRecentList aList The recent event list specifier. A value of KLogNullRecentList indicates that the view is to include events from all of the recent event lists. const CLogFilter &aFilter The filter. TRequestStatus &aStatus The request status. On request completion, contains:KErrNone, if the view has been successfully initialised or refreshed; otherwise, one of the other system wide error codes.

Return value

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

Capability:

Security policy note:

None required.

IMPORT_C TBool SetRecentListL(TLogRecentList aList, const CLogFilterList &aFilterList, TRequestStatus &aStatus);

Description

Initialises or refreshes the view for the specified recent event list, conforming to the set of specified filters. This is an asynchronous request.

On successful completion, the view is positioned at the first, i.e. most recent, event in the recent event list.

Parameters

TLogRecentList aList The recent event list specifier. A value of KLogNullRecentList indicates that the view is to include events from all of the recent event lists. 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; otherwise, one of the other system wide error codes.

Return value

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

Capability:

Security policy note:

None required.

IMPORT_C TBool DuplicatesL(CLogViewDuplicate &aView, TRequestStatus &aStatus);

Description

Refreshes the specified duplicate event view with the duplicates of the current event in the recent event list view. This is an asynchronous request.

On successful completion, the view is positioned at the first, i.e. most recent, event within the view.

Parameters

CLogViewDuplicate &aView The duplicates view to be refreshed. TRequestStatus &aStatus The request status. On request completion, contains:KErrNone, if the view has been successfully refreshed; otherwise, one of the other system wide error codes.

Return value

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

Capability:

Security policy note:

None required.

IMPORT_C TBool DuplicatesL(CLogViewDuplicate &aView, const CLogFilter &aFilter, TRequestStatus &aStatus);

Description

Refreshes the specified duplicate event view with the duplicates of the current event in the recent event list view and conforming to the specified filter. This is an asynchronous request.

On successful completion, the view is positioned at the first, i.e. most recent, event within the view.

Parameters

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

Return value

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

Capability:

Security policy note:

None required.

IMPORT_C TBool DuplicatesL(CLogViewDuplicate &aView, const CLogFilterList &aFilterList, TRequestStatus &aStatus);

Description

Refreshes the specified duplicate event view with the duplicates of the current event in the recent event list view and conforming to the set of specified filters. This is an asynchronous request.

On successful completion, the view is positioned at the first, i.e. most recent, event within the view.

Parameters

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

Return value

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

Capability:

WriteDeviceData

IMPORT_C void ClearDuplicatesL();

Description

Capability:

WriteDeviceData

IMPORT_C void RemoveL(TLogId aId);

Description

Removes the event with the specified unique event ID from the view. This does not delete the event from the main event log.

Parameters

TLogId aId The unique event ID.

Capability:

WriteDeviceData

IMPORT_C TBool RemoveL(TRequestStatus &aStatus);

Description

Removes the current event from its recent event list. This is an asynchronous request.

This does not delete the event from the main event log.

The function moves the current position in the view to the first, i.e. most recent, event.

Note that removing a recent event from a recent event list also removes all of its duplicates.

Parameters

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

Return value

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

inline TLogRecentList RecentList() const;

Description

Gets the recent event list number that identifies the recent event list to which the current entry belongs. This is an asynchronous request.

Note that this function is only useful if KLogNullRecentList is passed to the SetRecentListL() functions.

Return value

TLogRecentList The recent event list number.

private: virtual void DoRunL();

Description