diff -r 000000000000 -r 5f000ab63145 phoneengine/contacthandling/inc/cpecontacthandlingproxy.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/phoneengine/contacthandling/inc/cpecontacthandlingproxy.h Mon Jan 18 20:18:27 2010 +0200 @@ -0,0 +1,116 @@ +/* +* 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: This file contains the header file of the +* : CPEContactHandlingProxy class. +* +*/ + + + +#ifndef CPECONTACTHANDLINGPROXY_H +#define CPECONTACTHANDLINGPROXY_H + +// INCLUDES +#include "mpecontacthandling.h" +#include +#include + +// CLASS DECLARATION + +/** +* This proxy class provides for the access to contact information services. +* The construction of contact handling component is two-fold: +* 1) CreateFirstPhaseL() creates the proxy object along with cnt handling dummy +* 2) CreateSecondPhaseL() creates the real subject with capability to utilize +* contact database. +* +* @lib ContactHandling.lib +* @since Series60_4.0 +*/ +class CPEContactHandlingProxy + : public CBase, + public MPEContactHandling + { + public: + /** + * Create contact handling proxy and dummy implementation + * @return pointer to log handling proxy object, i.e. the handle to + * access log handling services + */ + IMPORT_C static MPEContactHandling* CreateFirstPhaseL(); + + /** + * Create contact handling sub system + * This method creates the actual log handling implementation which + * replaces the dummy component in use. The phone model should call this + * function as all the critical sub systems already enable emergency call + * capabilities. + * @param aModel, handle to the owner of this object and phone engine + * @param aFsSession, handle to the shared file server session + */ + IMPORT_C void CreateSecondPhaseL( + MPEPhoneModelInternal& aModel, + RFs& aFsSession ); + + /** + * Destructor. + */ + IMPORT_C virtual ~CPEContactHandlingProxy(); + + public: + /** + * Synchronous method for searching contact information. + * @param aCallId call id from phone engine + * aFindKey defines the key to search the contact data with + * aSearchFrom search from key + * @return possible Symbian OS error code + */ + IMPORT_C TInt FindContactInfoSync( + const TInt aCallId, + const TPEFindContactKey aFindKey ); + + /** + * Fetch number from speed dial location + * @param aLocationIndex Index to look for + * @param aNumber Filled with speed dial location phone number + * @param aContactItemId Contact item id. KErrNotFound if given location + * was not set. + * @return possible Symbian OS error code + */ + IMPORT_C TInt GetSpeedDialLocation( + TInt aLocationIndex, + TPEPhoneNumber& aNumber ); + + protected: + /** + * C++ default constructor. + */ + CPEContactHandlingProxy(); + + /** + * Constructor, second phase. + */ + void ConstructL(); + + + private: // Data + // Handle to contact handling implementation + MPEContactHandling* iContactHandling; + // Handle to contact handling dummy implementation + MPEContactHandling* iContactHandlingDummy; + }; + +#endif // CPECONTACTHANDLINGPROXY_H + +// End of File