Class CContactCard

CContactCard

Support

Supported from 5.0

Description

A contact card. Implements the pure virtual Type() function defined in class CContactItem. Contact cards may optionally be constructed from a template.

Note: In EPOC Releases 5.0 and 5.1, this class was derived from CContactItem, rather than from CContactItemPlusGroup.

Derivation

CBase Base class for all classes to be instantiated on the heap CContactCard A contact card CContactItem The abstract base class for contact cards, templates and groups CContactItemPlusGroup Abstract base class for CContactGroup, CContactCard and CContactOwnCard

Defined in CContactCard:
GroupsJoinedLC(), NewL(), NewLC(), Type(), ~CContactCard()

Inherited from CBase:
operator new()

Inherited from CContactItem:
AccessCount(), AddFieldL(), CardFields(), DecAccessCount(), Id(), IncAccessCount(), InsertFieldL(), IsDeletable(), IsDeleted(), IsHidden(), IsSystem(), LastModified(), RemoveField(), SetDeleteFlag(), SetDeleted(), SetHidden(), SetLastModified(), SetSystem(), SetTemplateRefId(), SetUidStringL(), TemplateRefId(), UidStringL(), UpdateFieldSet()

Inherited from CContactItemPlusGroup:
GroupsJoined()

static CContactCard* NewL();
static CContactCard* NewL(const CContactItem *aTemplate);

Description

Allocates and constructs a new contact card whose field set may be seeded from a template — overloaded function. The second overload takes a copy of aTemplate — it does not take ownership of it.

Parameters

const CContactItem *aTemplate Pointer to the template whose field set and field data are copied into the new contact card.

Return value

CContactCard* Pointer to the newly created contact card.

static CContactCard* NewLC();
static CContactCard* NewLC(const CContactItem *aTemplate);

Description

Allocates and constructs a new contact card whose field set may be seeded from a template — overloaded function. The second overload takes a copy of aTemplate — it does not take ownership of it. The pointer to the object is left on the cleanup stack.

Parameters

const CContactItem *aTemplate Pointer to the template whose field set and field data are copied into the new contact card.

Return value

CContactCard* Pointer to the newly created contact card.

~CContactCard();

Description

The destructor frees all resources owned by the contact card, prior to its destruction.

TUid Type() const;

Description

Implements the pure virtual function inherited from the base class CContactItem. Returns KUidContactCard.

Return value

TUid KUidContactCard.

CContactIdArray* GroupsJoinedLC() const;

Support

Supported from 6.0

Description

Returns a pointer to a list of contact item IDs which identify the groups to which the current contact card belongs.

Return value

CContactIdArray* A pointer to a copy of the array of groups IDs to which this contact card belongs. This array is empty if the card is not a member of any groups. The caller takes ownership of this object, so is responsible for its deletion.