emailuis/emailui/inc/FreestyleEmailUiSettingsList.h
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Fri, 19 Feb 2010 22:37:30 +0200
branchRCL_3
changeset 8 e1b6206813b4
parent 2 5253a20d2a1e
permissions -rw-r--r--
Revision: 201003 Kit: 201007

/*
* Copyright (c) 2005-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:  Freestyle Email header file
*
*/

#ifndef FSSETTINGSSYNCLIST_H
#define FSSETTINGSSYNCLIST_H

// SYSTEM INCLUDES
#include <coecntrl.h>
#include <e32cmn.h>
#include "mfsmailrequestobserver.h"
#include <AknWaitDialog.h>
#include <aknlongtapdetector.h>

// FORWARD DECLARATIONS
class CFSMailClient;        
class CAknSingleGraphicStyleListBox;
class CEikTextListBox;
class TFSMailMsgId;
class CFSMailBox;
class CFreestyleEmailUiAppUi;

typedef CAknSingleGraphicStyleListBox CSettingsListType;


/**
 * Container class for CFsEmailSettingsList
 * 
 * @class   CFsEmailSettingsList
 */
class CFsEmailSettingsList : 
    public CCoeControl, 
    public MEikListBoxObserver, 
    public MFSMailRequestObserver,
    public MProgressDialogCallback,
    public MAknLongTapDetectorCallBack
    {
public: // Constructors and destructor.

    static CFsEmailSettingsList* NewL( 
        const TRect& aRect, 
        const CCoeControl* aParent,
        CFreestyleEmailUiAppUi& aAppUi,
        CFSMailClient& aMailClient,
        CFsEmailSettingsListView& aView );
    
    static CFsEmailSettingsList* NewLC( 
        const TRect& aRect, 
        const CCoeControl* aParent,
        CFreestyleEmailUiAppUi& aAppUi,
        CFSMailClient& aMailClient,
        CFsEmailSettingsListView& aView );
    
    virtual ~CFsEmailSettingsList();


private: // Construction.

	void ConstructL( const TRect& aRect, const CCoeControl* aParent);
    
    CFsEmailSettingsList( CFreestyleEmailUiAppUi& aAppUi,
						  CFSMailClient& aMailClient,
						  CFsEmailSettingsListView& aView );


public: // From base class CCoeControl.

    TInt CountComponentControls() const;

    CCoeControl* ComponentControl( TInt aIndex ) const;

    TKeyResponse OfferKeyEventL( const TKeyEvent& aKeyEvent, 
								 TEventCode aType );
    
    void HandleResourceChange( TInt aType );
    
    void HandlePointerEventL( const TPointerEvent& aPointerEvent );

    void AddAccountL();

    /**
     * If confirmed by the user, will delete a mailbox.
     * @return True if a mailbox was deleted, false otherwise.
     */
    TBool RemoveAccountL();

    void RequestResponseL( TFSProgress aEvent, TInt aRequestId );

    TBool PIMSyncItemVisible();


public: // From MAknLongTapDetectorCallBack.
	
    void HandleLongTapEventL( const TPoint& aPenEventLocation, 
							  const TPoint& aPenEventScreenLocation );


public: // New methods.

    CSettingsListType* ListBox();
    
    static HBufC* CreateListBoxItemLC( 
            const TDesC& aMainText );
    
    static HBufC* CreateListBoxItemLC( 
            const TDesC& aMainText,
            TInt aIconNum );
    
    // insert needed icons to list box
    void SetupListBoxIconsL();
    
    /**
     * Fills list with mailbox names given by fs mail client
     */
    void CreateAccountListL();

    /**
     * Displays mailbox create query if needed
     */
    void DisplayCreateMailboxNoteIfNeededL();

    /**
     * Fills list with captions given by settings plugin
     */
    void CreatePluginSubviewListL( const TUid& aPluginId );

    /**
     * Fills list with captions given by settings plugin
     */
    void CreatePluginPIMListL( const TUid& aPluginId );
    
    /**
     * Sets specific mailbox protocol icon by given id
     */
    void ProtocolBrandingIconL( TFSMailMsgId aMailBoxId );
    
    // list content commands
    void ClearListL();
    void AppendItemL( TDesC& aListItem );
    TInt Count();
    
    /**
     * list content will be drawn with captions 
     * received from settings plugin or
     * mailboxes received from mailclient
     * 
     * returns True if captions list
     * return False if mailbox list
     */
    TBool Get2ndLevelListIndicator();
    
    // handle user navigation
    void HandleUserSelectionsL();
    
    /**
     * Retuns specific mailbox by given index
     * Ownership tranferred
     */
    CFSMailBox* GetMailboxByIndexLC( const TInt& aIndex ) const;
    
    // get count of mailboxes in fs mailclient
    TInt GetMailboxCountL() const;
    
    /**
     * Retuns specific mailbox by given id
     * Ownership tranferred or NULL
     */
    CFSMailBox* GetMailBoxByIdL( const TUint& aMailboxId ) const;
    
    // set account info member data from selected mailbox
    void SetSelectedAccountInfo( const TFSMailMsgId& aAccountInfo );

    // set private settings plugin Uid to given value
    void SetPluginSettingsUid( const TUid& aPluginId );
    
    // activate selected sub view from plugin
    void ActivateMailSettingsPluginSubViewL( TInt aSubViewId );

    // open dialog with PIM service items
    void OpenPIMServiceDialogL();
    
    /**
     * returns needed settings plugin instance from view stack
     * or creates new one add it to view stack and return pointer
     * Ownership is not transferred
     */
    CESMailSettingsPlugin* GetSettingsPluginL( TUid aUid );
    
    // set subview list index to given value
    void SetSelectedSubListIndex( TInt aIndex );

    // set main list index in parent
    void SetSelectedMainListIndex( TInt aIndex );
    
    // get main list index from parent
    TInt GetSelectedMainListIndex() const;
    
    // This sets the flag that informs that we are in the personal information management subview   
    void SetPimListActivation(TBool aActivation);

    // Creates and passes ownership of title pane text appropriate for the current view
    HBufC* CreateTitlePaneTextLC() const;
    
    void GoToTop();
    void GoToBottom();
    
    void PageUp();
    void PageDown();

    /**
     * Used to check if the currently selected item is a mailbox.
     * @param True if the selected item is a mailbox. False otherwise.
     */
    TBool SelectedItemIsMailbox() const;

    /**
     * Removes the focus.
     */
    void ClearFocus(); 


public:

    enum TControls
        {
        EListBox,
        ELastControl
        };
    enum TListBoxImages
        {
        EListBoxFirstUserImageIndex
        };  
    

protected: // From base class CCoeControl.

    void SizeChanged();


protected: // From MProgressDialogCallback.

    void DialogDismissedL( TInt aButtonId );


private: // From base class CCoeControl.

    void Draw( const TRect& aRect ) const;


private:

    void HandleListBoxEventL( CEikListBox *aListBox, TListBoxEvent aEventType );
    void InitializeControlsL();
    void LayoutControls();
    void LoadAccountsToListL();
    void SetDefaultPIMAccountL();
    TPtrC GetMailBoxNameL( const CFSMailBox& aMailBox ) const;


private: // Data.

    enum TFsEmailSettingsSubViewType
        {
        EFsEmailSettingsMainListView,
        EFsEmailSettingsMailboxView,
        EFsEmailSettingsPimView
        };

    TFsEmailSettingsSubViewType iCurrentSubView;
    CSettingsListType* iListBox;
    CFreestyleEmailUiAppUi& iAppUi;
    CCoeControl* iFocusControl;
    CAknLongTapDetector* iLongTapDetector;
    CFSMailClient& iMailClient;
    TFSMailMsgId iSelectedAccountInfo;
    TUid iSelectedPluginSettings;
    TInt iPIMSyncMailboxIndex;
    TBool iPIMListActivation;
    TBool iPIMServiceSettingsSelection;
    CAknWaitDialog* iWaitDialog;
    TInt iMailboxCount;
    TInt iDeleteMailboxId;
    TInt iDeletedIndex;
    TInt iPIMSyncCount;
    TInt iSelectedSubListIndex;
    CFsEmailSettingsListView& iView; 
    TBool iLongTapEventConsumed;
    
	// Used to properly handle taps. First tap highlights an item on the
    // settings list, second tap selects the item.
    TInt iPrevSelected;
    };


#endif // FSSETTINGSSYNCLIST_H