/*
* Copyright (c) 2006-2007 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:  The view that handles paired devices.
*
*/
#ifndef BTUIDEVICECONTAINER_H
#define BTUIDEVICECONTAINER_H

#include <aknview.h>                // AVKON components
#include <aknlists.h>
#include <aknPopup.h>               // Commands popup window
#include <eikclbd.h>                // For column listbox access
#include <AknIconArray.h>

#include "btdevmodel.h"
#include "btui.hrh"

class CBTEngConnMan;
class CAknView;
class CBTDevModel;
class CBTUIListedDevicesView;

/**
* This class displays lists of bluetooth devices.
*
* This class is used by blocked devices view and paired devices view to show
* lists of blocked or paired devices.
*
*@lib BTUIPlugin.dll
*@since S60 v3.2
*/
NONSHARABLE_CLASS(CBTUiDeviceContainer) : public CCoeControl, 
			public MCoeControlObserver,
			public MEikListBoxObserver  
    {
    public: // Constructors and destructor

        /** Create new instance
	     * @param aView PairedDevicesView or BlockedDevicesView.
	     * @param aStorage The handler of 
	     * @param aContainerMode are we serving as blocked or paired device list		
	     * @param aParent used by SetMopParent
		 */	
		static CBTUiDeviceContainer* NewL(const TRect& aRect, 
			CBTUIListedDevicesView* aView, TBTDeviceGroup aGroup, MObjectProvider* aParent);

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

    public: // Methods ralated devicelist upkeep.

	     /** Refreshes this container to show these devices.
	     * Note: This container will not refresh screen if the listed
	     * devices have not changed.
	     *@param aDeviceArray The items to be displayed
	     *@param aSelectedItem which one of the items is selected after the refresh. 
	     *Must be between 0 and aDeviceArray.Count()-1 or -1 if the list is empty.
	     */
	    void RefreshDeviceListL(const RDeviceArray* aDeviceArray,TInt aSelectedItem);

	    /** Counts how many devices this container displays.     
	     * @return the amount of items in this container
	     */
	    TInt CountItems();

		/** 
		 * Return the currently selected item index. KErrNotFound found if
		 * this container has no items and therefore no selected item.
		 *
		 * @return index of currently selected item, or KErrNotFund if none.
		 */
		TInt CurrentItemIndex() ;   

   	private: 
		/** 2nd phase constructor 
	     * @param aView PairedDevicesView or BlockedDevicesView.
	     * @param aStorage The handler of 
	     * @param aContainerMode are we serving as blocked or paired device list		
	     * @param aParent used by SetMopParent		
		*/
		void ConstructL(const TRect& aRect, CBTUIListedDevicesView* aView, TBTDeviceGroup aGroup);

        /**
        * From CoeControl Responds to size changes. 
        * Sets the size and position of the contents of this control.
        * @param None.
        * @return None.
        */
        void SizeChanged();

        /**
        * From CoeControl Gets the number of controls contained 
        * in a compound control.        
        * @param None.
        * @return The number of component controls contained by this control.
        */
        TInt CountComponentControls() const;

        /**
        * From CoeControl Gets the specified component of a compound control.
        * @param aIndex The index of the control to get.
        * @return Reference to the component control.
        */
        CCoeControl* ComponentControl(TInt aIndex) const;

        /**
        * From CoeControl Draws the control.
        * @param aRect The region of the control to be redrawn.
        * @return None.
        */
        void Draw(const TRect& aRect) const;

        /**
        * From CoeControl Handles key events.
        * @param aKeyEvent The key event that occurred.
        * @param aType The event type.
        * @return Response to the key event.
        */
        TKeyResponse OfferKeyEventL(const TKeyEvent& aKeyEvent, TEventCode aType);        
        
        /**
        * From MCoeControlObserver Handles an event from an observed control.
        * @param aControl The control that sent the event.
        * @param aEventType The event type.
        * @return None.
        */
        void HandleControlEventL(CCoeControl* aControl,TCoeEvent aEventType);

		/** returns help context or empty context, if help is not supported 
		 */
		void GetHelpContext(TCoeHelpContext& aContext) const;
        
        /**
		* From CCoeControl
		*
		* Handles a change to the control's resources.
		*/
		void HandleResourceChange( TInt aType );

		/**
        * From CCoeControl 
        *
        * Responds to a change in focus.
        */
		void FocusChanged(TDrawNow aDrawNow);
		
		/**
        * From MEikListBoxObserver Handles list box events.
        * 
        * This is used to handle touch screen double click.
        *
        * @param aListBox The originating list box.
        * @param aEventType The event type.
        * @return None.
        */
        void HandleListBoxEventL(CEikListBox* aListBox, TListBoxEvent aEventType);
		

		/** Create descriptor representation of given device
		 * @param aDevice The device to be represented
		 * @param aListItem where the representation will be written.
		 */   
		void CreateListItemL(const TBTDevice& aDevice, TBTDeviceName& alistItem);

		/**
	    * Creates and adds local bitmap to icon array.
	    * @param aID Item ID of the masked bitmap to be created.
	    * @param aFilename Filename to be used to construct the item.
	    * @param aBitmapId The ID if bitmap 
	    * @param aMaskId The ID of bitmap's mask
		* @param aIconList The icon list for BT devices listbox.
	    */
	    void CreateAndAppendIconL( const TAknsItemID& aID,
			     				   const TDesC& aFileName,
								   const TInt aBitmapId,
								   const TInt aMaskId,
								   CAknIconArray* aIconList);
	    /**
	     * Internal leave function called by HandleResourceChange()
	     * @param aType Type of resource change
	     */
	    void HandleResourceChangeL( TInt aType );
	    
    private: 
        CAknSingleGraphicStyleListBox*  	iDeviceList;      // Other paired BT-devices list
		CBTUIListedDevicesView*				iView;			// The reference to PairedDevicesView or BlockedDevicesView
		TBTDeviceGroup						iGroup; 		// are we operating blocked or paired devices container

	};

#endif