/*

* 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 CPbkxRclResultInfoDlg

*

*/

#ifndef CPBKXRCLRESULTINFODLG_H

#define CPBKXRCLRESULTINFODLG_H

#include "cpbkxrclbasedlg.h"

#include "pbkxrclengineconstants.h"

#include <eiklbo.h>                 // MEikListBoxObserver

class CAknNavigationControlContainer;

class CAknNavigationDecorator;

class CAknTabGroup;

class CAknTitlePane;

class MPbkxRclContactRetrieval;

class CPbkContactItem;

class CPbkContactEngine;

class CPbkxRclCbRSender;

class CPbkxRclActionServiceWrapper;

class TPbkContactItemField;

class CPbkFieldArray;

/**

 *  Result information view implementation.

 *

 *  @lib pbkxrclengine.lib

 *  @since S60 3.1

 */

class CPbkxRclResultInfoDlg : public CPbkxRclBaseDlg,

							  public MEikListBoxObserver

    {

public: // constructor and destructor

    /**

    * Two-phase constructor.

    *

    * @param aIndex Selected item index, is updated by dialog after selection

    *               is made.

    * @param aArray Array of list box items.

    * @param aCommand Observer which executes dialog menu commands.

    * @param aContactRetrieval Used to get more information about contacts.

    * @param aContactEngine Used to create pbk contacts.

    * @param aActionService Contact action service.

    * @param aContactSelectorEnabled Flag indicating whether contact

    *                                selection is enabled.

    * @param aActiveItemIndex Initial active item index.

    * @return Created object.

    */

    static CPbkxRclResultInfoDlg* NewL( 

        TInt& aIndex, 

        CDesCArray* aArray,

        MEikCommandObserver* aCommand,

        MPbkxRclContactRetrieval* aContactRetrieval,

        CPbkContactEngine& aContactEngine,

        CPbkxRclActionServiceWrapper& aActionService,

        TBool aContactSelectorEnabled,

        TInt aActiveItemIndex );

    /**

    * Destructor.

    */

    virtual ~CPbkxRclResultInfoDlg();

public: // methods from base classes

    /**

    * Hides option menu items that are not supposed to be shown.

    *

    * @param aResourceId Menu resource id.

    * @param aMenuPane Menu pane.

    */

    virtual void DynInitMenuPaneL( TInt aResourceId, CEikMenuPane* aMenuPane );

    /**

    * Gets help context for this view.

    *

    * @param aContext On return, contains help context information

    */

    virtual void GetHelpContext( TCoeHelpContext& aContext ) const;

public: // new methods

    /**

    * Executes dialog and destroys it after it is closed.

    */

    void ExecuteLD();

    /**

    * Closes dialog.

    */

    void Close();

    /**

    * Sends callback request to selected contact.

    */

    void SendCallbackRequestL();

    /**

    * Sends bussiness card of currently selected contact.

    */ 

    void SendBusinessCardL();

    /**

    * Updates existing contact with currently selected field.

    *

    * If update is successful, a string is constructed which is shown

    * to the user.

    *

    * @return Constructed string to be shown to the user or NULL, if

    *         operation failed.

    */

    HBufC* UpdateExistingContactL();

protected: // redefinition of functions in the base class

    /**

    * Handles key events.

    *

    * @param aKeyEvent Key event.

    * @param aType Type of the key event.

    * @return Key response (handled/not handled).

    */

    TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent, TEventCode aType );

	// MEikListBoxObserver

    /**

     * Listbox event handler.

     *

     * @param aListBox that invoked the event.

     * @param aEventType Type of the event.

     */

    virtual void HandleListBoxEventL(

       CEikListBox* aListBox,

       TListBoxEvent aEventType );

    TBool OkToExitL( TInt aButtonId );

private: // methods used internally

    /**

    * Setup status pane (tab group and title pane text).

    */

    void SetupStatusPaneL();

    /**

    * Setup tab group.

    *

    * Each contact gets its own tab.

    */

    void SetupTabGroupL();

    /**

    * Sets the visibility of navi indicators.

    */

    void SetNaviIndicatorsL();

    /**

    * Sets title pane text.

    */

    void SetTitlePaneTextL();

    /**

    * Reverts changes made to status pane.

    */

    void ResetStatusPane();

    /**

    * Removes tab group and frees the resources.

    */

    void ResetTabGroup();

    /**

    * Creates list box entries of the currently selected contact.

    */

    void CreateListBoxEntriesL();

    /**

    * Fetches current contact from contact retrieval interface.

    *

    * @return ETrue if fetching is successful, EFalse otherwise.

    */

    TBool FetchCurrentContactL();

    /**

    * Updates both list box entries and status pane.

    */

    void UpdateDialogL();

    /**

    * Returns ETrue if there are call actions available, EFalse

    * otherwise.

    *

    * @return ETrue if there is call actions available.

    */

    TBool CallActionsAvailable() const;

    /**

    * Returns ETrue if focus is on phone number field.

    *

    * @return ETrue if focus is on phone number field.

    */

    TBool FocusOnPhoneNumberField() const;

    /**

    * Returns ETrue if focus is on email address field.

    *

    * @return ETrue if focus is on email address field.

    */

    TBool FocusOnEmailAddressField() const;

    /**

    * Returns ETrue if focus is on voip field.

    *

    * @return ETrue if focus is on voip field.

    */

    TBool FocusOnVoipField() const;

    /**

    * Returns current field focused.

    */

    TPbkContactItemField& CurrentField() const;

private: // constructors

    /**

    * Constructor.

    *

    * @param aIndex Selected item index, is updated by dialog after selection

    *               is made.

    * @param aArray Array of list box items.

    * @param aCommand Observer which executes dialog menu commands.

    * @param aContactRetrieval Used to get more information about contacts.

    * @param aContactEngine Used to create pbk contacts.

    * @param aActionService Contact action service.

    * @param aContactSelectorEnabled Flag indicating whether contact

    *                                selection is enabled.

    * @param aActiveItemIndex Initial active item index.

    */

    CPbkxRclResultInfoDlg( 

        TInt& aIndex, 

        CDesCArray* aArray, 

        MEikCommandObserver* aCommand,

        MPbkxRclContactRetrieval* aContactRetrieval,

        CPbkContactEngine& aContactEngine,

        CPbkxRclActionServiceWrapper& aActionService,

        TBool aContactSelectorEnabled,

        TInt aActiveItemIndex );

    /**

    * Second-phase constructor.

    */

    void ConstructL();    

private: // data

    // Array of items. Not owned.

    CDesCArray* iItems;

    // Contacts which information are shown. Owned.

    CPbkContactItem* iCurrentContact;

    // Navi pane of the current UI application. Not owned.

    CAknNavigationControlContainer* iNaviPane;

    // Navigation decorator. Owned.

    CAknNavigationDecorator* iNaviDecorator;

    // Navigation tab group. Not owned.

    CAknTabGroup* iTabGroup;

    // Title pane of the application. Not owned.

    CAknTitlePane* iTitlePane;

    // Currently active tab.

    TInt iActiveTabIndex;

    // Flag indicating whether contact selector is enabled or not.

    TBool iContactSelectorEnabled;

    // Interface through which contact details are retrieved. Not owned.

    MPbkxRclContactRetrieval* iContactRetrieval;

    // Contact engine to fetch the correct item priorities.

    CPbkContactEngine& iContactEngine;

    // Action service wrapper for handling menu commands.

    CPbkxRclActionServiceWrapper& iContactActionService;

    // Text shown in wait note when details are retrieved. Owned.

    RBuf iWaitNoteText;

    // Original title pane text. Owned.

    HBufC* iTitlePaneText;

    // Class for making callback requests. Owned.

    CPbkxRclCbRSender* iCallbackReqSender;

    // Currently visible fields. Owned.

    CPbkFieldArray* iVisibleFields;

    // Flag indicating that we are exiting dialog. After this is set

    // no key presses are handled.

    TBool iExit;

    };

#endif // CPBKXRCLRESULTINFODLG_H