emailcontacts/remotecontactlookup/engine/inc/cpbkxrclvcardsender.h
changeset 0 8466d47a6819
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/emailcontacts/remotecontactlookup/engine/inc/cpbkxrclvcardsender.h	Thu Dec 17 08:39:21 2009 +0200
@@ -0,0 +1,150 @@
+/*
+* Copyright (c) 2008 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:  Definition of the class CPbkxRclvCardSender.
+*
+*/
+
+
+#ifndef CPBKXRCLVCARDSENDER_H
+#define CPBKXRCLVCARDSENDER_H
+
+#include <e32base.h>
+
+class CPbkContactEngine;
+class CPbkContactItem;
+class CBCardEngine;
+class CSendUi;
+class CEikonEnv;
+class CRichText;
+class CPbkxRclContactConverter;
+
+/**
+* Class that handles sending business card using CSendUI.
+*
+* @lib pbkxrclengine.lib
+* @since 3.1
+*/
+class CPbkxRclvCardSender : public CBase
+    {
+public: // constructor and destructor
+
+    /**
+    * Creates new object.
+    *
+    * @param aContactEngine Handle to contact engine.
+    * @return Created object.
+    */
+    static CPbkxRclvCardSender* NewL( CPbkContactEngine& aContactEngine );
+
+    /**
+    * Creates new object.
+    *
+    * Pointer to the created object is left in the cleanupstack.
+    *
+    * @param aContactEngine Handle to contact engine.
+    * @return Created object.
+    */
+    static CPbkxRclvCardSender* NewLC( CPbkContactEngine& aContactEngine );
+
+    /**
+    * Destructor.
+    */
+    virtual ~CPbkxRclvCardSender();
+
+public: // new methods
+
+    /**
+    * Send business card of the given contact item.
+    *
+    * @param aContactItem Contact item which is sent as business card.
+    */
+    void SendvCardL( 
+            CPbkContactItem& aContactItem, 
+            CPbkxRclContactConverter& aContactConverter );
+    
+private: // methods used internally
+
+    /**
+    * Creates temporary file of the contact item.
+    *
+    * @param aContactItem Contact item.
+    */
+    void CreateTempFileL( 
+            CPbkContactItem& aContactItem, 
+            CPbkxRclContactConverter& aContactConverter );
+
+    /**
+    * Destroys temporary file.
+    */
+    void DestroyTempFileL();
+
+    /**
+    * Creates rich text object of the temporary file.
+    *
+    * @return Created rich text object. Ownership is transferred.
+    */
+    CRichText* CreateRichTextFromFileLC();
+
+    /**
+    * Creates filter.
+    */
+    void CreateFilterL();
+
+    //<cmail> getting temporary file name is not hard coded
+    /**
+    * Creates a temporary file name on device memory, in private 
+    * folder of the process, which loads this dll.
+    *
+    * @param aFileName file name is returned here
+    * @return error code
+    */
+    TInt GetTemporaryFileNameL( TFileName& aFileName, CPbkContactItem& aContactItem );
+    //</cmail>
+
+private: // constructors
+
+    /**
+    * Constructor.
+    */
+    CPbkxRclvCardSender();
+
+    /**
+    * Second-phase constructor.
+    *
+    * @param aContactEngine Handle to contact engine.
+    */
+    void ConstructL( CPbkContactEngine& aContactEngine );
+
+private: // data
+
+    // Used to send the business card. Owned.
+    CSendUi* iSendUi;
+
+    // Card engine. Owned.
+    CBCardEngine* iCardEngine;
+
+    // Filter. Owned.
+    CArrayFixFlat<TUid>* iFilter;
+   
+    // Eikon environment. Not owned.
+    CEikonEnv* iEikEnv;
+    //<cmail>
+    // file name for temporary storage
+    TFileName iTempFileName;
+    //</cmail>
+ 
+    };
+
+#endif
+