Class CContactCard

class CContactCard : public CContactItemPlusGroup;

Description

A contact card.

Implements the Type() function declared in class CContactItem. Contact cards may optionally be constructed from a template.

Derivation

• CBase - Base class for all classes to be instantiated on the heap

• CContactItem - The abstract base class for contact cards, templates and groups

• CContactItemPlusGroup - Abstract base class for CContactGroup, CContactCard and CContactOwnCard

• CContactCard - A contact card

Members

Defined in CContactCard:

• GroupsJoinedLC()Returns a pointer to a list of contact item IDs which identify the groups to which this contact card belongs
• NewL()Allocates and constructs a new contact card
• NewL()Allocates and constructs a new contact card whose field set is seeded from a template
• NewLC()Allocates and constructs a new contact card
• NewLC()Allocates and constructs a new contact card whose field set is seeded from a template
• Type()Implements CContactItem::Type()
• ~CContactCard()Frees all resources owned by the contact card, prior to its destruction

Inherited from CBase:

• Delete()Deletes the specified object
• Extension_()Extension function
• operator new()Initialises the object to binary zeroes

Inherited from CContactItem:

• AccessCount()Gets the contact item's access count
• AddFieldL()Appends a field to the contact item's field set
• CardFields()Gets a reference to the contact item's field set
• DecAccessCount()Decrements the contact item's access count
• ECompressedGuidTo set the contact item's hidden attribute
• EDeletedTo set the contact item's Is deleted attribute
• EHiddenTo set the contact item's hidden attribute
• ESystemTo set the contact item's system attribute
• Guid()Accessor function for Contact Guid
• Id()Gets the contact item's ID
• IncAccessCount()Increments the contact item's access count
• InsertFieldL()Inserts a field into the contact item's field set
• IsDeletable()Tests whether the contact item is deletable
• IsDeleted()Gets the value of the Is deleted attribute as set by SetDeleted()
• IsHidden()Gets the value of the contact item's hidden attribute
• IsSystem()Gets the value of the contact item's system attribute
• LastModified()Gets the contact item's last modified date/time
• RemoveField()Removes a field from the contact item's field set
• SetDeleted()Sets the value of the contact item's Is deleted attribute
• SetHidden()Sets the contact item's hidden attribute
• SetLastModified()Sets the last modified date/time value stored in the local copy of the contact item
• SetSystem()Sets the contact item's system attribute
• SetTemplateRefId()Sets the ID of the template on which this contact item is based
• SetUidStringL()Sets the item's UID string
• TemplateRefId()Gets the ID of the template which was used to create this contact item
• UidStringL()Returns a descriptor which contains the item's UID string
• UpdateFieldSet()Replaces the contact item's field set
• anonymousContact item's attribute flags

Inherited from CContactItemPlusGroup:

• ExternalizeL()Externalises a CContactItemPlusGroup object to a write stream
• GroupsJoined()Returns a pointer to a list of contact item IDs which identify the groups to which the derived class object belongs
• InternalizeL()Internalises a CContactItemPlusGroup object from a read stream

IMPORT_C ~CContactCard();

Description

Frees all resources owned by the contact card, prior to its destruction.

static IMPORT_C CContactCard *NewL();

Description

Allocates and constructs a new contact card.

Return value

CContactCard * Pointer to the newly created contact card.

static IMPORT_C CContactCard *NewLC();

Description

Allocates and constructs a new contact card.

Return value

CContactCard * Pointer to the newly created contact card. This is left on the cleanup stack.

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

Description

Allocates and constructs a new contact card whose field set is seeded from a template.

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 IMPORT_C CContactCard *NewLC(const CContactItem *aTemplate);

Description

Allocates and constructs a new contact card whose field set is seeded from a template.

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. This is left on the cleanup stack.

virtual IMPORT_C TUid Type() const;

Description

Implements CContactItem::Type().

Return value

TUid KUidContactCard.

IMPORT_C CContactIdArray *GroupsJoinedLC() const;

Description

Returns a pointer to a list of contact item IDs which identify the groups to which this 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.