#include <app/cntitem.h>
| class CContactOwnCard : public CContactItemPlusGroup |
| Public Member Functions | |
|---|---|
| ~CContactOwnCard() | |
| IMPORT_C CContactIdArray * | GroupsJoinedLC() |
| IMPORT_C CContactOwnCard * | NewL() |
| IMPORT_C CContactOwnCard * | NewL(const CContactItem *) |
| IMPORT_C CContactOwnCard * | NewLC() |
| IMPORT_C CContactOwnCard * | NewLC(const CContactItem *) |
| virtual IMPORT_C TUid | Type() |
| Inherited Enumerations | |
|---|---|
| CContactItem:@64 | |
Own card.
An own card is a contact card which contains information about the device's owner. This can be sent to another compatible electronic device as a vCard. The contact database recognises a single own card, referred to as the current own card; its ID is returned by CContactDatabase::OwnCardId(). Like a contact card, an own card can be a member of one or more contact card groups. The own card type is identified by a UID of KUidContactOwnCard.
Own cards can be constructed using either CContactDatabase::CreateOwnCardLC() or CreateOwnCardL(). These functions create an own card, based on the system template, add it to the database, set it as the database's current own card and return a pointer to it. To change the database's current own card, use CContactDatabase::SetOwnCardL().
| IMPORT_C | ~CContactOwnCard | ( | ) |
Frees all resources owned by the own card, prior to its destruction.
| IMPORT_C CContactIdArray * | GroupsJoinedLC | ( | ) | const |
Reimplemented from CContactItemPlusGroup::GroupsJoinedLC()const
Returns a pointer to a list of contact item IDs which identify the groups to which the current own card belongs.
Returns: A pointer to a copy of the array of groups IDs to which this own card belongs. This array is empty if the own card is not a member of any groups. The caller takes ownership of this object, so is responsible for its deletion.
| IMPORT_C CContactOwnCard * | NewL | ( | ) | [static] |
Allocates and constructs a new own card.
Note: own cards should normally be constructed using the factory functions provided in class CContactDatabase, for example CreateOwnCardL().
Returns: Pointer to the newly created own card.
| IMPORT_C CContactOwnCard * | NewL | ( | const CContactItem * | aTemplate | ) | [static] |
Allocates and constructs a new own card whose field set is seeded from a template.
Note: own cards should normally be constructed using the factory functions provided in class CContactDatabase, for example CreateOwnCardL().
| Parameter | Description |
|---|---|
| aTemplate | Pointer to the template whose field set and field data are copied into the new own card. |
Returns: Pointer to the newly created own card.
| IMPORT_C CContactOwnCard * | NewLC | ( | ) | [static] |
Allocates and constructs a new own card.
Note: own cards should normally be constructed using the factory functions provided in class CContactDatabase, for example CreateOwnCardL().
Returns: Pointer to the newly created own card. This is left on the cleanup stack.
| IMPORT_C CContactOwnCard * | NewLC | ( | const CContactItem * | aTemplate | ) | [static] |
Allocates and constructs a new own card whose field set is seeded from a template.
Note: own cards should normally be constructed using the factory functions provided in class CContactDatabase, for example CreateOwnCardL().
| Parameter | Description |
|---|---|
| aTemplate | Pointer to the template whose field set and field data are copied into the new own card. |
Returns: Pointer to the newly created own card. This is left on the cleanup stack.
| IMPORT_C TUid | Type | ( | ) | const [virtual] |
Reimplemented from CContactItem::Type()const
Implements CContactItem::Type().
Returns: KUidContactOwnCard.