diff -r 000000000000 -r 5f000ab63145 phoneengine/PhoneCntFinder/ContactService/inc/MPhCntPhonebookServices.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phoneengine/PhoneCntFinder/ContactService/inc/MPhCntPhonebookServices.h Mon Jan 18 20:18:27 2010 +0200 @@ -0,0 +1,138 @@ +/* +* Copyright (c) 2006 Nokia Corporation and/or its subsidiary(-ies). +* All rights reserved. +* This component and the accompanying materials are made available +* under the terms of "Eclipse Public License v1.0" +* which accompanies this distribution, and is available +* at the URL "http://www.eclipse.org/legal/epl-v10.html". +* +* Initial Contributors: +* Nokia Corporation - initial contribution. +* +* Contributors: +* +* Description: Interface for phonebook services. +* +*/ + + +#ifndef MPHCNTPHONEBOOKSERVICES_H +#define MPHCNTPHONEBOOKSERVICES_H + +#include +#include "CPhCntSingleItemFetch.h" + +class CPhCntContactId; +class MPhCntServiceRequestParam; +class CPhCntContact; + + +/** + * Interface for phonebook services. + * + * @lib PhoneCntFinder.lib + * @since S60 v3.2 + */ +NONSHARABLE_CLASS( MPhCntPhonebookServices ) + { + +public: + + /** + * Virtual destructor. + * + * @since S60 v3.2 + */ + virtual ~MPhCntPhonebookServices() {}; + + /** + * Gets user selected phone number and contact id. + * + * @since S60 v3.2 + * @param aContactId Contact id of the contact, may be null + * @param aPhoneNumber Phone number, may be null. + * @leaves KErrCancel - User canceled the fetch + * Other system wide error codes. + */ + virtual void GetUserSelectedPhoneNumberL( + CPhCntContactId*& aContactId, + HBufC*& aPhoneNumber ) = 0; + + /** + * Gets user selected voip address and contact id. + * + * @since S60 v5.0 + * @param aContactId Contact id of the contact, may be null + * @param aVoIPAddress voip address, may be null. + * @leaves KErrCancel - User canceled the fetch + * Other system wide error codes. + */ + virtual void GetUserSelectedVoIPAddressL( + CPhCntContactId*& aContactId, + HBufC*& aVoIPAddress ) = 0; + + /** + * Gets user selected dtmf number and contact id. + * + * @since S60 v3.2 + * @param aContactId Contact id of the contact, may be null + * @param aDtmfNumber Dtmf number, may be null. + * @leaves KErrCancel - User canceled the fetch + * Other system wide error codes. + */ + virtual void GetUserSelectedDtmfNumberL( + CPhCntContactId*& aContactId, + HBufC*& aDtmfNumber ) = 0; + + /** + * Create new contact to phonebook. + * + * @since S60 v3.2 + * @param aPhoneNumber Number of the new contact. + */ + virtual void CreateNewContactL( const TDesC& aPhoneNumber ) = 0; + + /** + * Adds phonenumber to existing contact. + * + * @since S60 v3.2 + * @param aPhoneNumber Phone number to be added to existing contact. + */ + virtual void UpdateExistingContactL( const TDesC& aPhoneNumber ) = 0; + + /** + * Gets a phone number from the contact. + * @param aContactLink Contact link. + * @param aCallType Number type. + * @param aNumber User selected phone number. + * @param aFieldLink Contact link (field link) to the number selected by user. + */ + virtual void GetPhoneNumberL( + const TDesC8& aContactLink, + const CPhCntSingleItemFetch::TCallType aCallType, + HBufC*& aNumber, + HBufC8*& aFieldLink ) = 0; + + /** + * Gets contact selected by user. + * + * @since S60 v3.2 + * @param aParam Parameters passed to AIW. + * @return Contact, selected by user. Ownership contact. + */ + virtual CPhCntContact* GetUserSelectedContactLC( + MPhCntServiceRequestParam& aParam ) = 0; + + /** + * Cancels outstanding request. + * + * @since S60 v3.2 + */ + virtual void CancelRequest() = 0; + +protected: + + }; + + +#endif // MPHCNTPHONEBOOKSERVICES_H