Collapse all Symbian^3 Application Developer Library

CLogFilter Class Reference

class CLogFilter : public CBase

Specifies the conditions that events must satisfy to appear in a view.

In general, a filter is used to construct the WHERE clause of an SQL statement based on the content of the filter's fields. The filter's fields correspond to the event properties in a log event detail object, i.e. an instance of the CLogEvent class.

Where a filter uses time to extract one or more events from the log, this must be specified as UTC rather than local time.

CLogEvent CLogViewEvent CLogViewRecent CLogViewDuplicate

Inherits from

CLogFilter
- CBase

Public Member Functions
	~CLogFilter ()
void	ClearFlags ( TLogFlags )
TLogContactItemId	Contact ()
IMPORT_C void	Copy (const CLogFilter &)
const TDesC &	Direction ()
TLogDurationType	DurationType ()
const TTime &	EndTime ()
TUid	EventType ()
void	ExternalizeL ( RWriteStream &)
TLogFlags	Flags ()
void	InternalizeL ( RReadStream &)
IMPORT_C CLogFilter *	NewL ()
TUint32	NullFields ()
const TDesC &	Number ()
const TDesC &	RemoteParty ()
void	SetContact ( TLogContactItemId )
void	SetDirection (const TDesC &)
void	SetDurationType ( TLogDurationType )
void	SetEndTime (const TTime &)
void	SetEventType ( TUid )
void	SetFlags ( TLogFlags )
void	SetNullFields ( TUint32 )
void	SetNumber (const TDesC &)
void	SetRemoteParty (const TDesC &)
IMPORT_C void	SetSimId ( TSimId )
void	SetStartTime (const TTime &)
void	SetStatus (const TDesC &)
IMPORT_C TSimId	SimId ()
const TTime &	StartTime ()
const TDesC &	Status ()

Private Member Functions
	CLogFilter ()
void	ConstructL ()
void	InternalizeBufL ( RReadStream &, HBufC *&)

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()

Private Attributes
TLogContactItemId	iContact
HBufC *	iDirection
TLogDurationType	iDurationType
TTime	iEndTime
TUid	iEventType
TLogFlags	iFlags
TUint32	iNullFields
HBufC *	iNumber
HBufC *	iRemoteParty
TTime	iStartTime
HBufC *	iStatus

Constructor & Destructor Documentation

CLogFilter()

CLogFilter

(

)

[private]

~CLogFilter()

IMPORT_C

~CLogFilter

(

)

Frees all resource owned by the object prior to its destruction.

Member Functions Documentation

ClearFlags(TLogFlags)

void

ClearFlags

(

TLogFlags

aFlags

)

[inline]

Clears the specified flags to be used by the filter.

The constant KLogFlagsMask can be used to clear all the flags.

Parameters

TLogFlags aFlags

The flags to be cleared

ConstructL()

void

ConstructL

(

)

[private]

Contact()

TLogContactItemId

Contact

(

)

const [inline]

Gets the contact ID used by the filter.

CLogEvent::Contact()

Copy(const CLogFilter &)

IMPORT_C void

Copy

(

const CLogFilter &

aFilter

)

Makes a copy of a filter.

Parameters

const CLogFilter & aFilter

The filter object to be copied.

Direction()

const TDesC &

Direction

(

)

const [inline]

Gets the direction string used by the filter.

CLogEvent::Direction()

DurationType()

TLogDurationType

DurationType

(

)

const [inline]

Gets the duration type used by the filter.

CLogEvent::DurationType()

EndTime()

const TTime &

EndTime

(

)

const [inline]

Gets the UTC end time used by the filter.

EventType()

TUid

EventType

(

)

const [inline]

Gets the event type used by the filter.

CLogEvent::EventType()

ExternalizeL(RWriteStream &)

void

ExternalizeL

(

RWriteStream &

aStream

)

const

Parameters

RWriteStream & aStream

Flags()

TLogFlags

Flags

(

)

const [inline]

Gets the flags used by the filter.

InternalizeBufL(RReadStream &, HBufC *&)

void	InternalizeBufL	(	RReadStream &	aStream,
			HBufC *&	aDes
		)	[private]

Parameters

RReadStream & aStream
HBufC *& aDes

InternalizeL(RReadStream &)

void

InternalizeL

(

RReadStream &

aStream

)

Parameters

RReadStream & aStream

NewL()

IMPORT_C CLogFilter *

NewL

(

)

[static]

Creates a new filter object.

All fields in the new instance are initialised to default values, so that if none of the fields are changed, the filter has no effect on the selection of events in view.

NullFields()

TUint32

NullFields

(

)

const [inline]

Identifies the fields defined as NULL in the filter. These are the fields that the filter expects to be NULL in the database. A NULL field is one that has no value.

SetNullFields()

Number()

const TDesC &

Number

(

)

const [inline]

Gets the phone number used by the filter.

CLogEvent::Number()

RemoteParty()

const TDesC &

RemoteParty

(

)

const [inline]

Gets the remote party string used by the filter.

CLogEvent::RemoteParty()

SetContact(TLogContactItemId)

void

SetContact

(

TLogContactItemId

aContact

)

[inline]

Sets the contact ID to be used by the filter.

CLogEvent::SetContact()

Parameters

TLogContactItemId aContact

The contact ID.

SetDirection(const TDesC &)

void

SetDirection

(

const TDesC &

aDirection

)

[inline]

Sets the direction string to be used by the filter.

CLogEvent::SetDirection()

Parameters

const TDesC & aDirection

The direction string.

SetDurationType(TLogDurationType)

void

SetDurationType

(

TLogDurationType

aType

)

[inline]

Sets the duration type to be used by the filter.

CLogEvent::SetDurationType()

Parameters

TLogDurationType aType

The duration type.

SetEndTime(const TTime &)

void

SetEndTime

(

const TTime &

aEndTime

)

[inline]

Sets the specified UTC end time to be used by the filter.

Parameters

const TTime & aEndTime

The UTC end time to be set.

SetEventType(TUid)

void

SetEventType

(

TUid

aType

)

[inline]

Sets the event type to be used by the filter.

CLogEvent::SetEventType()

Parameters

TUid aType

The event type UID.

SetFlags(TLogFlags)

void

SetFlags

(

TLogFlags

aFlags

)

[inline]

Sets the specified flags to be used by the filter.

Parameters

TLogFlags aFlags

The flags to be set.

SetNullFields(TUint32)

void

SetNullFields

(

TUint32

aFields

)

[inline]

Defines NULL fields to the filter. These are the fields that the filter expects to be NULL in the database. A NULL field is one that has no value.

Each field is identified by a bit value. The bit values may be ORd together in any combination.

Note that setting a flag and explicitly setting a value for the corresponding field generates an OR condition in the SQL WHERE clause.

Parameters

TUint32 aFields

Bit values defining the null fields. These are one or more of the following values defined in logwrap.hrh: ELogContactField, ELogDirectionField, ELogDurationTypeField, ELogEventTypeField, ELogNumberField, ELogRemotePartyField, ELogStatusField, ELogFlagsField, ELogSubjectField, ELogLinkField, ELogDataField, ELogSimIdField.

SetNumber(const TDesC &)

void

SetNumber

(

const TDesC &

aNumber

)

[inline]

Sets the phone number to be used by the filter.

CLogEvent::SetNumber()

Parameters

const TDesC & aNumber

The phone number.

SetRemoteParty(const TDesC &)

void

SetRemoteParty

(

const TDesC &

aRemote

)

[inline]

Sets the remote party string to be used by the filter.

CLogEvent::SetRemoteParty()

Parameters

const TDesC & aRemote

The remote party string.

SetSimId(TSimId)

IMPORT_C void

SetSimId

(

TSimId

aSimId

)

Not supported.

Parameters

TSimId aSimId

SetStartTime(const TTime &)

void

SetStartTime

(

const TTime &

aStartTime

)

[inline]

Sets the specified UTC start time to be used by the filter.

Parameters

const TTime & aStartTime

The UTC start time to be set.

SetStatus(const TDesC &)

void

SetStatus

(

const TDesC &

aStatus

)

[inline]

Sets the delivery status to be used by the filter.

CLogEvent::SetStatus()

Parameters

const TDesC & aStatus

The delivery status.

SimId()

IMPORT_C TSimId

SimId

(

)

const

Not supported.

StartTime()

const TTime &

StartTime

(

)

const [inline]

Gets the UTC start time used by the filter.

Status()

const TDesC &

Status

(

)

const [inline]

Gets the delivery status used by the filter.

CLogEvent::Status()

Member Data Documentation

TLogContactItemId iContact

TLogContactItemId

iContact

[private]

HBufC * iDirection

HBufC *

iDirection

[private]

TLogDurationType iDurationType

TLogDurationType

iDurationType

[private]

TTime iEndTime

TTime

iEndTime

[private]

TUid iEventType

TUid

iEventType

[private]

TLogFlags iFlags

TLogFlags

iFlags

[private]

TUint32 iNullFields

TUint32

iNullFields

[private]

HBufC * iNumber

HBufC *

iNumber

[private]

HBufC * iRemoteParty

HBufC *

iRemoteParty

[private]

TTime iStartTime

TTime

iStartTime

[private]

HBufC * iStatus

HBufC *

iStatus

[private]