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(CLogViewDuplicate &,TRequestStatus &)Refreshes the specified duplicate event view with the duplicates of the current ...
• DuplicatesL(CLogViewDuplicate &,const CLogFilter &,TRequestStatus &)Refreshes the specified duplicate event view with the duplicates of the current ...
• DuplicatesL(CLogViewDuplicate &,const CLogFilterList &,TRequestStatus &)Refreshes the specified duplicate event view with the duplicates of the current ...
• NewL(CLogClient &,MLogViewChangeObserver &,TInt)
• NewL(CLogClient &,TInt)
• RecentList()constGets the recent event list number that identifies the recent event list to which...
• RemoveL(TLogId)Removes the event with the specified unique event ID from the view. This does no...
• RemoveL(TRequestStatus &)Removes the current event from its recent event list. This is an asynchronous re...
• SetRecentListL(TLogRecentList,TRequestStatus &)Initialises or refreshes the view for the specified recent event list. This is a...
• SetRecentListL(TLogRecentList,const CLogFilter &,TRequestStatus &)Initialises or refreshes the view for the specified recent event list, conformin...
• SetRecentListL(TLogRecentList,const CLogFilterList &,TRequestStatus &)Initialises or refreshes the view for the specified recent event list, conformin...
• ~CLogViewRecent()Frees resources owned by the object priot to its destruction.

Inherited from CActive:

• CActive(TInt)Constructs the active object with the specified priority.
• Cancel()Cancels the wait for completion of an outstanding request.
• Deque()Removes the active object from the active scheduler's list of active objects.
• EPriorityHighA priority higher than EPriorityUserInput.
• EPriorityIdleA low priority, useful for active objects representing background processing.
• EPriorityLowA priority higher than EPriorityIdle but lower than EPriorityStandard.
• EPriorityStandardMost active objects will have this priority.
• EPriorityUserInputA priority higher than EPriorityStandard; useful for active objects handling use...
• Extension_(TUint,TAny *&,TAny *)Extension function
• IsActive()constDetermines whether the active object has a request outstanding.
• IsAdded()constDetermines whether the active object has been added to the active scheduler's li...
• Priority()constGets the priority of the active object.
• RunError(TInt)Handles a leave occurring in the request completion event handler CActive::RunL(...
• RunL()Handles an active object's request completion event.
• SetActive()Indicates that the active object has issued a request and that it is now outstan...
• SetPriority(TInt)Sets the priority of the active object.
• TPriorityDefines standard priorities for active objects.
• iStatusThe request status associated with an asynchronous request.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

Inherited from CLogActive:

• CLogActive(TInt)
• Complete(TInt)
• Queue(TRequestStatus &)

Inherited from CLogView:

• CountL()Gets the number of events in the view.
• DoCancel()Implements cancellation of an outstanding request.
• Event()constReturns details of the log event at the current position within the view.
• FirstL(TRequestStatus &)Moves the current position in the view to the first event. The first event is th...
• IsValid()const
• LastL(TRequestStatus &)Moves the current position in the view to the last event. The last event is the ...
• NextL(TRequestStatus &)Moves the current position in the view to the next event. The next event is alwa...
• PreviousL(TRequestStatus &)Moves the current position in the view to the previous event. The previous event...
• SetFlagsL(TLogFlags)
• iClient
• iData
• iMaintain
• iPackage
• iSpare2
• iValid
• iViewId
• iWindow

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

Description

Parameters

CLogClient &aClient TInt aPriority

Return value

CLogViewRecent *

IMPORT_C static 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 CLogViewRecent::SetRecentListL(TLogRecentList,TRequestStatus &) functions.

Return value

TLogRecentList The recent event list number.

private: virtual void DoRunL();

Description