mpxplugins/viewplugins/views/commoncontainer/inc/mpxcommoncontainerhgimp.h
changeset 0 ff3acec5bc43
child 21 a1247965635c
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mpxplugins/viewplugins/views/commoncontainer/inc/mpxcommoncontainerhgimp.h	Thu Dec 17 08:45:05 2009 +0200
@@ -0,0 +1,701 @@
+/*
+* Copyright (c) 2006 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:  MPX common container definition for hg lib.
+*
+*/
+
+
+
+#ifndef CMPXCOMMONCONTAINERHGIMP_H
+#define CMPXCOMMONCONTAINERHGIMP_H
+
+
+// INCLUDES
+#include <e32hashtab.h>
+#include <ganes/HgScrollBufferObserverIface.h>
+#include <ganes/HgSelectionObserverIface.h>
+#include <ganes/HgItem.h>
+#include <thumbnailmanager.h>
+#include <thumbnailmanagerobserver.h>
+
+#include <mpxattribute.h>
+#include "mpxcommoncontainer.h"
+
+
+// FORWARD DECLARATIONS
+class MEikCommandObserver;
+class CEikMenuPane;
+class MEikListBoxObserver;
+class CAknIconArray;
+class CMPXCommonListBoxArrayBase;
+class CMPXMediaArray;
+class CAknSearchField;
+class MCoeControlObserver;
+class CMPXCommonContainerMediaHelper;
+class CMPXCommonContainerTextureManager2;
+class CMPXCommonUiHelper;
+class CHgScroller;
+class CHgScrollerWithTitle;
+class CAknsBasicBackgroundControlContext;
+
+//Albumart request queue
+struct TAlbumArtRequest
+	{
+  TInt        iIndex;
+	HBufC*		iAlbumArtUri;
+  TSglQueLink iLink;
+	};
+
+
+// CLASS DECLARATION
+
+/**
+ *  Container class for Hg common container.
+ *  The view class should implement the following virtual function
+ *  from MEikCommandObserver
+ *
+ *  virtual void ProcessCommandL(TInt aCommandId);
+ *
+ *  common container uses this to pass commands back to the view class
+ *  the commands supported are defined in mpxcommoncontainer.hrh
+ *
+ *  view container class owns this class to access List widget commands, receive
+ *  CoeControl events and GetHelpContext(). The view container class should
+ *  implement the following virtual functions from MViewContainer
+ *
+ *  virtual void HandleKeyEvent();
+ *  virtual void HandleHelpContent();
+ *
+ *  common container uses this to pass CoeControl events back to the view
+ *  container class.
+ *
+ *  view class should handle the following commands in ProcessCommandL
+ *  from MEikCommandObserver:
+ *
+ *  EMPXCmdCommonDelete  // delete key pressed
+ *  EMPXCmdCommonResourceChange  // resource change
+ *  EMPXCmdCommonEnterKey  // enter key pressed
+ *
+ *  @lib mpxcommoncontainer.lib
+ *  @since S60 v3.1
+ */
+NONSHARABLE_CLASS( CMPXCommonContainerHgImp )
+    : public CCoeControl
+    , public MCoeControlObserver
+    , public MMPXCommonContainer
+	, public MHgScrollBufferObserver
+	, public MHgSelectionObserver
+    , public MThumbnailManagerObserver
+    {
+public:
+
+    /**
+     * default C++ constructor.
+     */
+    CMPXCommonContainerHgImp();
+
+    /**
+     * Destructor.
+     */
+    virtual ~CMPXCommonContainerHgImp();
+
+
+// from base class MMPXCommonContainer
+
+    /**
+     * Return Coe Control
+     *
+     * @since 3.2
+     */
+    CCoeControl* CoeControl();
+
+    /**
+     * Set View Container
+     *
+     * @since 3.2
+     */
+    void SetViewContainer( MMPXViewContainer* aViewContainer );
+
+    /**
+     * Set command observer for container
+     *
+     * @since 3.2
+     */
+    void SetCommandObserver( MEikCommandObserver* aCommandObserver );
+
+    /**
+     * Set list box observer for container
+     *
+     * @since 3.2
+     */
+    void SetListBoxObserver( MEikListBoxObserver* aObserver );
+
+    /**
+     * Set layout for all elements and set sizes for icons.
+     *
+     * @since 3.1
+     */
+    void UpdateLayout();
+
+    /**
+     * Returns list box array, ownership not transfered
+     *
+     * @since 3.1
+     * @return A pointer to the list box array
+     */
+    CMPXCommonListBoxArrayBase* ListBoxArray() const;
+
+    /**
+     * Sets up the listbox array, ownership not transferred
+     */
+    void SetListBoxArrayL( CMPXCommonListBoxArrayBase* aListBoxArray );
+
+    /**
+     * Return number of listbox items shown in the current listbox.
+     *
+     * @since 3.1
+     * @return The number of items shown in the list box
+     */
+    TInt CurrentListItemCount() const;
+
+    /**
+     * Return total number of listbox items in the listbox.
+     *
+     * @since 3.1
+     * @return Total items in the list box
+     */
+    TInt TotalListItemCount() const;
+
+    /**
+     * Gets top listbox item index (relative to the original listbox).
+     * @return Top listbox item index
+     *
+     * @since 3.1
+     */
+    TInt TopLbxItemIndex() const;
+
+    /**
+     * Gets bottom listbox item index (relative to the original listbox).
+     * @return Bottom listbox item index
+     *
+     * @since 3.1
+     */
+    TInt BottomLbxItemIndex() const;
+
+    /**
+     * Gets current listbox item index (relative to the original listbox).
+     * @return Current listbox item index
+     *
+     * @since 3.1
+     */
+    TInt CurrentLbxItemIndex() const;
+
+    /**
+     * Get current selected listbox items indices (relative to the original
+     * listbox). Ownership not transferred.
+     *
+     * @since 3.1
+     * @return Current listbox item indices
+     */
+    const CArrayFix<TInt>* CurrentSelectionIndicesL() const;
+
+    /**
+     * Sewt current selected listbox items indices
+     *
+     * @since 3.1
+     * @param aIndices Array of selection indices, ownership not transfered
+     */
+    void SetCurrentSelectionIndicesL( CArrayFix<TInt>* aIndices ) const;
+
+    /**
+     * Set top listbox item index.
+     *
+     * @since 3.1
+     * @param aIndex Actual listbox index.
+     */
+    void SetLbxTopItemIndex( TInt aIndex );
+
+    /**
+     * Set current listbox item index.
+     *
+     * @since 3.1
+     * @param aIndex Actual listbox index.
+     */
+    void SetLbxCurrentItemIndex( TInt aIndex );
+
+    /**
+     * Set current listbox item index and highlight it.
+     *
+     * @since 3.1
+     * @param aIndex Actual listbox index.
+     */
+    void SetLbxCurrentItemIndexAndDraw( TInt aIndex );
+
+    /**
+     * Clear listbox selection.
+     *
+     * @since 3.1
+     */
+    void ClearLbxSelection();
+
+    /**
+     * Sets list box backround text. This text is visible if the list box
+     * has no items.
+     *
+     * @param aText The text for the empty list box background.
+     * @since 3.2
+     */
+	void SetLbxEmptyTextL( const TDesC& aText );
+
+    /**
+     * Draws list box item index
+     *
+     * @since 3.2
+     */
+    void DrawLbxItem( TInt aIndex );
+
+    /**
+     * Set Find box's focus.
+     *
+     * @since 3.1
+     * @param aFocus ETrue if set focus on FindBox. Otherwise, EFalse.
+     */
+    void SetFindBoxFocus( TBool aFocus );
+
+    /**
+     * Handle listbox item addition.
+     *
+     * @since 3.1
+     */
+    void HandleLbxItemAdditionL();
+
+    /**
+     * Handle listbox item addition, preserving the current display index.
+     *
+     * @since 3.1
+     */
+    void HandleLbxItemAdditionPreserveIndexL();
+
+    /**
+     * Handle listbox item removal.
+     *
+     * @since 3.1
+     */
+    void HandleLbxItemRemovalL();
+
+    /**
+     * Show/hide find box
+     *
+     * @since 3.1
+     * @param aIsVisible ETrue to set findbox visible. Otherwise, EFalse
+     */
+    void SetFindBoxVisibilityL( TBool aIsVisible );
+
+    /**
+     * Determine find box visibility
+     *
+     * @since 3.1
+     * @return ETrue if find box is currently visible, EFalse otherwise
+     */
+    TBool FindBoxVisibility();
+
+    /**
+     * Restore the PopupCBA of find box
+     */
+    void RestoreFindBoxPopupCBA();
+
+    /**
+     * Calculate the top index of the visible items
+     *
+     * @since 3.1
+     * @param aBottomIndex the bottom index of the visible items
+     * @return top index
+     */
+    TInt CalculateTopIndex( TInt aBottomIndex );
+
+    /**
+     * Creates the container
+     *
+     * @since 3.1
+     * @param aRect the rectangle that defines the control's extent.
+     */
+    void ConstructContainerL( TMPXCommonContainerCollectionType /*aCollectionTyp*/ );
+
+    /**
+     * Enable/disable find box
+     *
+     * @since 3.1
+     * @aEnable ETrue to enable find box, EFalse to disable
+     */
+    void EnableFindBox( TBool aEnable );
+
+    /**
+     * Enable/disable marking
+     *
+     * @since 3.1
+     * @aEnable ETrue to enable marking, EFalse to disable
+     */
+    void EnableMarking( TBool aEnable );
+
+    /**
+     * Custom handling of commands for markable lists.
+     */
+    void HandleMarkableListProcessCommandL( TInt aCommand );
+
+    /**
+     * Custom handling of menu pane for markable lists
+     */
+    void HandleMarkableListDynInitMenuPane(
+        TInt aResourceId,
+        CEikMenuPane* aMenuPane );
+
+    /**
+     * Handle listbox array events
+     *
+     *  @param aEvent list box event
+     */
+    void HandleListBoxArrayEventL(
+        MMPXCommonListBoxArrayObserver::TMPXCommonListBoxArrayEvents aEvent );
+
+    /**
+     * Handles key events.
+     *
+     * @param aKeyEvent The key event.
+     * @param aType The type of key event.
+     */
+    TKeyResponse HandleKeyEventL(
+        const TKeyEvent& aKeyEvent,
+        TEventCode aType );
+
+    /**
+     * Activate the container
+     */
+    void ActivateContainerL();
+
+// from base class CCoeControl
+
+    /**
+     * From CCoeControl.
+     * Handles key events.
+     *
+     * @param aKeyEvent The key event.
+     * @param aType The type of key event.
+     */
+    TKeyResponse OfferKeyEventL(
+        const TKeyEvent& aKeyEvent,
+        TEventCode aType );
+
+    /**
+     * From CCoeControl.
+     * Gets the control's help context.
+     *
+     * @param aContext The control's help context.
+     */
+    void GetHelpContext( TCoeHelpContext& aContext ) const;
+
+    /**
+     * From CoeControl.
+     * Handles a change to the control's resources.
+     *
+     * @param aType A message UID value.
+     */
+    void HandleResourceChange( TInt aType );
+
+    /**
+     * From CoeControl.
+     * Draw this application's view to the screen
+     *
+     * @param aRect the rectangle of this view that needs updating
+     */
+    void Draw( const TRect& aRect ) const;
+
+    /**
+     * From CoeControl.
+     * Get the control input capabilities
+     */
+	TCoeInputCapabilities InputCapabilities() const;
+
+// from base class MCoeControlObserver
+
+    /**
+    * From MCoeControlObserver, Acts upon changes in the hosted control's state.
+    * This class's implementation is trivial and should be able to be safely
+    * re-implemented in directly client-derived classes. For non-base setting
+    * page classes, a call to the base class should be made.
+    * @param aControl Control that caused the event. (not used in default implementation)
+    * @param aEventType Type of the event.
+    */
+    void HandleControlEventL(CCoeControl* aControl,TCoeEvent aEventType);
+
+
+// from base class MHgScrollBufferObserver
+
+    /**
+     * from MHgScrollBufferObserver
+     * Buffer position changed.
+     * The items between the aBufferStart and aBufferEnd should be loaded as soon as possible.
+     *
+     * @param aBufferStart The index of the first item in buffer.
+     * @param aBufferEnd The index of the last item in buffer.
+     * @param aDirection report direction of scrolling
+     */
+    void Request(TInt aBufferStart, TInt aBufferEnd, THgScrollDirection aDirection);
+
+// from base class MHgBufferOwner
+
+    /**
+     * from MHgBufferOwner
+     *
+     *
+     */
+    void Release(TInt aReleaseStart, TInt aReleaseEnd);
+
+
+// from base class MHgSelectionObserver
+
+    /**
+     * Handle selection.
+     *
+     * @param aIndex Selected item index.
+     */
+    void HandleSelectL( TInt aIndex );
+
+    /**
+     * Handle opening.
+     *
+     * @param aIndex Opened item index.
+     */
+    void HandleOpenL( TInt aIndex );
+
+public: // from base class MThumbnailManagerObserver
+
+    /**
+     * From MThumbnailManagerObserver
+     * Preview thumbnail generation or loading is complete.
+     *
+     * @param aThumbnail     An object representing the resulting thumbnail.
+     * @param aId            Request ID for the operation
+     */
+    void ThumbnailPreviewReady( MThumbnailData& aThumbnail, TThumbnailRequestId aId );
+
+    /**
+     * From MThumbnailManagerObserver
+     * Final thumbnail bitmap generation or loading is complete.
+     *
+     * @param aError         Error code.
+     * @param aThumbnail     An object representing the resulting thumbnail.
+     * @param aId            Request ID for the operation.
+     */
+    void ThumbnailReady( TInt aError, MThumbnailData& aThumbnail, TThumbnailRequestId aId );
+
+    TTypeUid::Ptr MopSupplyObject(TTypeUid aId);
+
+
+private:
+
+    /**
+     * Create list box
+     */
+    void CreateListBoxL( TInt count );
+
+    /**
+     * Create list box with Title
+     */
+    void CreateListBoxWithTitleL( TInt count );
+
+
+    /**
+     * Creates icon array, populates iIconArray to be used by listbox
+     */
+    void CreateIconArrayL();
+
+    /**
+     * Sets default icon for HgList
+     */
+    void SetDefaultIconL();
+
+    /**
+     * Sets default icon for list item
+     */
+    void SetDefaultIconL(TInt aIndex);
+
+    /*
+	 * Adds detail to the list item at the specified index
+     */
+    void AddDetailToDisplayedItemL( CHgItem* aVisualItem, CMPXMedia* aMedia, TInt aIndex);
+    void AddThumbnailToDisplayedItemL( CHgItem* aVisualItem, CMPXMedia* aMedia, TInt aIndex);
+    void SetTitleL( CHgItem* aVisualItem, CMPXMedia* aMedia );
+    void SetDetailCountL( CHgItem* aVisualItem, CMPXMedia* aMedia );
+    void SetDetailArtistL( CHgItem* aVisualItem, CMPXMedia* aMedia );
+    void SetDetailAlbumL( CHgItem* aVisualItem, CMPXMedia* aMedia );
+    void SetDetailDurationL( CHgItem* aVisualItem, CMPXMedia* aMedia );
+    void UpdateTimeIndicatorsL( TDes& aBuf, TInt aDuration );
+    void SetDetailIndicatorL( CHgItem* aVisualItem, TInt aIndex );
+    void SetDetailIconL( CHgItem* aVisualItem, TInt aIndex );
+    void SetDetailThumbnailL( CMPXMedia* aMedia, TInt aIndex = 0 );
+
+    /**
+     * Set the collection context
+     */
+    void SetCollectionContextL();
+
+    void ProvideDataL( TInt aStart, TInt aEnd );
+
+    void SetScrollbarType();
+
+    void CancelTNRequest();
+
+    /**
+      * Save the selected album item
+      *
+      */
+    void SaveSelectedAlbumItemL();
+
+    /**
+     * Write the album name, artist name and album art in media data to file
+     *
+     * @param aMedia         the selected media data in Album view
+     */
+    void WriteToStreamFileL( const CMPXMedia* aMedia );
+
+    /**
+     * Read the album name, artist name and album art from file
+     *
+     * @param aMedia         the media data will be returned
+     */
+    void ReadFromStreamFileL( CMPXMedia* aMedia );
+
+    /**
+     * Refresh list as needed
+     */
+    void RefreshL(TInt aIndex);
+
+    /**
+     * Refresh list as needed
+     */
+    void RefreshNoThumbnailL(TInt aIndex);
+    
+	/**
+	* Clean AlbumArt request Queue
+	*/
+    void CleanAlbumArtReqQueue();
+
+    /**
+     * Handle requests in visible area
+     * @param aBufferStart  the starting buffer index
+     * @param aBufferEnd  the ending buffer index
+     */
+    void ProvideDataIntersectL(TInt aBufferStart, TInt aBufferEnd);
+
+    /**
+     * Refresh list as needed
+     * @param aBufferStart  the starting buffer index
+     * @param aBufferEnd  the ending buffer index
+     */
+    void ProvideDataDifferenceL(TInt aBufferStart, TInt aBufferEnd);
+    void ProvideDataWithoutThumbnailsL(const CMPXMediaArray& aMediaArray, TInt aStartIndex = 0);
+
+private: // data
+
+    /**
+     * Context of collection view. It's the exact location within collection navigation
+     * based on category type + category.
+     */
+    enum TContext
+        {
+        EContextUnknown,
+        EContextGroupCollection,
+        EContextGroupArtist,
+        EContextGroupAlbum,
+        EContextGroupPlaylist,
+        EContextGroupSong,
+        EContextGroupPodcast,
+        EContextGroupGenre,
+        EContextGroupComposer,
+        EContextItemArtist,
+        EContextItemAlbum,
+        EContextItemPlaylist,
+        EContextItemSong,
+        EContextItemPodcast,
+        EContextItemGenre,
+        EContextItemComposer
+        };
+
+    enum TDefaultIcon
+        {
+        EMPXDefaultIconNotSet = -1,
+        EMPXDefaultIconArtist,
+        EMPXDefaultIconAlbum,
+        EMPXDefaultIconPlaylist,
+        EMPXDefaultIconSongs,
+        EMPXDefaultIconPodcasts,
+        EMPXDefaultIconGenre,
+        EMPXDefaultIconComposer,
+        EMPXDefaultTitleIconPodcasts,
+        EMPXDefaultIconEmpty
+        };
+
+    MMPXViewContainer*          iViewContainer;         // Not owned
+    MEikCommandObserver*        iView;                  // Not owned
+    MEikListBoxObserver*        iListBoxObserver;       // Not owned
+    CMPXCommonListBoxArrayBase* iListBoxArray;          // Owned
+    CArrayFixFlat<TInt>*        iListSelections;        // Owned
+    CAknIconArray*              iIconArray;             // Owned
+
+    CMPXCommonContainerTextureManager2*  iTextureManager;// Owned
+	CMPXCommonUiHelper*         iCommonUiHelper;        // Owned
+
+    CHgScroller* 				iListWidget;  		    // Owned
+    CHgScroller* 				iPrevListWidget;  		    // Owned
+    CHgScrollerWithTitle*       iScrollerWithTitle;
+    CThumbnailManager*          iThumbnailManager;      // Owned
+
+    TContext                    iContext;
+    TContext                    iPrevContext;
+    TInt                        iResourceOffset;        // Must be freed
+    TBool                       iIsMarkingEnabled;
+	TInt						iTopIndex;
+	TInt						iBottomIndex;
+	TSize						iImageSize;
+    CAknsBasicBackgroundControlContext* iBgContext; 	// Owned
+
+    typedef RHashMap<TInt, TInt> RThumbnailReqHashMap;
+    RThumbnailReqHashMap iThumbnailReqHashMap;
+
+    HBufC* iEpisodeTitle;
+    HBufC* iAlbumTitle;
+    HBufC* iSongTitle;
+
+    TBool iPodcastContext;
+    TBool iTitleSet;
+    TDefaultIcon iCurrentDefaultIcon;
+    TFileName iSelectedAlbumItemFileName;
+    CMPXMedia* iSelectedMediaInAlbumView;
+    // Queue for Albumart asynchronous requests
+    TSglQue<TAlbumArtRequest>   iRequestQueue;
+    TAlbumArtRequest*           iAlbumArtRequest;
+    TInt                        iRequestCount;
+    TInt  iQueueCounter;
+    
+    THgScrollDirection iDirection;
+    RArray<TBool>  iThumbnailReqMap;
+    TInt  iLastValidMediaItemIndex;
+    TInt iRequestStart;
+    TInt iRequestEnd;
+
+    };
+
+#endif  // CMPXCOMMONCONTAINERHGIMP_H
+
+// End of File