emailcontacts/contactactionservice/inc/cfscactionutils.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Tue, 14 Sep 2010 20:48:24 +0300
branchRCL_3
changeset 70 968773a0b6ef
parent 0 8466d47a6819
child 80 726fba06891a
permissions -rw-r--r--
Revision: 201033 Kit: 201035

/*
* 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:  Declaration of CFscActionUtils.
 *
*/


#ifndef C_FSCACTIONUTILS_H
#define C_FSCACTIONUTILS_H

#include <e32base.h>
#include "mfscactionutils.h"
#include <RPbkViewResourceFile.h>

// FORWARD DECLARATIONS
class CPbkContactItem;
class CRepository;
class CRCSEProfileRegistry;
class CFscContactAction;
class MFscReasonCallback;
class CVPbkContactManager;
class MVPbkStoreContact;
class MVPbkStoreContactField;
class CFscAddressSelect;

/**
 *  Action utils.
 *  Implementation of a action utils.
 *
 *  @since S60 3.1
 */
class CFscActionUtils : public CBase, public MFscActionUtils
    {

public:
    // Constructors and destructor

    /**
     * Two-phased constructor.
     *
     * @param aContactManager Contact Manager
     * @return New instance of CFscActionUtils
     */
    static CFscActionUtils* NewL( CVPbkContactManager& aContactManager );

    /**
     * Two-phased constructor.
     *
     * @param aContactManager Contact Manager
     * @return New instance of CFscActionUtils
     */
    static CFscActionUtils* NewLC( CVPbkContactManager& aContactManager );

    /**
     * Destructor.
     */
    virtual ~CFscActionUtils();

public:
    // From base class MFscActionUtils

    /**
     * @see MFscActionUtils::ContactEngine
     */
    CVPbkContactManager& ContactManager();

    /**
     * @see MFscActionUtils::ShowInfoNoteL
     */
    void ShowInfoNoteL( TInt aNote, const HBufC* aContactName );

    /**
     * @see MFscActionUtils::ShowInfoNoteL
     */
    void ShowInfoNoteL( TInt aNote, TInt aCounter );
    
    /**
     * @see MFscActionUtils::ShowCnfNoteL
     */
    void ShowCnfNoteL( TInt aNote, const HBufC* aName );
        
    /**
     * @see MFscActionUtils::ShowNumberMissingDialogL
     */
    TInt ShowNumberMissingNoteL( TInt aMissingCount, TInt aTotalCount,
            TInt aNote, TInt aDialog );

    /**
     * @see MFscActionUtils::GetContactNameL
     */
    HBufC* GetContactNameL( MVPbkStoreContact& aStoreContact );

    /**
     * @see MFscActionUtils::GetVoiceCallNumberL
     */
    TInt GetVoiceCallNumberL( MVPbkStoreContact& aStoreContact, 
            TDes& aNumber );

    /**
     * @see MFscActionUtils::GetVideoCallNumberL
     */
    TInt GetVideoCallNumberL( MVPbkStoreContact& aStoreContact, 
            TDes& aNumber );

    /**
     * @see MFscActionUtils::GetVoipAddressL
     */
    TInt GetVoipAddressL( MVPbkStoreContact& aStoreContact, TDes& aNumber );

    /**
     * @see MFscActionUtils::GetConfInfoL
     */
    TInt GetConfInfoL( MVPbkStoreContact& aStoreContact, TDes& aConfNum,
            TDes& aConfId, TDes& aConfPin );

    /**
     * @see MFscActionUtils::GetPocAddressL
     */
    TInt GetPocAddressL( MVPbkStoreContact& aStoreContact, 
            TDes& aPocAddress );

    /**
     * @see MFscActionUtils::GetMessageAddressL
     */
    TInt GetMessageAddressL( MVPbkStoreContact& aStoreContact,
            TDes& aMsgAddress );
    
    /**
     * @see MFscActionUtils::GetEmailAddressL
     */
    TInt GetEmailAddressL( MVPbkStoreContact& aStoreContact,
            TDes& aEmailAddress );

    /**
     * @see MFscActionUtils::RemoveInvalidChar
     */
    void RemoveInvalidChar( const TDesC& aNumber, const TDesC& aValidChars,
            TDes& aOutNumber );

    /**
     * @see MFscActionUtils::IsContactNumberAvailableL
     */
    TBool IsContactNumberAvailableL( MVPbkStoreContact& aStoreContact,
            TContactNumberType aContactNumberType );

    /**
     * @see MFscActionUtils::Is3GNetworkAvailable
     */
    TBool Is3GNetworkAvailable();

    /**
     * @see MFscActionUtils::IsOfflineModeL
     */
    TBool IsOfflineModeL();

    /**
     * @see MFscActionUtils::IsPttConfiguredL
     */
    TBool IsPttConfiguredL();

    /**
     * @see MFscActionUtils::IsVoipConfiguredL
     */
    TBool IsVoipConfiguredL();

    /**
     * @see MFscActionUtils::SkinIconL
     */
    CGulIcon* SkinIconL( TAknsItemID aItemId, const TDesC& aFilename,
            TInt aFileBitmapId, TInt aFileMaskId );

    /**
     * @see MFscActionUtils::ActionPriorityL
     */
    TInt ActionPriority( TUint32 aActionPriorityCrKey, 
            TInt aDefaultPriority );

    /**
     * @see MFscActionUtils::CreateActionL
     */
    CFscContactAction* CreateActionL( MFscReasonCallback& aReasonCallback,
            TUid aContactActionUid, TUint64 aActionType,
            TInt aActionMenuTextResourceId, CGulIcon* aIcon );
    
    /**
     * Closes selection dialog.
     */
    void CloseSelectDialogL();
    
protected:
    
    /**
     * Opens selection dialog.
     * 
     * @param aResourceId resource identifying type of select dialog.
     * @param aStoreContact contact for which dialog is opened.
     * 
     * @return selected contact field or NULL if canceled. 
     */
    MVPbkStoreContactField* OpenSelectDialogL( TInt aResourceId, 
            MVPbkStoreContact& aStoreContact );    

private:
    // Private constructors

    /**
     * Constructor.
     *
     * @param aContactManager Contact Manager
     */
    CFscActionUtils( CVPbkContactManager& aContactManager );

    /**
     * Second phase constructor.
     */
    void ConstructL();
    
private:
    // Private methods

    /**
     * Returns full file path with drive.
     * 
     * @param aFilePath path to file with filename
     */
    TPtrC GetFileDirL( const TDesC& aFilePath );
    
    /**
     * Find and add resource file to the list maintained by CCoeEnv.
     * Resource file must be deleted (remove from the list) after usage.
     * @return The offset value defined for this resource file
     */
    TInt FindAndAddResourceFileL();

    /**
     * Helper method that appends a specific field to a buffer of contact 
     * data.
     * The method assumes that fsactionutils.rsc resource file has been
     * already added to CCoeEnv before being called.
     * 
     * @param aContact         Buffer to which the field data is appended.
     * @param aFieldResourceId Id of the field data (which is being added to
     *                         contact buffer.
     * @param aStoreContact    Reference to the contact in Phonebook store 
     *                         from which the field data that is added to
     *                         contact buffer is fetched.
     * @param aAddSpace        Whether to add a whitespace before appending
     *                         the field data to contact buffer.
     */
    void AppendFieldToContactL( TDes& aContact,
            TInt aFieldResourceId,
            MVPbkStoreContact& aStoreContact,
            TBool aAddSpace = EFalse );
    
private:
    // Private members

    /**
     * Contact Manager.
     */
    CVPbkContactManager& iContactManager;

    /**
     * Priority cenrep
     * Own.
     */
    CRepository* iRep;

    /**
     * CRCSEProfileRegistry for checking voip status
     */
    CRCSEProfileRegistry* iRCSEProfileRegistry;
    
    /**
     * Letter drive.
     */
    TFileName iLetterDrive;
    
    /**
     * Phone number/address selection dialog.
     * Own.
     */
    CFscAddressSelect* iAddressSelect;
    };

#endif // C_FSCACTIONUTILS_H