CContactFilteredView Class Reference

#include <app/cntview.h>

Link against: cntview.lib

class CContactFilteredView : public CContactViewBase

Inherits from

CContactFilteredView
- CContactViewBase

Public Member Functions
	~CContactFilteredView()
virtual HBufC *	AllFieldsLC(TInt, const TDesC &)
virtual TContactItemId	AtL(TInt)
virtual TAny *	CContactViewBase_Reserved_1(TFunction, TAny *)
virtual const CViewContact &	ContactAtL(TInt)
virtual TContactViewPreferences	ContactViewPreferences()
virtual void	ContactsMatchingCriteriaL(const MDesCArray &, RPointerArray< CViewContact > &)
virtual void	ContactsMatchingPrefixL(const MDesCArray &, RPointerArray< CViewContact > &)
virtual TInt	CountL()
virtual TInt	FindL(TContactItemId)
IMPORT_C CContactFilteredView *	NewL(MContactViewObserver &, const CContactDatabase &, CContactViewBase &, TInt)
IMPORT_C CContactFilteredView *	NewL(CContactViewBase &, const CContactDatabase &, MContactViewObserver &, TInt)
virtual const RContactViewSortOrder &	SortOrderL()

Inherited Attributes
	CContactViewBase::iDb
	CContactViewBase::iExtension
	CContactViewBase::iState

Inherited Enumerations
	CContactViewBase:TFunction
	CContactViewBase:TSearchType
	CContactViewBase:TState

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()
	CContactViewBase::CContactViewBase(const CContactDatabase &)
	CContactViewBase::Close(const MContactViewObserver &)
	CContactViewBase::CompareContactIds(const CViewContact &,const CViewContact &)
	CContactViewBase::CompareContactsAndIdsL(const CViewContact &,const CViewContact &)const
	CContactViewBase::CompareFieldsL(const CViewContact &,const CViewContact &)
	CContactViewBase::ConstructL()
	CContactViewBase::ContactIsSortable(const CViewContact &)
	CContactViewBase::Error()const
	CContactViewBase::FieldsWithSeparatorLC(const RPointerArray< CViewContact > &,TInt,const TDesC &)const
	CContactViewBase::FindDefaultViewSortPluginImplL()const
	CContactViewBase::FindSortPluginImplL(const TDesC8 &,TBool)const
	CContactViewBase::GetContactIdsL(const CArrayFix< TInt > &,CContactIdArray &)
	CContactViewBase::GetViewFindConfigPlugin()
	CContactViewBase::GetViewSortPluginImplUid()const
	CContactViewBase::IdsEqual(const TContactIdWithMapping &,const TContactIdWithMapping &)
	CContactViewBase::IdsMatch(const CViewContact &,const CViewContact &)
	CContactViewBase::IndexesEqual(const TContactIdWithMapping &,const TContactIdWithMapping &)
	CContactViewBase::InsertContactInView(RPointerArray< CViewContact > &,const CViewContact ,TBool,TInt )const
	CContactViewBase::IsContactSortable(const CViewContact &,TContactViewPreferences &)const
	CContactViewBase::LoadViewSortPluginL(TUid,TContactViewPreferences &)
	CContactViewBase::MatchesCriteriaL(const CViewContact &,const MDesCArray &)
	CContactViewBase::MatchesCriteriaL(const CViewContact &,const MDesCArray &,TSearchType)
	CContactViewBase::MatchesCriteriaL(const CViewContact &,const MDesCArray &,TSearchType,CContactViewBase::CContactViewBaseExtension *)
	CContactViewBase::NotifyObserverAsync(MContactViewObserver &,const TContactViewEvent &)
	CContactViewBase::NotifyObservers(const TContactViewEvent &)
	CContactViewBase::Open(MContactViewObserver &)
	CContactViewBase::OpenL(MContactViewObserver &)
	CContactViewBase::SetViewFindConfigPlugin(TUid)
	CContactViewBase::SortPluginImpl()const
	CContactViewBase::~CContactViewBase()

Detailed Description

Provides a filtered view over an existing CContactViewBase derived object.

For example, it might provide a view containing only contacts that have an email address. For efficiency reasons there are a limited set of filters available (defined in CContactDatabase::TContactViewFilter).

The filtered view observes its underlying view so that it is kept up to date if the contents of the underlying view change. It will, in turn, notify its observers.

Filters only apply to non-hidden contact fields with content.

Constructor & Destructor Documentation

~CContactFilteredView ( )

~CContactFilteredView

(

)

Member Function Documentation

AllFieldsLC ( TInt, const TDesC & )

HBufC *	AllFieldsLC	(	TInt	aIndex,
			const TDesC &	aSeparator
		)	const [virtual]

Reimplemented from CContactViewBase::AllFieldsLC(TInt,const TDesC &)const

Returns a descriptor containing the contents of all fields for an item in the view.

The fields are separated by aSeparator.

Parameter	Description
aIndex	The index into the filtered view of the contact item.
aSeparator	The string to use to separate the fields.

Returns: Pointer to the specified contact item descriptor.

AtL ( TInt )

TContactItemId

AtL

(

TInt

aIndex

)

const [virtual]

Reimplemented from CContactViewBase::AtL(TInt)const

Gets the contact item ID at the specified index into the filtered view.

leave: KErrNotReady The view is not ready for use.

leave: KErrNotFound aIndex is outside the bounds of the filtered view.

Parameter	Description
aIndex	Index of the contact item ID into the filtered view.

Returns: The contact item ID.

CContactViewBase_Reserved_1 ( TFunction, TAny * )

TAny *	CContactViewBase_Reserved_1	(	TFunction	aFunction,
			TAny *	aParams
		)	[virtual]

Reimplemented from CContactViewBase::CContactViewBase_Reserved_1(TFunction,TAny *)

ContactAtL ( TInt )

const CViewContact &

ContactAtL

(

TInt

aIndex

)

const [virtual]

Reimplemented from CContactViewBase::ContactAtL(TInt)const

Gets the contact item at the specified index into the view.

leave: KErrNotReady The view is not ready for use.

leave: KErrNotFound aIndex is outside the bounds of the filtered ID array.

Parameter	Description
aIndex	Index into the view of the required item.

Returns: The contact item.

ContactViewPreferences ( )

TContactViewPreferences

ContactViewPreferences

(

)

[virtual]

Reimplemented from CContactViewBase::ContactViewPreferences()

Gets the underlying view's view preferences.

Returns: The view preferences.

ContactsMatchingCriteriaL ( const MDesCArray &, RPointerArray< CViewContact > & )

void	ContactsMatchingCriteriaL	(	const MDesCArray &	aFindWords,
			RPointerArray< CViewContact > &	aMatchedContacts
		)	[virtual]

Reimplemented from CContactViewBase::ContactsMatchingCriteriaL(const MDesCArray &,RPointerArray< CViewContact > &)

Searches all contact items in the filtered view for fields that contain all of the search strings specified.

The search uses wildcard matching so that the search strings can occur anywhere in an item's fields. For a match to occur, all of the search strings must be found in the contact item.

Parameter	Description
aFindWords	A descriptor array containing one or more search strings.
aMatchedContacts	On return, an array of matching contact items.

ContactsMatchingPrefixL ( const MDesCArray &, RPointerArray< CViewContact > & )

void	ContactsMatchingPrefixL	(	const MDesCArray &	aFindWords,
			RPointerArray< CViewContact > &	aMatchedContacts
		)	[virtual]

Reimplemented from CContactViewBase::ContactsMatchingPrefixL(const MDesCArray &,RPointerArray< CViewContact > &)

Searches all contact items in the filtered view for fields that contain all of the search strings specified.

Unlike ContactsMatchingCriteriaL(), the search term can only occur at the beginning of a field.

Parameter	Description
aFindWords	A descriptor array containing one or more search strings.
aMatchedContacts	On return, an array of matching contact items.

CountL ( )

TInt

CountL

(

)

const [virtual]

Reimplemented from CContactViewBase::CountL()const

Gets the number of contact item IDs in the filtered view.

leave: KErrNotReady The view is not ready for use.

Returns: The number of contact items in the filtered view.

FindL ( TContactItemId )

TInt

FindL

(

TContactItemId

aId

)

const [virtual]

Reimplemented from CContactViewBase::FindL(TContactItemId)const

Finds the index into the filtered view of the specified contact item.

leave: KErrNotReady The view is not ready for use.

Parameter	Description
aId	The contact item ID to search for.

Returns: The index of the first matching item in the array or KErrNotFound if no matching object can be found.

NewL ( MContactViewObserver &, const CContactDatabase &, CContactViewBase &, TInt )

IMPORT_C CContactFilteredView *	NewL	(	MContactViewObserver &	aObserver,
			const CContactDatabase &	aDb,
			CContactViewBase &	aView,
			TInt	aFilter
		)	[static]

Allocates and constructs a CContactFilteredView version 1 object.

When adding/deleting contacts in the view, MContactViewObserver observer will receive TContactViewEvent events with iInt parameter set to index into the observed view of the added/deleted item

Parameter	Description
aObserver	An observer that receives notifications when this view is ready for use and when changes take place in it. The observer receives a TContactViewEvent::EReady event when the view is ready. An attempt to use the view before this notification causes a panic.
aDb	The database containing the contact items.
aView	The underlying contact view over which this view provides a filter.
aFilter	The filter to use. For possible values, see CContactDatabase::TContactViewFilter.

Returns: The newly constructed filtered view object.

NewL ( CContactViewBase &, const CContactDatabase &, MContactViewObserver &, TInt )

IMPORT_C CContactFilteredView *	NewL	(	CContactViewBase &	aView,
			const CContactDatabase &	aDb,
			MContactViewObserver &	aObserver,
			TInt	aFilter
		)	[static]

Allocates and constructs a CContactFilteredView version 2 object.

When adding/deleting contacts in the view, MContactViewObserver observer will receive TContactViewEvent events with iInt parameter set to index into the observed view of the added/deleted item

Parameter	Description
aView	The underlying contact view over which this view provides a filter.
aDb	The database containing the contact items.
aObserver	An observer that receives notifications when this view is ready for use and when changes take place in it. The observer receives a TContactViewEvent::EReady event when the view is ready. An attempt to use the view before this notification causes a panic.
aFilter	The filter to use. For possible values, see CContactDatabase::TContactViewFilter.

Returns: The newly constructed filtered view object.

SortOrderL ( )

const RContactViewSortOrder &

SortOrderL

(

)

const [virtual]

Reimplemented from CContactViewBase::SortOrderL()const

Gets the underlying view's sort order.

Returns: The sort order.