MVPbkStoreContactFieldCollection Class Reference

class MVPbkStoreContactFieldCollection : public MVPbkBaseContactFieldCollection

An interface for the field collection of the store contact

A field collection interface can be used for looping the contact fields.

Inherits from

Constructor & Destructor Documentation

~MVPbkStoreContactFieldCollection()

~MVPbkStoreContactFieldCollection ( ) [inline, virtual]

Destructor.

Member Functions Documentation

FieldAt(TInt)

const MVPbkStoreContactField & FieldAt ( TInt aIndex ) const [pure virtual]

Returns a read-only field in this collection.

MVPbkBaseContactFieldCollection::ConstFieldAt aIndex >= 0 && aIndex < FieldCount() Panic VPbkError::EInvalidFieldIndex is raised if the precondition does not hold.

Parameters

TInt aIndex Zero-based index of the field to return.

FieldAt(TInt)

MVPbkStoreContactField & FieldAt ( TInt aIndex ) [pure virtual]

Returns a field in this collection.

MVPbkStoreContactField::CloneLC aIndex >= 0 && aIndex < FieldCount() VPbkError::Panic(VPbkError::EInvalidFieldIndex) is raised if the precondition does not hold.

Parameters

TInt aIndex A zero-based index of the field to return.

FieldAtLC(TInt)

MVPbkStoreContactField * FieldAtLC ( TInt aIndex ) const [pure virtual]

Returns a copy of the field in this collection.

Client gets the ownership of the field.

Parameters

TInt aIndex A zero-based index of the field to return.

ParentStoreContact()

MVPbkStoreContact & ParentStoreContact ( ) const [pure virtual]

Returns the parent contact of the field collection

RetrieveField(const MVPbkContactLink &)

MVPbkStoreContactField * RetrieveField ( const MVPbkContactLink & aContactLink ) const [pure virtual]

Returns a field in this collection identified by a contact field link.

A contact field link can be created using the MVPbkStoreContactField interface. The same link works then as a contact link and a field link.

NOTE: implementations of stores are possibly using an index of the field as an identifier so clients should prefer not to save field links permanently. E.g modifying the contact can invalidate the link in some store implementations. A field link is practical in use cases where the link is created and immediately given to another component.

Parameters

const MVPbkContactLink & aContactLink A valid contact field link.

StoreContactFieldCollectionExtension(TUid)

TAny * StoreContactFieldCollectionExtension ( TUid ) [inline, virtual]

Returns an extension point for this interface or NULL.

Parameters

TUid