/*

* 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:   Videolist content widget

*

*/

#ifndef VIDEOLISTWIDGET_H

#define VIDEOLISTWIDGET_H

#include <hbview.h>

#include <hblistview.h>

#include <qmap.h>

#include <qpointer.h>

#include <mpxitemid.h>

#include "videoservices.h"

#include "videocollectioncommon.h"

class VideoServices;

class VideoCollectionUiLoader;

class HbAction;

class HbMenu;

class QTimer;

class QItemSelection;

class VideoServices;

/**

 * Widget for displaying all videos, either using list- or grid view.

 * Widget contains 2 widgets to be used for different orientation in the stacked layout.

 *

 * Depending on the orientation and it's change, corresponding view is set active.

 *

 */

class VideoListWidget : public HbListView

{

    Q_OBJECT

    Q_DISABLE_COPY(VideoListWidget)

public:

    /**

     * Contructor.

     * @param uiloader

     * @param parent parent of this widget

     */

    VideoListWidget(VideoCollectionUiLoader *uiLoader, HbView *parent = 0);

    /**

     * Destructor.

     *

     */

    virtual ~VideoListWidget();

    /**

     * Method creates colleciton wrapper, grid and list views,

     * layout and activates correct view based on the current orientation

     * 

     * @param model Model for this list view.

     * @param isService, flag indicating app service status

     * @param level presetted level for the widget

     * @return int 0 initialization ok, < 0 if fails.

     */

                   bool isService  = false,

                   VideoCollectionCommon::TCollectionLevels level = VideoCollectionCommon::ELevelInvalid);

    /**

     * Method enables and displays current active view

     *

     * @return int 0 initialization ok, < 0 if fails.

     */

    int activate();

    /**

     * Method enables and displays current active view

     *

     * @return int 0 initialization ok, < 0 if fails.

     */

    int activate(VideoCollectionCommon::TCollectionLevels level);

    /**

     * Method disables and hides current active view

     *

     */

    void deactivate();

    /**

     * returns current level provided by activate

     * 

     * @return TCollectionLevels

     */

    VideoCollectionCommon::TCollectionLevels getLevel();

    /**

     * returns widget's model

     * 

     */

public:

    /**

     * Called by the fw when some item is tapped. Method check that

     * index is valid and calls open item for collectionwrapper to

     * open media object throught collection.

     * 

     * @param midelIndex, item's index

     */

    void emitActivated (const QModelIndex &modelIndex);

    /**

     * Overwritten from Abstractitemview.

     * Sets local selection mode variable value used locally in checks. 

     * If provided value is mode provided by HbAbstractitemview sets 

     * it as view selection mode othervise NoSelection is setted

     * 

     * @param mode 

	 */

    void setSelectionMode(int mode);

protected:

    /**

     * Derived from HbListView. Starts fetching thumbnails when rows are inserted.

     * 

     * @param parent

     * @param start

     * @param end

     */

    void rowsInserted(const QModelIndex &parent, int start, int end);

    /**

     * Derived from HbListView. Starts fetching thumbnails when rows are removed.

     * 

     * @param parent

     * @param start

     * @param end

     */

    void rowsRemoved(const QModelIndex &parent, int start, int end);

signals:

    /**

     * Command signal.

     *

     * @param int command id

     */

    void command(int);

    /**

     * Signals collection view's state. Used to indicate

     * view incase some collection item is opened

     *

     * @param true if opened, false if closed.

     * @param optional name string

     */

    void collectionOpened(bool, const QString&, const TMPXItemId&);

    /**

     * signal is connected to service's itemSelected -slot

     */

    void fileUri(const QString&);

public slots:

    /**

     * Signaled by HbInputDialog when it's closed. 

     */

    void renameDialogFinished(HbAction *action);

    /**

     * Signaled by HbMessageBox when it's closed.

     */

    void deleteItemDialogFinished(int action);

    /**

     * Signaled by HbMessageBox when it's closed.

     */

    void removeCollectionDialogFinished(int action);

    /**

     * called or signaled when delayed initialization is reauired for the widget

     *

     */

    void doDelayedsSlot();

protected slots:

    /**

     * Signaled by the fw when item is long pressed.

     * Popup menu for the particular item is opened.

     * Saves current selected item's index to mCurrentIndex

     */

    void longPressedSlot(HbAbstractViewItem *item, const QPointF &point);

private slots:

    /**

     * Signaled for one item deletion.

     *

     */

    void deleteItemSlot();

    /**

     * Signaled for item rename.

     *

     */

    void renameSlot();

    /**

     * Signaled to add an item into a collection.

     *

     */

    void addToCollectionSlot();

    /**

     * Signaled to remove a particular video from collection

     */

    void removeFromCollectionSlot();

    /**

     * Signaled to remove a user created collection.

     *

     */

    void removeCollectionSlot();

    /**

     * Signaled when details will be selected from the videolist's

     * context menu. Maps mCurrentIndex to model's source index and

     * calls collection wrapper to open details

     *

     */

    void openDetailsSlot();

    /**

     * Signaled when item's default functionality is initialized from context menu.

     * Calls emitActivated for actually axecuting the functionality

     */

    void openItemSlot();

    /**

     * Signaled when item's play functionality is initialized from context menu.

     * Calls doActivateItem for actually executing the functionality.

     */

    void playItemSlot();

    /**

     * Signaled when stepping back from collection in collection view

     *

     */

    void back();

    /**

     * connected to navi -quit action triggered signal.

     * Signals fileUri with empty path for servicing to be completed

     */

    void endVideoFecthingSlot();

	/**

	 * Signaled when view scrolling starts, pauses thumbnail creation.

	 *

	 */

	void scrollingStartedSlot();	

	/**

	 * Signaled when view scrolling ends, initiates thumbnail fetching

	 * at index of first visible item and enables creation of thumbnails.

	 *

	 */

	void scrollingEndedSlot();

	/**

	 * Signaled when view scroll position changes, initiates timer to 

	 * fetch thumbnails at index of first visible item.

	 *

	 * @param newPosition scroll position 

	 *

	 */

	void scrollPositionChangedSlot(const QPointF &newPosition);

	/**

	 * Signaled when scroll position timer triggers. Starts fetching thumbnails

	 * for visible items.

	 * 

	 */

	void scrollPositionTimerSlot();

    /**

     * Fetches thumbnails for the visible items.

     *

     */

    void fetchThumbnailsForVisibleItems();

private:

    enum TContextActionIds

    {

    	EActionDelete = 1,

        EActionDetails,

        EActionRemove,

        EActionAddToCollection,

        EActionRemoveCollection,

        EActionRename,

    	EActionPlay,

    	EActionOpen,

    	EActionAttach

    };

    /**

     * Method creates popup menu for list items.

     *

     */

    void createContextMenu();

    /**

     * Method sets correct popup menu for specific list items.

     *

     */

    void setContextMenu();

    /**

     * Method sets correct popup menu for service.

     */

    void setServiceContextMenu();

    /**

     * Method connects signals needed by the widget

     *

     * @return int 0 if connect ok, < 0 if connect fails

     */

    int connectSignals();

    /**

     * Method disconnects signals needed by the widget

     *

     */

    void disConnectSignals();

    /**

     * Set navigation action.

     */

    void setNavigationAction();

    /**

     * Does the actual emitActivated functionality. Called from either emitActivated or

     * openItemSlot.

     * 

     * @param index Index of the item.

     */

    void doEmitActivated (const QModelIndex &index);

    /**

     * handles single item activation. Either from 

     * user's single tap or from default action at context menu.

     * 

     * @param index of item

     */

    void doActivateItem(const QModelIndex &index);

private:

    /**

     * Provided model

     * Not own.

     */

    /**

     * pointer to videoservices instance. If exists, 

     * app has started as service.

     */

    VideoServices* mVideoServices;

    /**

     * map containing pointers to main menu actions

     */

    QMap<TContextActionIds, HbAction*> mContextMenuActions;

    /**

     * current level indicating content currently showing: 

     * category or videos

     */

    VideoCollectionCommon::TCollectionLevels mCurrentLevel;

	/**

     * True if signals have been connected

     */

	bool                       mSignalsConnected;

	/**

     * Navigation softkey action.

     */

	HbAction 				   *mNavKeyAction;

    /**

     * Item sensitive context menu

     */

    HbMenu                      *mContextMenu;

    /**

     * loacal selection mode

	 */

    int                        mSelectionMode;

    /**

     * Timer used to report thumbnail fetches class index of 

     * first visible item when view is scrolling. 

     */

    QTimer                      *mScrollPositionTimer;

    /**

     * ui loade object, not owned

     */

    VideoCollectionUiLoader     *mUiLoader;

    /**

     * Service being provided

     */

    VideoServices::TVideoService mService;

};

#endif // VIDEOLISTWIDGET_H