CPbkContactEngine Class Reference

#include <app/CPbkContactEngine.h>

Link against: PbkEng.lib

class CPbkContactEngine : public CBase

Inherits from

  • CPbkContactEngine

    Nested Classes and Structures

    Public Member Enumerations
    enumTPbkNameOrder { EPbkNameOrderLastNameFirstName, EPbkNameOrderFirstNameLastName, EPbkNameOrderNotDefined }
    Public Member Functions
    ~CPbkContactEngine()
    IMPORT_C voidAddContactToGroupL(TContactItemId, TContactItemId)
    IMPORT_C TContactItemIdAddNewContactL(CPbkContactItem &, TBool)
    IMPORT_C CContactViewBase &AllContactsView()
    IMPORT_C CContactViewBase &AllGroupsViewL()
    IMPORT_C voidCancelCompress()
    IMPORT_C TBoolCheckCompress()
    IMPORT_C voidCheckFileSystemSpaceAndCompressL()
    IMPORT_C voidCloseContactL(TContactItemId)
    IMPORT_C voidCommitContactGroupL(CContactGroup &, TBool)
    IMPORT_C voidCommitContactL(CPbkContactItem &, TBool)
    IMPORT_C voidCompressL()
    IMPORT_C CPbkConstants *Constants()
    IMPORT_C MPbkContactNameFormat &ContactNameFormat()
    IMPORT_C CPbkContactChangeNotifier *CreateContactChangeNotifierL(MPbkContactDbObserver *)
    IMPORT_C CContactGroup *CreateContactGroupL(const TDesC &, TBool)
    IMPORT_C CPbkContactIter *CreateContactIteratorLC(TBool)
    IMPORT_C CPbkContactItem *CreateEmptyContactL()
    IMPORT_C CContactDatabase &Database()
    IMPORT_C voidDeleteContactGroupL(TContactItemId, TBool)
    IMPORT_C voidDeleteContactL(TContactItemId, TBool)
    IMPORT_C voidDeleteContactsL(const CContactIdArray &, TBool)
    IMPORT_C voidDeleteContactsOnBackgroundL(const CContactIdArray &)
    IMPORT_C TContactItemIdDuplicateContactL(TContactItemId, TBool)
    IMPORT_C const CPbkFieldsInfo &FieldsInfo()
    IMPORT_C CContactViewBase &FilteredContactsViewL(TInt)
    IMPORT_C CPbkIdleFinder *FindAsyncL(const TDesC &, const CPbkFieldIdArray *, MIdleFindObserver *)
    IMPORT_C CContactIdArray *FindLC(const TDesC &, const CPbkFieldIdArray *)
    IMPORT_C RFs &FsSession()
    IMPORT_C HBufC *GetContactTitleL(const CPbkContactItem &)
    IMPORT_C HBufC *GetContactTitleOrNullL(const MPbkFieldDataArray &)
    IMPORT_C TContactItemIdGetSpeedDialFieldL(TInt, TDes &)
    IMPORT_C TBoolIsSpeedDialAssigned(const CPbkContactItem &, TInt)
    IMPORT_C TBoolIsTitleField(TPbkFieldId)
    IMPORT_C CContactIdArray *MatchPhoneNumberL(const TDesC &, const TInt)
    IMPORT_C TPbkNameOrderNameDisplayOrderL()
    IMPORT_C TCharNameSeparator()
    IMPORT_C CPbkContactEngine *NewL(RFs *)
    IMPORT_C CPbkContactEngine *NewL(const TDesC &, TBool, RFs *)
    IMPORT_C CContactGroup *OpenContactGroupL(TContactItemId)
    IMPORT_C CContactGroup *OpenContactGroupLCX(TContactItemId)
    IMPORT_C CPbkContactItem *OpenContactL(TContactItemId)
    IMPORT_C CPbkContactItem *OpenContactLCX(TContactItemId)
    IMPORT_C CContactGroup *ReadContactGroupL(TContactItemId)
    IMPORT_C CPbkContactItem *ReadContactL(TContactItemId, const CPbkFieldIdArray *)
    IMPORT_C CPbkContactItem *ReadContactLC(TContactItemId, const CPbkFieldIdArray *)
    IMPORT_C CPbkContactItem *ReadMinimalContactLC(TContactItemId)
    IMPORT_C voidRemoveContactFromGroupL(TContactItemId, TContactItemId)
    IMPORT_C voidRemoveSpeedDialFieldL(TContactItemId, TInt)
    IMPORT_C CPbkContactEngine *ReplaceL(RFs *)
    IMPORT_C voidSetCompressUi(MPbkCompressUi *)
    IMPORT_C voidSetFieldAsSpeedDialL(CPbkContactItem &, TInt, TInt)
    IMPORT_C voidSetNameDisplayOrderL(TPbkNameOrder)
    IMPORT_C voidSetNameSeparatorL(TChar)
    const CPbkSortOrderManager &SortOrderManager()
    IMPORT_C CPbkContactEngine *Static()
    IMPORT_C const TDesC &UnnamedTitle()
    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()

    Detailed Description

    The main entrypoint to the Phonebook contact engine. The Phonebook contact engine builds on top of the Symbian Contacts model and implements platform specific functionality and policies that can be reused and followed by clients to implement functionality that is better integrated to the platform functionality. Functionality like contact field typing is implemented by this engine.

    Member Enumeration Documentation

    Enum TPbkNameOrder

    EnumeratorValueDescription
    EPbkNameOrderLastNameFirstName0
    EPbkNameOrderFirstNameLastNameLast name then first name order.
    EPbkNameOrderNotDefinedFirst name then last name order.

    undefined name order

    Constructor & Destructor Documentation

    ~CPbkContactEngine ( )

    ~CPbkContactEngine()

    Destructor. Destroys this object and closes the contact database connection. REComSession::FinalClose() is called. Notice that FinalClose -call releases resource handles of already destroyed ECom plugins also outside CPbkContactEngine. See REComSession documentation.

    Member Function Documentation

    AddContactToGroupL ( TContactItemId, TContactItemId )

    IMPORT_C voidAddContactToGroupL(TContactItemIdaItemId,
    TContactItemIdaGroupId
    )

    Adds a Contact to a group.

    See also: CContactDatabase::AddContactToGroupL

    ParameterDescription
    aItemIdContact to be added to group.
    aGroupIdGroup where the contact will be added to.

    AddNewContactL ( CPbkContactItem &, TBool )

    IMPORT_C TContactItemIdAddNewContactL(CPbkContactItem &aContact,
    TBoolaImmediateNotify = EFalse
    )

    Adds a new contact to the contact database.

    See also: CContactDatabase::AddNewContactL

    ParameterDescription
    aContactThe new contact item to add.
    aImmediateNotifySend notification to observers immediately. NOTE: send immediately will result in observers (MPbkContactDbObserver) receiving the event twice!

    Returns: The id of the new contact item.

    AllContactsView ( )

    IMPORT_C CContactViewBase &AllContactsView()

    Returns a contact view object containing all the contacts in the database.

    See also: CContactViewBase

    Returns: Contact view containing all the contacts in the database.

    AllGroupsViewL ( )

    IMPORT_C CContactViewBase &AllGroupsViewL()

    Returns a contact view object containing all the groups in the database.

    See also: CContactViewBase

    Returns: Contact view containing all the groups in the database.

    CancelCompress ( )

    IMPORT_C voidCancelCompress()

    CheckCompress ( )

    IMPORT_C TBoolCheckCompress()

    CheckFileSystemSpaceAndCompressL ( )

    IMPORT_C voidCheckFileSystemSpaceAndCompressL()

    CloseContactL ( TContactItemId )

    IMPORT_C voidCloseContactL(TContactItemIdaContactId)

    Closes a previously opened contact item without saving changes.

    See also: CContactDatabase::CloseContactL

    ParameterDescription
    aContactIdContact item to be closed.

    CommitContactGroupL ( CContactGroup &, TBool )

    IMPORT_C voidCommitContactGroupL(CContactGroup &aGroup,
    TBoolaImmediateNotify = EFalse
    )

    Commits changes to a contact group to the database.

    See also: CContactDatabase::CommitContactL

    ParameterDescription
    aImmediateNotifySend notification to observers immediately. NOTE: send immediately will result in observers (MPbkContactDbObserver) receiving the event twice!

    CommitContactL ( CPbkContactItem &, TBool )

    IMPORT_C voidCommitContactL(CPbkContactItem &aContact,
    TBoolaImmediateNotify = EFalse
    )

    Commit changes to a previously opened contact item into the contact database.

    See also: CContactDatabase::CommitContactL

    ParameterDescription
    aContactContact item to be updated in the database.
    aImmediateNotifySend notification to observers immediately. NOTE: send immediately will result in observers (MPbkContactDbObserver) receiving the event twice!

    CompressL ( )

    IMPORT_C voidCompressL()

    Constants ( )

    IMPORT_C CPbkConstants *Constants()

    ContactNameFormat ( )

    IMPORT_C MPbkContactNameFormat &ContactNameFormat()const

    CreateContactChangeNotifierL ( MPbkContactDbObserver * )

    IMPORT_C CPbkContactChangeNotifier *CreateContactChangeNotifierL(MPbkContactDbObserver *aObserver)

    Creates and returns a new CPbkContactChangeNotifier for the default contact database. The returned object attaches aObserver to this engine instance as long as the object exists.

    See also: CPbkContactChangeNotifier MPbkContactDbObserver

    ParameterDescription
    aObserverObserver to attach to this object.

    Returns: New CPbkContactChangeNotifier object. Caller is responsible of the object.

    CreateContactGroupL ( const TDesC &, TBool )

    IMPORT_C CContactGroup *CreateContactGroupL(const TDesC &aGroupLabel,
    TBoolaInTransaction = EFalse
    )

    Creates a new contact group.

    See also: CContactDatabase::CreateContactGroupL

    ParameterDescription
    aGroupLabelGroup name.
    aInTransactionSee Symbian Contacts Model documentation for CContactDatabase::CreateContactGroupL documentation.

    CreateContactIteratorLC ( TBool )

    IMPORT_C CPbkContactIter *CreateContactIteratorLC(TBoolaUseMinimalRead = EFalse)

    Returns a Phonebook contact iterator.

    See also: CPbkContactIter::NewL. CContactDatabase::ReadMinimalContactL

    ParameterDescription
    aUseMinimalReadIf ETrue the iterator will use the Symbian Contacts model CContactDatabase::ReadMinimalContactL, EFalse will read all the contact fields. Default behaviour is to read all fields.

    CreateEmptyContactL ( )

    IMPORT_C CPbkContactItem *CreateEmptyContactL()

    Returns a new contact card with default fields.

    Returns: A new empty contact item object.

    Database ( )

    IMPORT_C CContactDatabase &Database()

    Returns the underlying CContactDatabase object. Use only if this class's API is not enough for your purposes.

    See also: CContactDatabase

    Returns: The underlying Symbian Contacts model CContactDatabase instance.

    DeleteContactGroupL ( TContactItemId, TBool )

    IMPORT_C voidDeleteContactGroupL(TContactItemIdaContactId,
    TBoolaImmediateNotify = EFalse
    )

    Deletes a contact group from the database.

    See also: CContactDatabase::DeleteContactL

    ParameterDescription
    aContactIdContact group to be deleted.
    aImmediateNotifySend notification to observers immediately. NOTE: send immediately will result in observers (MPbkContactDbObserver) receiving the event twice!

    DeleteContactL ( TContactItemId, TBool )

    IMPORT_C voidDeleteContactL(TContactItemIdaContactId,
    TBoolaImmediateNotify = EFalse
    )

    Deletes a contact item from the database.

    See also: CContactDatabase::DeleteContactL

    ParameterDescription
    aContactIdContact item to be deleted.
    aImmediateNotifySend notification to observers immediately. NOTE: send immediately will result in observers (MPbkContactDbObserver) receiving the event twice!

    DeleteContactsL ( const CContactIdArray &, TBool )

    IMPORT_C voidDeleteContactsL(const CContactIdArray &aContactIds,
    TBoolaImmediateNotify = EFalse
    )

    Deletes multiple contact items from the database.

    See also: CContactDatabase::DeleteContactsL

    ParameterDescription
    aContactIdsContact items to be deleted.
    aImmediateNotifySend notification to observers immediately. NOTE: send immediately will result in observers (MPbkContactDbObserver) receiving the event twice!

    DeleteContactsOnBackgroundL ( const CContactIdArray & )

    IMPORT_C voidDeleteContactsOnBackgroundL(const CContactIdArray &aContactIds)

    Deletes multiple contacts from the database in an active object -driven asynchronous background process.

    ParameterDescription
    aContactIdsContacts to delete.

    DuplicateContactL ( TContactItemId, TBool )

    IMPORT_C TContactItemIdDuplicateContactL(TContactItemIdaId,
    TBoolaImmediateNotify = EFalse
    )

    Duplicates a contact in the database.

    ParameterDescription
    aIdId of the contact to duplicate.
    aImmediateNotifySend notification to observers immediately. NOTE: send immediately will result in observers (MPbkContactDbObserver) receiving the event twice!

    Returns: Contact id of the new duplicate.

    FieldsInfo ( )

    IMPORT_C const CPbkFieldsInfo &FieldsInfo()

    Returns the field type info array.

    See also: CPbkFieldsInfo

    Returns: All the Phonebook field types.

    FilteredContactsViewL ( TInt )

    IMPORT_C CContactViewBase &FilteredContactsViewL(TIntaFilter)

    Returns a contact view object containing all the contacts in the database that match a filter.

    See also: CContactViewBase

    ParameterDescription
    aFilterUse CContactDatabase::TContactViewFilter.

    FindAsyncL ( const TDesC &, const CPbkFieldIdArray *, MIdleFindObserver * )

    IMPORT_C CPbkIdleFinder *FindAsyncL(const TDesC &aText,
    const CPbkFieldIdArray *aFieldTypes = NULL,
    MIdleFindObserver *aObserver = NULL
    )

    Searches all contacts in the database for aText asynchronously.

    See also: CContactDatabase::FindAsyncL. CPbkIdleFinder

    ParameterDescription
    aTextText to search.
    aFieldTypesPhonebook fields types to at least include in the search. If NULL searches all fields. PLEASE NOTE: The find matches in most cases also other fields than those specified in aFieldTypes. Always loop through the returned contacts to check match in the required fields.
    aObserverObserver for this operation.

    Returns: CPbkIdleFinder object which is used to access the find results when complete. Deleting this object will cancel this asyncronous find operation.

    FindLC ( const TDesC &, const CPbkFieldIdArray * )

    IMPORT_C CContactIdArray *FindLC(const TDesC &aText,
    const CPbkFieldIdArray *aFieldTypes = NULL
    )

    Searches all contacts in the database for aText.

    See also: CContactDatabase::FindLC.

    ParameterDescription
    aTextText to search.
    aFieldTypesPhonebook fields types to at least include in the search. If NULL searches all fields. PLEASE NOTE: The find matches in most cases also other fields than those specified in aFieldTypes. Always loop through the returned contacts to check match in the required fields.

    Returns: Array of matching contact IDs.

    FsSession ( )

    IMPORT_C RFs &FsSession()const

    Returns an open file server session.

    Returns: A handle to a file server session.

    GetContactTitleL ( const CPbkContactItem & )

    IMPORT_C HBufC *GetContactTitleL(const CPbkContactItem &aItem)const

    Gets a title text for a contact or localised text for unnamed contact if contact contains no title.

    ParameterDescription
    aItemContact item for which to make the title.

    Returns: A buffer containing the title or unnamed text if no title can be generated. Caller is responsible of deleting the returned buffer.

    GetContactTitleOrNullL ( const MPbkFieldDataArray & )

    IMPORT_C HBufC *GetContactTitleOrNullL(const MPbkFieldDataArray &aContactData)

    Similar to GetContactTitleL but returns NULL if contact contains no title. Uses the MPbkFieldDataArray interface to access the field content.

    See also: CPbkContactEngine::GetContactTitleL

    ParameterDescription
    aContactDataThe contact field data array.

    Returns: Contact title, NULL if field array did not contain any fields used to for constructing contact titles.

    GetSpeedDialFieldL ( TInt, TDes & )

    IMPORT_C TContactItemIdGetSpeedDialFieldL(TIntaSpeedDialPosition,
    TDes &aPhoneNumber
    )const

    Returns a speed dial contact.

    See also: CContactDatabase::GetSpeedDialFieldL.

    ParameterDescription
    aSpeedDialPositionSpeed dial position number.
    aPhoneNumberPhone number

    IsSpeedDialAssigned ( const CPbkContactItem &, TInt )

    IMPORT_C TBoolIsSpeedDialAssigned(const CPbkContactItem &aItem,
    TIntaFieldIndex
    )const

    Returns ETrue if this field has been assigned a speed dial position.

    ParameterDescription
    aItemcontact Item to check for speed dial.
    aFieldIndexIndex of the field to check. This is an index into aItem.CardFields().

    Returns: ETrue if Speed dial exitst, EFalse if not.

    IsTitleField ( TPbkFieldId )

    IMPORT_C TBoolIsTitleField(TPbkFieldIdaFieldId)const

    Returns ETrue if field is one of the fields used in building the contact title.

    See also: GetContactTitleL GetContactTitleOrNullL

    ParameterDescription
    aFieldIdThe id of the field.

    Returns: ETrue if aFieldId is type of a field used to build contact titles.

    MatchPhoneNumberL ( const TDesC &, const TInt )

    IMPORT_C CContactIdArray *MatchPhoneNumberL(const TDesC &aNumber,
    const TIntaMatchLengthFromRight
    )

    Call-through for new Phone number matching function in 6.2 version of class CContactDatabase. If you don't need any other functionality from CPbkContactEngine than this consider using the CContactDatabase API directly. See Symbian Contacts Model documentation for CContactDatabase::MatchPhoneNumberL use.

    See also: CContactDatabase::MatchPhoneNumberL(const TDesC&,const TInt)

    NameDisplayOrderL ( )

    IMPORT_C TPbkNameOrderNameDisplayOrderL()

    NameSeparator ( )

    IMPORT_C TCharNameSeparator()const

    NewL ( RFs * )

    IMPORT_C CPbkContactEngine *NewL(RFs *aFs = NULL)[static]

    Creates a new Phonebook engine object and connects to the default contact database. If the default database does not exist it is created.

    Exceptions
    KErrCorrupt

    if the database is corrupted.

    ParameterDescription
    aFsAn open file server connection. If !=NULL aFs is used instead of a locally created RFs connection. aFs must remain connected for the lifetime of the returned object.

    Returns: A new instance of this class.

    NewL ( const TDesC &, TBool, RFs * )

    IMPORT_C CPbkContactEngine *NewL(const TDesC &aFileName,
    TBoolaReplace = EFalse,
    RFs *aFs = NULL
    )[static]

    OpenContactGroupL ( TContactItemId )

    IMPORT_C CContactGroup *OpenContactGroupL(TContactItemIdaId)

    Opens a Contact group for modification.

    See also: CContactDatabase::OpenContactL

    ParameterDescription
    aIdGroups id

    Returns: Contact group object.

    OpenContactGroupLCX ( TContactItemId )

    IMPORT_C CContactGroup *OpenContactGroupLCX(TContactItemIdaId)

    Opens a Contact group for modification. Pushes the returned contact group object and a lock item on the cleanup stack.

    See also: CContactDatabase::OpenContactLX

    ParameterDescription
    aIdGroups id

    Returns: Contact group object.

    OpenContactL ( TContactItemId )

    IMPORT_C CPbkContactItem *OpenContactL(TContactItemIdaContactId)

    Opens a contact and returns a phonebook contact item.

    See also: CContactDatabase::OpenContactL

    ParameterDescription
    aContactIdContact item id to be opened.

    Returns: A Phonebook contact item that is marked as open in the database.

    OpenContactLCX ( TContactItemId )

    IMPORT_C CPbkContactItem *OpenContactLCX(TContactItemIdaContactId)

    Same as OpenContactL, but leaves a lock record AND the opened contact object on the cleanup stack. Use CleanupStack::PopAndDestroy(2) to close the contact and destroy the returned object. First pop pops the contact object and second the lock object.

    See also: CContactDatabase::OpenContactLX

    ParameterDescription
    aContactIdContact item id to open.

    Returns: A Phonebook contact item that is marked as open in the database.

    ReadContactGroupL ( TContactItemId )

    IMPORT_C CContactGroup *ReadContactGroupL(TContactItemIdaId)

    Reads a Contact group.

    See also: CContactDatabase::ReadContactL

    ParameterDescription
    aIdGroup id.

    Returns: Contact group object.

    ReadContactL ( TContactItemId, const CPbkFieldIdArray * )

    IMPORT_C CPbkContactItem *ReadContactL(TContactItemIdaContactId,
    const CPbkFieldIdArray *aFieldTypes = NULL
    )

    Reads a contact and returns a phonebook contact item.

    See also: CContactDatabase::ReadContactL

    ParameterDescription
    aContactIdContact item id to be read.
    aFieldTypesArray of types of fields to read in, all fields are read if NULL (which is default). NOTE: when using this parameter ReadContactL may return more fields than expected; for example if aFieldTypes contains any phonenumber the method may return all phone number fields of the contact.

    Returns: A new Phonebook contact item.

    ReadContactLC ( TContactItemId, const CPbkFieldIdArray * )

    IMPORT_C CPbkContactItem *ReadContactLC(TContactItemIdaContactId,
    const CPbkFieldIdArray *aFieldTypes = NULL
    )

    Same as ReadContactL, but leaves the returned contact item on the cleanup stack.

    ParameterDescription
    aContactIdContact item id to be read.
    aFieldTypesArray of types of fields to read in, all fields are read if NULL (which is default). NOTE: when using this parameter ReadContactL may return more fields than expected; for example if aFieldTypes contains any phonenumber the method may return all phone number fields of the contact.

    Returns: A new Phonebook contact item.

    ReadMinimalContactLC ( TContactItemId )

    IMPORT_C CPbkContactItem *ReadMinimalContactLC(TContactItemIdaContactId)

    Same as ReadContactLC but reads only minimal information. See Symbian Contacts Model documentation for definition of "minimal" in this case.

    See also: CContactDatabase::ReadMinimalContactL

    ParameterDescription
    aContactIdContact item id to be read.

    Returns: A new phonebook contact item. Leaves the item on the cleanup stack.

    RemoveContactFromGroupL ( TContactItemId, TContactItemId )

    IMPORT_C voidRemoveContactFromGroupL(TContactItemIdaItemId,
    TContactItemIdaGroupId
    )

    Removes a contact from a group

    See also: CContactDatabase::RemoveContactFromGroupL

    ParameterDescription
    aItemIdContact to be removed from group.
    aGroupIdGroup where the contact will be removed from.

    RemoveSpeedDialFieldL ( TContactItemId, TInt )

    IMPORT_C voidRemoveSpeedDialFieldL(TContactItemIdaContactId,
    TIntaSpeedDialPosition
    )

    Removes a speed dial from a contact.

    See also: CContactDatabase::RemoveSpeedDialFieldL.

    ParameterDescription
    aContactIdContact item to remove the speed dial from.
    aSpeedDialPositionSpeed dial position number to remove.

    ReplaceL ( RFs * )

    IMPORT_C CPbkContactEngine *ReplaceL(RFs *aFs = NULL)[static]

    Replaces the default contact database and connects to it. See Symbian Contacs model documentation for CContactDatabase::ReplaceL for possible leave codes. PLEASE NOTE: all data in the existing database will be lost!

    See also: CContactDatabase::ReplaceL

    ParameterDescription
    aFsAn open file server connection. If !=NULL aFs is used instead of a locally created RFs connection. aFs must remain connected for the lifetime of the returned object.

    Returns: A new instance of this class.

    SetCompressUi ( MPbkCompressUi * )

    IMPORT_C voidSetCompressUi(MPbkCompressUi *aCompressiUi)

    SetFieldAsSpeedDialL ( CPbkContactItem &, TInt, TInt )

    IMPORT_C voidSetFieldAsSpeedDialL(CPbkContactItem &aItem,
    TIntaFieldIndex,
    TIntaSpeedDialPosition
    )

    Sets a speed dial to a contact field.

    See also: CContactDatabase::SetFieldAsSpeedDialL

    ParameterDescription
    aItemContact item to add speed dial to.
    aFieldIndexField index to add Speed dial to.
    aSpeedDialPositionSpeed dial position number to set to the field.

    SetNameDisplayOrderL ( TPbkNameOrder )

    IMPORT_C voidSetNameDisplayOrderL(TPbkNameOrderaNameOrder)

    SetNameSeparatorL ( TChar )

    IMPORT_C voidSetNameSeparatorL(TCharaSeparator)

    SortOrderManager ( )

    const CPbkSortOrderManager &SortOrderManager()const

    Static ( )

    IMPORT_C CPbkContactEngine *Static()[static]

    Returns the global Phonebook engine instance, NULL if no instance created yet. Note1: Uses thread local storage (TLS), which is slow. Cache the returned pointer if it is used more than one time! Note2: Only the first engine instance created in calling thread can be accessed with this function.

    Returns: Global Phonebook engine instance.

    UnnamedTitle ( )

    IMPORT_C const TDesC &UnnamedTitle()const

    Returns the localised title text to use for unnamed contacts.

    Returns: Localised title text to use for unnamed contacts.

    © Nokia 2011.