Collapse all Symbian^3 Application Developer Library

CContactViewRangeBase Class Reference

class CContactViewRangeBase : public CBase

The abstract base class for all contact view range classes.

Range classes are used by contact sub views to specify the upper and lower range boundaries and for searching their underlying view.

CContactSubView

Inherits from

CContactViewRangeBase
- CBase

Public Member Functions
	~CContactViewRangeBase ()
TInt	HighIndex ()
IMPORT_C TBool	IndicesValid ()
TInt	LowIndex ()
void	SetL ()

Protected Member Functions
	CContactViewRangeBase (const CContactViewBase &)
void	ConstructL ()
TInt	FindIndexL (const TDesC &, TCriteria )
TBool	MatchesCriteriaL ( TCriteria , const TDesC &, TInt )
void	ValidateIndices ()

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

Public Member Enumerations
enum	TCriteria { ELessThan , ELessThanOrEqualTo , EGreaterThan , EGreaterThanOrEqualTo }

Protected Attributes
TCollationMethod *	iCollateMethod
TInt	iHigh
TInt	iLow
const CContactViewBase &	iView

Constructor & Destructor Documentation

CContactViewRangeBase(const CContactViewBase &)

CContactViewRangeBase

(

const CContactViewBase &

aView

)

[protected]

Parameters

const CContactViewBase & aView

~CContactViewRangeBase()

~CContactViewRangeBase

(

)

Member Functions Documentation

ConstructL()

void

ConstructL

(

)

[protected]

Called by derived classes to set the collation method iCollateMethod to be the standard collation method for the current locale.

FindIndexL(const TDesC &, TCriteria)

TInt	FindIndexL	(	const TDesC &	aMatch,
			TCriteria	aCriteria
		)	const [protected]

Called by implementations of SetL() to search the sub view's underlying view for the index of the first item whose field content matches aMatch, using the specified search criteria.

Parameters

const TDesC & aMatch	The text to search for.
TCriteria aCriteria	The search criteria.

HighIndex()

TInt

HighIndex

(

)

const [inline]

Gets the index into the sub view's underlying view of the item at the top of the range.

IndicesValid()

IMPORT_C TBool

IndicesValid

(

)

const

Tests whether the lower and upper indexes are valid, i.e. not KErrNotFound.

LowIndex()

TInt

LowIndex

(

)

const [inline]

Gets the index into the sub view's underlying view of the item at the bottom of the range.

MatchesCriteriaL(TCriteria, const TDesC &, TInt)

TBool	MatchesCriteriaL	(	TCriteria	aCriteria,
			const TDesC &	aMatch,
			TInt	aIndex
		)	const [protected]

Parameters

TCriteria aCriteria
const TDesC & aMatch
TInt aIndex

SetL()

void

SetL

(

)

[pure virtual]

Sets the iLow and iHigh members.

ValidateIndices()

void

ValidateIndices

(

)

[protected]

Called by derived classes to validate the upper and lower indexes (iLow and iHigh).

If either index is KErrNotFound, or iLow is greater than iHigh, then both are set to KErrNotFound.

Member Enumerations Documentation

Enum TCriteria

Defines the range criteria.

Enumerators

ELessThan	Less than.
ELessThanOrEqualTo	Less than or equal to.
EGreaterThan	Greater than.
EGreaterThanOrEqualTo	Greater than or equal to.

Member Data Documentation

TCollationMethod * iCollateMethod

TCollationMethod *

iCollateMethod

[protected]

The collation method used to sort the strings.

By default, this is the standard collation method for the current locale.

TInt iHigh

TInt

iHigh

[protected]

The index into the sub view's underlying view of the item at the upper limit of the range.

TInt iLow

TInt

iLow

[protected]

The index into the sub view's underlying view of the item at the lower limit of the range.

const CContactViewBase & iView

const CContactViewBase &

iView

[protected]

The sub view's underlying view.