CLogEvent Class Reference

#include <logwrap.h>

class CLogEvent : public CBase

Inherits from

CLogEvent

Public Member Functions
	~CLogEvent()
void	ClearFlags(TLogFlags)
TLogContactItemId	Contact()
IMPORT_C void	CopyL(const CLogEvent &)
const TDesC8 &	Data()
const TDesC &	Description()
const TDesC &	Direction()
TLogDuration	Duration()
TLogDurationType	DurationType()
TUid	EventType()
IMPORT_C void	ExternalizeL(RWriteStream &)
TLogFlags	Flags()
TLogId	Id()
IMPORT_C void	InternalizeL(RReadStream &)
TLogLink	Link()
IMPORT_C CLogEvent *	NewL()
const TDesC &	Number()
const TDesC &	RemoteParty()
void	SetContact(TLogContactItemId)
IMPORT_C void	SetDataL(RReadStream &, TInt)
IMPORT_C void	SetDataL(const TDesC8 &)
void	SetDescription(const TDesC &)
void	SetDirection(const TDesC &)
void	SetDuration(TLogDuration)
void	SetDurationType(TLogDurationType)
void	SetEventType(TUid)
void	SetFlags(TLogFlags)
void	SetId(TLogId)
void	SetLink(TLogLink)
void	SetNumber(const TDesC &)
void	SetRemoteParty(const TDesC &)
IMPORT_C void	SetSimId(TSimId)
void	SetStatus(const TDesC &)
void	SetSubject(const TDesC &)
void	SetTime(const TTime &)
IMPORT_C TSimId	SimId()
const TDesC &	Status()
const TDesC &	Subject()
const TTime &	Time()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	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()

Detailed Description

Encapsulates the details of an event.

Where time is used, it must be specified as UTC rather than local time.

Constructor & Destructor Documentation

~CLogEvent ( )

IMPORT_C

~CLogEvent

(

)

Frees all resources owned by the log event detail object.

Member Function Documentation

ClearFlags ( TLogFlags )

void

ClearFlags

(

TLogFlags

aFlags

)

[inline]

Clears the specified flags for this event.

The function does not change any of the other flag bit settings.

The constant KLogFlagsMask may be used to clear all the flags in an event.

Parameter	Description
aFlags	The flags to be cleared.

Contact ( )

TLogContactItemId

Contact

(

)

const [inline]

Gets the contact ID associated with the event.

Returns: The contact ID.

CopyL ( const CLogEvent & )

IMPORT_C void

CopyL

(

const CLogEvent &

aEvent

)

Makes a copy of the specified log event.

Parameter	Description
aEvent	The log event to be copied.

Data ( )

const TDesC8 &

Data

(

)

const [inline]

Gets event specific data.

Returns: A reference to a non-modifiable descriptor containing the data that is specific to the event.KNullDesC8, if there is no data.

Description ( )

const TDesC &

Description

(

)

const [inline]

Gets the human readable name describing the event type.

Note that this is set automatically by the Log Engine.

Returns: A reference to a non-modifiable descriptor containing the readable name.

Direction ( )

const TDesC &

Direction

(

)

const [inline]

Gets the direction of the call represented by this event. The direction of a call means incoming, outgoing etc.

The direction is represented by a string.

Returns: A reference to a non-modifiable descriptor containing the string representing the direction of the call.

Duration ( )

TLogDuration

Duration

(

)

const [inline]

Gets the duration of the event.

Returns: The duration of the event, expressed as the number of seconds since the time of the event.

DurationType ( )

TLogDurationType

DurationType

(

)

const [inline]

Gets the duration type.

This applies meaning to the idea of a duration.

The duration type is implemented as a UI variant-specific enumeration. The following duration types are generic: KLogDurationNone, KLogDurationValid and KLogDurationData.

Returns: The duration type.

EventType ( )

TUid

EventType

(

)

const [inline]

Gets the type of this log event. Event types are identified by a UID.

ExternalizeL ( RWriteStream & )

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

const

Flags ( )

TLogFlags

Flags

(

)

const [inline]

Gets the flags set for this event.

Returns: The flags.

Id ( )

TLogId

(

)

const [inline]

Gets the unique event ID associated with this log event.

Unique event IDs are allocated by the Log Engine when an event is added to the log.

Returns: The unique event ID.

InternalizeL ( RReadStream & )

IMPORT_C void

InternalizeL

(

RReadStream &

aStream

)

Link ( )

TLogLink

Link

(

)

const [inline]

Gets the link value.

Returns: The link value.

NewL ( )

IMPORT_C CLogEvent *

NewL

(

)

[static]

Creates a new log event detail object.

Returns: Pointer to the new log event detail object.

Number ( )

const TDesC &

Number

(

)

const [inline]

Gets the phone number associated with the event.

Returns: A reference to a non-modifiable descriptor containing the phone number.

RemoteParty ( )

const TDesC &

RemoteParty

(

)

const [inline]

Gets the remote party associated with this event.

Returns: A reference to a non-modifiable descriptor containing the remote party.

SetContact ( TLogContactItemId )

void

SetContact

(

TLogContactItemId

aContact

)

[inline]

Sets the contact ID associated with the event.

Parameter	Description
aContact	The contact ID.

SetDataL ( RReadStream &, TInt )

IMPORT_C void	SetDataL	(	RReadStream &	aStream,
			TInt	aLen
		)

Sets event specific data from the specified stream.

The data can be used for any purpose. The data is copied into a heap descriptor allocated by this function; the amount of data is only limited by the available memory.

Parameter	Description
aStream	The stream containing the event specific data.
aLen	The length of data to be read from the stream.

SetDataL ( const TDesC8 & )

IMPORT_C void

SetDataL

(

const TDesC8 &

aData

)

Sets event specific data.

The data can be used for any purpose. The data is copied into a heap descriptor allocated by this function; the amount of data is only limited by the available memory.

Parameter	Description
aData	The event specific data.

SetDescription ( const TDesC & )

void

SetDescription

(

const TDesC &

aDescription

)

[inline]

SetDirection ( const TDesC & )

void

SetDirection

(

const TDesC &

aDirection

)

[inline]

Sets the direction of the call represented by this event. The direction of a call means incoming, outgoing etc.

The direction is represented by a string. Standard strings are available in the log wrapper resource file and can be accessed through the resource IDs: R_LOG_DIR_IN, R_LOG_DIR_OUT, R_LOG_DIR_IN_ALT, R_LOG_DIR_OUT_ALT, R_LOG_DIR_FETCHED and R_LOG_DIR_MISSED.

The string is copied into a pre-allocated heap descriptor that has a maximum length of KLogMaxDirectionLength. If the length of the specified descriptor is greater than KLogMaxDirectionLength, then the data is truncated.

Parameter	Description
aDirection	The readable name.

SetDuration ( TLogDuration )

void

SetDuration

(

TLogDuration

aDuration

)

[inline]

Sets the duration of the event.

Parameter	Description
aDuration	The duration of the event, expressed as the number of seconds since the time of the event.

SetDurationType ( TLogDurationType )

void

SetDurationType

(

TLogDurationType

aDurationType

)

[inline]

Sets the duration type. This applies meaning to the idea of a duration.

Parameter	Description
aDurationType	The duration type.

SetEventType ( TUid )

void

SetEventType

(

TUid

aId

)

[inline]

Sets the type of this log event. Event types are identified by a UID.

Parameter	Description
aId	The event type UID.

SetFlags ( TLogFlags )

void

SetFlags

(

TLogFlags

aFlags

)

[inline]

Sets the specified flags for this event.

The function does not change any of the other flag bit settings.

Only the low order 4 bits are stored in the Log Engine Database; the constant KLogFlagsMask can be used as a mask.

Parameter	Description
aFlags	The flags to be set.

SetId ( TLogId )

void

SetId

(

TLogId

aId

)

[inline]

Sets the unique event ID.

Parameter	Description
aId	The unique event ID.

SetLink ( TLogLink )

void

SetLink

(

TLogLink

aLink

)

[inline]

Sets the link value.

The link can be used to relate this event to an entity in another application. For example, it can be used to associate the event with the call ID or the message ID for emails and faxes.

Parameter	Description
aLink	The link value.

SetNumber ( const TDesC & )

void

SetNumber

(

const TDesC &

aNumber

)

[inline]

Sets the phone number associated with this event. This is used when the number cannot be stored in any other field.

The number is specified as a string and is copied into a pre-allocated heap descriptor that has a maximum length of KLogMaxNumberLength. If the length of the specified descriptor is greater than KLogMaxNumberLength, then the number is truncated.

Parameter	Description
aNumber	The number.

SetRemoteParty ( const TDesC & )

void

SetRemoteParty

(

const TDesC &

aRemote

)

[inline]

Sets the remote party associated with this event. This describes the destination of an outgoing event or the source of an incoming event.

The remote party is represented by a string.

The string is copied into a pre-allocated heap descriptor that has a maximum length of KLogMaxRemoteLength. If the length of the specified descriptor is greater than KLogMaxRemoteLength, then the data is truncated.

Parameter	Description
aRemote	The remote party.

SetSimId ( TSimId )

IMPORT_C void

SetSimId

(

TSimId

aSimId

)

Not supported.

SetStatus ( const TDesC & )

void

SetStatus

(

const TDesC &

aStatus

)

[inline]

Sets the delivery status of this event.

The delivery status is represented by a string. Standard strings are available in the log wrapper resource file and can be accessed through the resource IDs: R_LOG_DEL_PENDING, R_LOG_DEL_SENT, R_LOG_DEL_FAILED, R_LOG_DEL_NONE, R_LOG_DEL_DONE and R_LOG_DEL_NOT_SENT.

The string is copied into a pre-allocated heap descriptor that has a maximum length of KLogMaxStatusLength. If the length of the specified descriptor is greater than KLogMaxStatusLength, then the data is truncated.

SetSubject ( const TDesC & )

void

SetSubject

(

const TDesC &

aSubject

)

[inline]

Sets the subject of this event.

The subject is represented by a string.

The string is copied into a pre-allocated heap descriptor that has a maximum length of KLogMaxSubjectLength. If the length of the specified descriptor is greater than KLogMaxSubjectLength, then the data is truncated.

Parameter	Description
aSubject	The subject.

SetTime ( const TTime & )

void

SetTime

(

const TTime &

aTime

)

[inline]

Sets the UTC time that this event was created.

Note that this field is used when ordering events in a view; changing this value may change the position of the event in a view.

Parameter	Description
aTime	The UTC time of the event.

SimId ( )

IMPORT_C TSimId

SimId

(

)

const

Not supported.

Status ( )

const TDesC &

Status

(

)

const [inline]

Gets the delivery status of this event.

Returns: A reference to a non-modifiable descriptor containing the delivery status.

Subject ( )

const TDesC &

Subject

(

)

const [inline]

Gets the subject of this event.

Returns: A reference to a non-modifiable descriptor containing the subject.

Time ( )

const TTime &

Time

(

)

const [inline]

Gets the UTC time that this event was created.

Returns: The time of the event.